Skip to content

rill-focus-decision-digest: decision-digest HTML at /focus judgment points - #86

Merged
tarr1124 merged 1 commit into
mainfrom
feature/rill-focus-decision-digest
Aug 13, 2026
Merged

tarr1124 merged 1 commit into
mainfrom
feature/rill-focus-decision-digest

Conversation

@tarr1124

Copy link
Copy Markdown
Contributor

Summary

Wires the "decision point during a live session" read moment from rill-html-output.md into the focus skill, and upstreams the shared HTML design language it depends on.

  • .claude/commands/_view/design-language.md (new): authoring checklist for human-readable HTML views — core principles (two layers / layer-not-delete / message-driven / self-sufficiency), 8-step authoring procedure, visualization routing, light-interaction toolkit, ship check, anti-patterns, typography + layout. Shared internal asset (ADR-048 underscore convention) referenced by /focus now and by the upcoming /close handbook and /project digest wiring.
  • skills/focus/SKILL.md: decision-digest generation as default behavior at judgment points — qualitative trigger (asking the user to judge across artifacts), dated snapshot to workspace/{id}/.view/ (never regenerated in place), digest presented instead of raw .md path enumeration, opt-out line, generation failure non-fatal, provenance comment, no HTML-only information (completeness satisfied by linking to MD sources). Argument resolution now handles workspace artifact paths (.md and .html): parent workspace resolved, HTML-canonical artifacts read per rill-html-output.md principle 3, .view/ snapshots never read. GUI match extended with workspace/**/*.html.

Codex review

Round 1: 2 [P2] (self-sufficiency vs no-HTML-only-info conflict; digest completeness ambiguity) — both fixed by scoping definitions to source-derivable content and declaring linked MD sources as the digest's retained detail layer. Round 2: 0 P-findings.

Guards

Non-ASCII on added lines: em dash only (repo precedent). PII mapping / email / phone: 0 hits. Local cjk-guard.py + pii-regex-guard.sh: pass.

🤖 Generated with Claude Code

…oints

Wire the "decision point during a live session" read moment from
rill-html-output.md into the focus skill, and upstream the shared HTML
design language it depends on.

- .claude/commands/_view/design-language.md (new): authoring checklist
  for human-readable HTML views (core principles, 8-step procedure,
  visualization routing, light-interaction toolkit, ship check,
  anti-patterns, typography/layout). Shared asset for /focus now and
  the upcoming /close handbook and /project digest wiring.
- skills/focus/SKILL.md: generate a dated decision-digest snapshot into
  workspace/{id}/.view/ when asking the user to judge across artifacts
  (qualitative trigger, opt-out line, generation failure non-fatal,
  provenance comment, never regenerated in place); resolve workspace
  artifact paths (.md and .html) to the parent workspace with the
  artifact as focal target, reading HTML-canonical artifacts per
  rill-html-output.md principle 3; GUI match extended to
  workspace/**/*.html.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@tarr1124
tarr1124 merged commit 3c40650 into main Aug 13, 2026
4 checks passed
@tarr1124
tarr1124 deleted the feature/rill-focus-decision-digest branch August 13, 2026 10:38
tarr1124 added a commit that referenced this pull request Aug 13, 2026
…oments (#88)

Wire the "project review" read moment of rill-html-output.md into
skills/project/SKILL.md, completing the three-layer read-moment model
(ADR-082 Phase 2 / G5) after /focus (#86) and /close (#87):

- New section "Project Digest (read-moment HTML)": one generator, two
  section weightings (run-end leads with stop reason + pending decisions
  + next actions; status leads with current position + next actions)
- Ordering: refresh-project (already run) -> refresh-decisions
  (synchronous) -> read refreshed sources -> generate
- Pending decisions re-express the contract-v1.1 fields (ADR-084);
  consequence-framed, zero-context readable (D82-8 / D84-7)
- Dated snapshots at projects/{slug}/.view/digest-{YYYY-MM-DD}.html,
  never overwritten; self-contained; provenance comment; non-fatal with
  partial-file cleanup; skip line
- Run mode Step 3 persists the run summary as a project artifact
  (NNN-run-summary-{date}.md) so the run-end digest stays a pure
  derived view (principle 4), and the final rill push covers it

Co-authored-by: tarr1124 <tarr1124@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant