Skip to content

Commit b51d122

Browse files
lucifer1004lucifer1004
committed
docs(rfc): bump RFC-0006 command surface spec
1 parent 494d7d2 commit b51d122

10 files changed

Lines changed: 745 additions & 57 deletions

File tree

‎.claude/agents/compliance-checker.md‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -68,12 +68,12 @@ For each accepted ADR:
6868

6969
## Violation Categories
7070

71-
| Category | Meaning | Default Severity | Example |
72-
| ---------------- | ------------------------------------------------ | ---------------- | ------------------------------------------------------------------ |
73-
| **VIOLATION** | Code contradicts a MUST/MUST NOT clause | Critical | Clause says MUST validate; code skips validation |
74-
| **DEVIATION** | Code doesn't follow a SHOULD/SHOULD NOT | Warning | Clause says SHOULD log; code doesn't log |
71+
| Category | Meaning | Default Severity | Example |
72+
| ---------------- | ------------------------------------------------ | ---------------- | ------------------------------------------------------------ |
73+
| **VIOLATION** | Code contradicts a MUST/MUST NOT clause | Critical | Clause says MUST validate; code skips validation |
74+
| **DEVIATION** | Code doesn't follow a SHOULD/SHOULD NOT | Warning | Clause says SHOULD log; code doesn't log |
7575
| **DRIFT** | Code has diverged from an ADR decision | Warning | ADR says a field is render-only; code exposes it as editable |
76-
| **UNDOCUMENTED** | Code implements behavior not covered by any spec | Warning | Feature exists with no governing clause |
76+
| **UNDOCUMENTED** | Code implements behavior not covered by any spec | Warning | Feature exists with no governing clause |
7777

7878
## Output Contract
7979

‎.claude/skills/gov/SKILL.md‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -279,11 +279,11 @@ govctl work move <WI-ID> done
279279

280280
### Otherwise recover and continue
281281

282-
| Problem | Recovery |
283-
| ----------------------------- | --------------------------------------------------------------- |
284-
| `govctl check` fails | Read diagnostics, fix, rerun |
285-
| Tests fail | Debug, fix, rerun |
286-
| `work move ... done` rejected | Add or tick acceptance criteria first |
282+
| Problem | Recovery |
283+
| ----------------------------- | ----------------------------------------------- |
284+
| `govctl check` fails | Read diagnostics, fix, rerun |
285+
| Tests fail | Debug, fix, rerun |
286+
| `work move ... done` rejected | Add or tick acceptance criteria first |
287287
| Same failure repeats | Read `notes`; record a new plan or stop and ask |
288288

289289
## Commit Conventions

‎.claude/skills/wi-writer/SKILL.md‎

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -140,11 +140,11 @@ Do not hand-write descriptive loop IDs or encode time finer than the day in loop
140140

141141
## Field Semantics Summary
142142

143-
| Field | Purpose | Update Pattern |
144-
| --------------------- | -------------------------- | --------------------------------------------- |
145-
| `description` | Task scope declaration | Define once, rarely change |
146-
| `notes` | Durable learnings | Add when future steps must remember something |
147-
| `acceptance_criteria` | Completion criteria | Define then tick |
143+
| Field | Purpose | Update Pattern |
144+
| --------------------- | ---------------------- | --------------------------------------------- |
145+
| `description` | Task scope declaration | Define once, rarely change |
146+
| `notes` | Durable learnings | Add when future steps must remember something |
147+
| `acceptance_criteria` | Completion criteria | Define then tick |
148148

149149
**Per ADR-0047:** Keep description focused on "what", notes on durable "what to remember next", and execution trace outside the work item field surface.
150150
If you discover a missing requirement or unresolved design choice, stop and route that back to RFC/ADR work rather than inventing it inside the work item.
@@ -203,13 +203,13 @@ Keep `chore:` criteria for validation summaries, especially when the validation
203203

204204
## Common Mistakes
205205

206-
| Mistake | Fix |
207-
| ---------------------------------- | ----------------------------------------------------------- |
208-
| Missing category prefix | Always use `add:`, `fix:`, `chore:`, etc. |
209-
| Placeholder description left in | Replace immediately with real description |
210-
| Vague criteria: "Feature works" | Specific: "add: CLI returns exit code 0 on success" |
211-
| No `chore:` criterion | Add "chore: govctl check passes" or "chore: all tests pass" |
212-
| No refs to governing artifacts | Link RFCs/ADRs with `work add <WI-ID> refs` |
206+
| Mistake | Fix |
207+
| ---------------------------------- | ------------------------------------------------------------------------------------ |
208+
| Missing category prefix | Always use `add:`, `fix:`, `chore:`, etc. |
209+
| Placeholder description left in | Replace immediately with real description |
210+
| Vague criteria: "Feature works" | Specific: "add: CLI returns exit code 0 on success" |
211+
| No `chore:` criterion | Add "chore: govctl check passes" or "chore: all tests pass" |
212+
| No refs to governing artifacts | Link RFCs/ADRs with `work add <WI-ID> refs` |
213213
| Description used for tracking | Use loop state and round artifacts for execution trace or `notes` for durable memory |
214-
| Progress details stored as notes | Keep `notes` durable; put transient round logs in loop state and round artifacts |
215-
| Work item invents new requirements | Move those requirements into an RFC or ADR first |
214+
| Progress details stored as notes | Keep `notes` durable; put transient round logs in loop state and round artifacts |
215+
| Work item invents new requirements | Move those requirements into an RFC or ADR first |

0 commit comments

Comments
 (0)