You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Refine task-phase tracking and phase explanations.
Strengthen current-phase-first task-list behavior across tracking and phase startup rules, improve phase/progress explanations so they are easier to picture and shorter to read, and add a standalone high-signal communication experiment without merging it into the active owner graph.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: README.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -182,7 +182,7 @@ for f in $RULE_FILES; do cp "$f" ~/.claude/rules/; done
182
182
| Rule | Purpose | Key Benefit |
183
183
|:-----|:--------|:------------|
184
184
| [`accurate-communication.md`](accurate-communication.md) | Clear, honest communication | No vague claims, no over-strong contradiction wording, reusable partial-evidence technical snapshot wording, stronger human-language glosses, clearer explanation of variables/fields/config keys/internal labels when answers depend on them, goal-qualified proposal wording for advisory future-work ideas, honest duplicate-looking team-agent reporting, governing-basis clarification before deep branch analysis, compact post-compact re-anchor wording, explicit memory-derived-context disclosure wording for path-matched remembered context, natural-professional wording, direct human-readable action/result wording preferred over metaphor-heavy internal shorthand, main-point-first framing for diagnosis/test/recommendation/proposal/update answers, continuation-first guidance, clearer recommendation-plus-reason next-step wording that still preserves alternatives when multiple paths are real, and active summaries that keep resolved topics available for reasoning without repeating them as current issues by default |
185
-
|[`artifact-initiation-control.md`](artifact-initiation-control.md)| Startup artifact governance | Resolve design/changelog/TODO/phase/patch posture before meaningful governed work drifts, initialize live task tracking early when non-trivial work needs visible execution state, and keep patch non-default during greenfield startup unless a real before/after review surface exists |
185
+
|[`artifact-initiation-control.md`](artifact-initiation-control.md)| Startup artifact governance | Resolve design/changelog/TODO/phase/patch posture before meaningful governed work drifts, initialize live task tracking early when non-trivial work needs visible execution state, treat phase-backed live task tracking as expected startup behavior, and keep patch non-default during greenfield startup unless a real before/after review surface exists |
186
186
|[`authority-and-scope.md`](authority-and-scope.md)| Decision hierarchy | User authority respected, fresh user directives override previously offered assistant options, unnecessary option branching is discouraged when one safe continuation path already exists, future-work proposals stay advisory until explicitly selected, user-declared RULES-first issues stay RULES-first instead of being diverted into memory-first fixes, memory applicability now defers to the dedicated memory-governance owner, non-matching path-scoped remembered context cannot override the current repo/objective, unresolved governing-basis selection stays user-owned unless authority/evidence already settles it, compacted-session continuation re-anchors to the latest active directive and active frame, and overlapping team expansion stays advisory unless a distinct new role is actually needed |
187
187
|[`custom-agent-selection-priority.md`](custom-agent-selection-priority.md)| Custom agent selection priority | Prefer visible user custom agents as the primary specialist pool when a task clearly matches them, and reuse an existing matching teammate before spawning another overlapping team role |
188
188
|[`dan-safe-normalization.md`](dan-safe-normalization.md)| Prompt-wrapper normalization | Safer intent evaluation before decisioning |
@@ -196,15 +196,15 @@ for f in $RULE_FILES; do cp "$f" ~/.claude/rules/; done
196
196
|[`functional-intent-verification.md`](functional-intent-verification.md)| Intent validation | Commands verified before run |
197
197
|[`memory-governance-and-session-boundary.md`](memory-governance-and-session-boundary.md)| Memory governance and session boundary | Treat memory as scoped reusable context rather than active authority, keep root `MEMORY.md` as an active index only, use `global/path/archive` semantics, make path the primary applicability key, keep session IDs as provenance only, and keep archived memory inactive by default |
198
198
|[`operational-failure-handling.md`](operational-failure-handling.md)| Operational failure policy | Bounded retry ceilings, honest cooldown guidance, and stop/escalation behavior for technical failures, including inspect-first handling for duplicate-looking or stale team-agent presence |
199
-
|[`phase-implementation.md`](phase-implementation.md)| Phase planning semantics | First-class `/phase` + `SUMMARY.md` model with major/subphase identities, early phase-establishment bridge, and explicit phase-to-patch linkage when patch is in scope |
199
+
|[`phase-implementation.md`](phase-implementation.md)| Phase planning semantics | First-class `/phase` + `SUMMARY.md` model with major/subphase identities, early phase-establishment bridge, current-phase-first live task-list linkage, and explicit phase-to-patch linkage when patch is in scope |
200
200
|[`runtime-topology-control.md`](runtime-topology-control.md)| Runtime topology discipline | Bounded inspect-first, one-authority-at-a-time runtime mutation posture that prevents debug-by-expansion and requires explicit approval for additive or authority-changing topology moves |
201
201
|[`recovery-contract.md`](recovery-contract.md)| Blocked-response contract | Every constrained/refused path has actionable next steps |
202
202
|[`tactical-strategic-programming.md`](tactical-strategic-programming.md)| Tactical vs strategic doctrine | Tactical entry stays fast, but every tactical move must point toward a declared strategic target and convergence path |
203
203
|[`natural-professional-communication.md`](natural-professional-communication.md)| Communication style doctrine | Default to calm, human-readable, non-robotic, non-character-driven professional communication, reject metaphor-heavy or management-style abstraction when direct wording would be clearer, and front-load the operational purpose when the answer would otherwise bury it behind warm-up framing |
|[`todo-standards.md`](todo-standards.md)| Task management | Durable TODO tracking plus proactive built-in task-list usage for non-trivial live execution visibility |
207
+
|[`todo-standards.md`](todo-standards.md)| Task management | Durable TODO tracking plus current-phase-first built-in task-list usage for non-trivial live execution visibility |
208
208
|[`project-documentation-standards.md`](project-documentation-standards.md)| Project documentation standards | Standardized docs for all projects plus startup artifact gate, explicit live-task-list-vs-durable-TODO distinction, non-default startup patch posture for greenfield baseline formation, portable public onboarding/install guidance, and portable-by-default package-local support assets when they are reusable source content |
209
209
|[`portable-implementation-and-hardcoding-control.md`](portable-implementation-and-hardcoding-control.md)| Portable implementation control | Keep shared artifacts, reusable support/package source artifacts, and public onboarding/install guidance portable by default, bind environment-specific values late, and prevent machine-local hardcoding drift |
210
210
|[`unified-version-control-system.md`](unified-version-control-system.md)| Unified version governance | Single deterministic UDVC-1 controller |
Copy file name to clipboardExpand all lines: TODO.md
+4Lines changed: 4 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,6 +6,8 @@
6
6
7
7
## ✅ Completed
8
8
9
+
-[x] Add easy-to-picture concise phase/progress explanation guidance so phase and next-step answers start from plain-language framing the user can picture quickly before denser governance/execution detail; synchronize design/changelog/master surfaces and runtime rule copies.
10
+
-[x] Link live task-list behavior explicitly to the current active phase so non-trivial phase-backed work now expects a built-in task list early, one phase may contain multiple execution tasks, and future-phase draft tasks do not replace current-phase execution visibility; synchronize design/changelog/master surfaces and runtime rule copies.
9
11
-[x] Suspend the custom table-format experiment from the active RULES system, keep the file for future redesign without deleting it, remove its active enforcement role from related owner chains, synchronize design/changelog/master surfaces, and update installed runtime copies so general support for using tables when helpful remains active without the custom format doctrine.
10
12
-[x] Correct the default table style so tables remain available when useful, but ordinary answer tables now use the selected light plain aligned no-frame form instead of the previous compact pipe-table default; synchronize design/changelog/master surfaces; resync installed runtime copies; narrow the overreaching remembered table preference; and complete a final consistency audit.
11
13
-[x] Refine task-list-first execution tracking so Claude Code's built-in task list is now explicitly the live execution surface for non-trivial active work, while `TODO.md` remains the durable repository/project tracking artifact; synchronize design/changelog/master surfaces; resync installed runtime copies; and complete a final consistency audit.
@@ -85,6 +87,8 @@
85
87
86
88
| Date | Changes |
87
89
|------|---------|
90
+
| 2026-04-11 | Added easy-to-picture concise phase/progress explanation guidance so phase and next-step answers now start from plain-language framing the user can picture quickly before denser governance/execution detail. |
91
+
| 2026-04-11 | Linked live task-list behavior explicitly to the current active phase so non-trivial phase-backed work now expects a built-in task list early, one phase may contain multiple execution tasks, and future-phase draft tasks do not replace current-phase execution visibility. |
88
92
| 2026-04-11 | Suspended the custom `table-format-and-usage` experiment from the active RULES system, moved the file out of the root active rule area into `suspend/`, removed its active enforcement role from related owner chains, and restored general support for using tables when helpful without the custom format doctrine. |
89
93
| 2026-04-10 | Corrected the default table style so ordinary answer tables now use the selected light plain aligned no-frame form instead of the previous compact pipe-table default; updated `answer-presentation` and `explanation-quality`; narrowed the overreaching remembered comparison-table preference so it defers to RULES for style; and opened the bounded `phase-028` / `patch/plain-aligned-no-frame-table-style-refinement.patch.md` refinement wave. |
90
94
| 2026-04-10 | Refined task-list-first execution tracking so Claude Code's built-in task list is now explicitly treated as the live execution surface for non-trivial work, while `TODO.md` remains the durable repository/project tracking artifact; updated `todo-standards`, `artifact-initiation-control`, and `project-documentation-standards`; and opened the bounded `phase-027` / `patch/task-list-first-execution-tracking.patch.md` refinement wave. |
When reporting phase progress, phase meaning, or next-step reasoning, start with a short plain-language framing that helps the reader picture what the work is doing before denser execution or governance detail appears.
119
+
120
+
Required guidance:
121
+
- say in simple human terms what the phase or progress item is doing
122
+
- say briefly why it matters or what part of the work it prepares, locks, or moves forward
123
+
- keep this framing concise and easy to follow
124
+
- do not begin with dense scope/governance detail if one short plain-language framing line would help the reader orient faster
125
+
116
126
### 5.1 Variable, Field, and Internal-Label Clarification Principle
117
127
118
128
When an answer relies on variable names, field names, config keys, enum-like values, or internal labels that are not self-explanatory, do not treat the raw identifier as if its name alone explains the system.
@@ -156,6 +156,7 @@ Apply stronger presentation structure when one or more of these triggers are pre
156
156
| branching | conditions, paths, handoffs | text flow diagram or clearly indented branch structure |
157
157
| diagnostic snapshot | troubleshooting status, implementation progress report, verification snapshot, environment note | short orienting line + purpose-first line when needed + compact titled snapshot sections + small scoped fact table when helpful |
158
158
| scope clarification | what this is vs what it is not, what happens now vs later, current scope vs deferred scope | grouped sections such as `What this is`, `What this is not`, `What happens now`, `What stays later`, `What the user will notice`|
159
+
| phase / progress explanation | what this phase is for, what this phase got, what this prepares next | short plain-language opening + concise grouped explanation |
159
160
| full-set framing | many relevant areas, complete checklist, several review axes that should be visible together | complete set first, then optional narrowing |
160
161
| stage progression | current explanation is already sufficient and the real need is the next state or milestone | short explicit `What happens next` / `Next stage` / `Next state` block |
161
162
| governing-basis ambiguity | multiple plausible policies/frames remain live and the answer changes depending on which one is chosen | short clarification block with compact basis options and one `Why it matters` line |
@@ -287,6 +288,13 @@ When explaining roadmap, phase scope, staged rollout, or product truth:
287
288
288
289
Use these blocks when they materially improve scanability, not as a rigid mandatory template.
289
290
291
+
### 7.1 Easy-to-Picture Phase/Progress Pattern
292
+
293
+
When answering what a phase is doing, what it got, or what it prepares next:
294
+
- start with one short plain-language line that helps the reader picture the work quickly
295
+
- then use one small grouped explanation if needed
296
+
- keep the whole explanation concise rather than expanding into a long governance-first block
297
+
290
298
### 7.1 Variable-Role Pattern
291
299
292
300
When multiple variables, fields, config keys, enum-like values, or internal labels are central to the explanation:
Copy file name to clipboardExpand all lines: artifact-initiation-control.md
+3-1Lines changed: 3 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -35,6 +35,7 @@ Required guidance:
35
35
- ask now
36
36
- not required
37
37
- when the work is non-trivial and tracking is materially useful, initialize the built-in task list early as the live execution surface instead of leaving work state implicit
38
+
- when an active phase already exists for the work, treat live task-list initialization as expected rather than optional unless a narrow justified reason clearly blocks it
38
39
- do not silently skip artifacts or live tracking surfaces that appear required
39
40
40
41
### 3) Existing-Authority-First Principle
@@ -103,7 +104,7 @@ Meaningful governed work begins when the assistant moves beyond lightweight expl
103
104
| Design | target behavior, policy, contract, or architecture is new or materially changing |
104
105
| Changelog | a governed chain is being created or version-impacting behavior is changing |
105
106
| TODO | work is multi-step, tracked, persistent, or likely to span multiple execution slices |
106
-
| Live task list | work is non-trivial and the user would materially benefit from seeing pending / in_progress / completed state during active execution |
107
+
| Live task list | work is non-trivial and the user would materially benefit from seeing pending / in_progress / completed state during active execution; phase-backed work strengthens this from preferred to expected|
107
108
| Phase | staged execution, gates, sequencing, rollback boundaries, or explicit user request make `/phase` materially useful |
108
109
| Patch | explicit before/after review packaging outside live phase planning is materially useful for an existing governed surface; greenfield startup / baseline formation normally defaults to `not required` unless the user explicitly requests patch packaging |
| 2.13 | 2026-04-09 |**[Added main-point-first operational framing for diagnosis, tests, and recommendations](#version-213)**| 11c4bd2f-216e-4779-81bf-26d34a4fcaeb |
15
16
| 2.12 | 2026-04-08 |**[Preferred direct human-readable wording over metaphor-heavy internal shorthand](#version-212)**| 11c4bd2f-216e-4779-81bf-26d34a4fcaeb |
@@ -55,6 +56,23 @@
55
56
56
57
---
57
58
59
+
<aid="version-215"></a>
60
+
## Version 2.15: Added easy-to-picture phase/progress framing guidance
61
+
62
+
**Date:** 2026-04-11
63
+
**Session:** 11c4bd2f-216e-4779-81bf-26d34a4fcaeb
64
+
65
+
### Changes
66
+
- Updated `accurate-communication.md` from v2.14 to v2.15.
67
+
- Updated `design/accurate-communication.design.md` from v2.14 to v2.15.
68
+
- Added explicit wording guidance that phase/progress reporting should start with a short plain-language framing that helps the reader picture what the work is doing before denser execution or governance detail appears.
69
+
- Preserved existing main-point-first, direct human-readable wording, and concise synthesis behavior.
70
+
71
+
### Summary
72
+
Accurate-communication now makes phase/progress reporting easier to picture by front-loading a short plain-language framing before denser operational detail.
73
+
74
+
---
75
+
58
76
<aid="version-214"></a>
59
77
## Version 2.14: Added memory-derived-context disclosure wording
0 commit comments