Skip to content

Commit 1e5f862

Browse files
committed
config: record learning M169 - use full task ID in progress header
Progress header should display full task ID (e.g., "2.0-fix-config-documentation") not just task name ("fix-config-documentation"). Updated all header examples in work.md to use {major}.{minor}-{task-name} format.
1 parent cfaf1bd commit 1e5f862

3 files changed

Lines changed: 39 additions & 11 deletions

File tree

.claude/cat/retrospectives/mistakes.json

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1298,6 +1298,32 @@
12981298
"catches_variations": true
12991299
},
13001300
"correct_behavior": "Always verify version status is not completed before suggesting it as a task target"
1301+
},
1302+
{
1303+
"id": "M169",
1304+
"timestamp": "2026-01-22T12:00:00Z",
1305+
"category": "documentation_violation",
1306+
"description": "Progress header displayed short task name instead of full task ID (missing version prefix)",
1307+
"root_cause": "Documentation used {task-name} placeholder instead of {major}.{minor}-{task-name} for header format",
1308+
"rca_method": "B",
1309+
"rca_method_name": "taxonomy",
1310+
"prevention_type": "skill",
1311+
"prevention_path": "${CLAUDE_PROJECT_DIR}/plugin/commands/work.md",
1312+
"pattern_keywords": [
1313+
"progress_header",
1314+
"task_id",
1315+
"version_prefix",
1316+
"display_format"
1317+
],
1318+
"prevention_implemented": true,
1319+
"prevention_verified": true,
1320+
"recurrence_of": null,
1321+
"prevention_quality": {
1322+
"verification_type": "positive",
1323+
"fragility": "low",
1324+
"catches_variations": true
1325+
},
1326+
"correct_behavior": "Use full task ID format in progress header: {major}.{minor}-{task-name} (e.g., 2.0-fix-config-documentation)"
13011327
}
13021328
]
13031329
}

.claude/cat/retrospectives/retrospectives.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"last_retrospective": "2026-01-21T14:40:12-05:00",
3-
"mistake_count_since_last": 5,
3+
"mistake_count_since_last": 6,
44
"config": {
55
"mistake_count_threshold": 10,
66
"trigger_interval_days": 7

plugin/commands/work.md

Lines changed: 12 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -45,10 +45,12 @@ This is CAT's core execution command. It:
4545

4646
### Header Box (MANDATORY - Display FIRST)
4747

48-
At workflow start, display the task header BEFORE any progress lines:
48+
At workflow start, display the task header BEFORE any progress lines.
49+
50+
**CRITICAL: Use full task ID** (e.g., `2.0-fix-config-documentation`), not just task name (`fix-config-documentation`).
4951

5052
```
51-
🐱 > {task-name}
53+
🐱 > {major}.{minor}-{task-name}
5254
────────────────────────────────────────────────────────────────────
5355
```
5456

@@ -81,7 +83,7 @@ This workflow has 4 phases. Display a persistent horizontal progress banner that
8183
Phases are connected horizontally with dashes. Metrics appear on a second line below their relevant phases.
8284

8385
```
84-
🐱 > {task-name}
86+
🐱 > {major}.{minor}-{task-name}
8587
────────────────────────────────────────────────────────────────────
8688
8789
● Preparing ────── ◉ Executing ────── ○ Reviewing ────── ○ Merging
@@ -96,7 +98,7 @@ Every progress display MUST include both the header AND the progress line. Never
9698
line without the header above it - the header identifies which task the progress refers to.
9799

98100
```
99-
🐱 > {task-name}
101+
🐱 > {major}.{minor}-{task-name}
100102
────────────────────────────────────────────────────────────────────
101103
102104
◉ Preparing ────── ○ Executing ────── ○ Reviewing ────── ○ Merging
@@ -107,7 +109,7 @@ Symbols: `○` pending, `●` complete, `◉` active, `✗` failed
107109
**Starting state (phase 1 active):**
108110

109111
```
110-
🐱 > {task-name}
112+
🐱 > {major}.{minor}-{task-name}
111113
────────────────────────────────────────────────────────────────────
112114
113115
◉ Preparing ────── ○ Executing ────── ○ Reviewing ────── ○ Merging
@@ -121,15 +123,15 @@ Header remains visible above progress banner throughout. Only the progress line
121123

122124
When Preparing completes, Executing starts:
123125
```
124-
🐱 > {task-name}
126+
🐱 > {major}.{minor}-{task-name}
125127
────────────────────────────────────────────────────────────────────
126128
127129
● Preparing ────── ◉ Executing ────── ○ Reviewing ────── ○ Merging
128130
```
129131

130132
When subagent completes (show metrics):
131133
```
132-
🐱 > {task-name}
134+
🐱 > {major}.{minor}-{task-name}
133135
────────────────────────────────────────────────────────────────────
134136
135137
● Preparing ────── ● Executing ────── ◉ Reviewing ────── ○ Merging
@@ -138,7 +140,7 @@ When subagent completes (show metrics):
138140

139141
When Reviewing completes:
140142
```
141-
🐱 > {task-name}
143+
🐱 > {major}.{minor}-{task-name}
142144
────────────────────────────────────────────────────────────────────
143145
144146
● Preparing ────── ● Executing ────── ● Reviewing ────── ◉ Merging
@@ -148,7 +150,7 @@ When Reviewing completes:
148150
**On success (final state):**
149151

150152
```
151-
🐱 > {task-name} > PASSED
153+
🐱 > {major}.{minor}-{task-name} > PASSED
152154
────────────────────────────────────────────────────────────────────
153155
154156
● Preparing ────── ● Executing ────── ● Reviewing ────── ● Merging
@@ -162,7 +164,7 @@ Next: {next-task-name} (run `/cat:work` to continue)
162164
**On failure (show context inline):**
163165

164166
```
165-
🐱 > {task-name} > FAILED
167+
🐱 > {major}.{minor}-{task-name} > FAILED
166168
────────────────────────────────────────────────────────────────────
167169
168170
● Preparing ────── ● Executing ────── ✗ Reviewing ────── ○ Merging

0 commit comments

Comments
 (0)