fix(skills): plan is a decision artifact; progress comes from git (#666)
This commit is contained in:
@@ -64,7 +64,7 @@ A plan is ready when an implementer can start confidently without needing the pl
|
||||
If the user references an existing plan file or there is an obvious recent matching plan in `docs/plans/`:
|
||||
- Read it
|
||||
- Confirm whether to update it in place or create a new plan
|
||||
- If updating, preserve completed checkboxes and revise only the still-relevant sections
|
||||
- If updating, revise only the still-relevant sections. Plans do not carry per-unit progress state — progress is derived from git by `ce-work`, so there is no progress to preserve across edits
|
||||
|
||||
**Deepen intent:** The word "deepen" (or "deepening") in reference to a plan is the primary trigger for the deepening fast path. When the user says "deepen the plan", "deepen my plan", "run a deepening pass", or similar, the target document is a **plan** in `docs/plans/`, not a requirements document. Use any path, keyword, or context the user provides to identify the right plan. If a path is provided, verify it is actually a plan document. If the match is not obvious, confirm with the user before proceeding.
|
||||
|
||||
@@ -321,7 +321,6 @@ Good units are:
|
||||
- Usually touching a small cluster of related files
|
||||
- Ordered by dependency
|
||||
- Concrete enough for execution without pre-writing code
|
||||
- Marked with checkbox syntax for progress tracking
|
||||
|
||||
Avoid:
|
||||
- 2-5 minute micro-steps
|
||||
@@ -373,7 +372,7 @@ The tree is a scope declaration showing the expected output shape. It is not a c
|
||||
|
||||
#### 3.5 Define Each Implementation Unit
|
||||
|
||||
Each unit's heading carries a stable U-ID prefix matching the format used for R/A/F/AE in requirements docs: `- [ ] U1. **[Name]**`. The prefix is plain text, not bolded — the bold is reserved for the unit name. Number sequentially within the plan starting at U1.
|
||||
Each unit's heading carries a stable U-ID prefix matching the format used for R/A/F/AE in requirements docs: `- U1. **[Name]**`. The prefix is plain text, not bolded — the bold is reserved for the unit name. Number sequentially within the plan starting at U1. Do not prefix units with `- [ ]` / `- [x]` checkbox markers; the plan is a decision artifact, and execution progress is derived from git by `ce-work` rather than stored in the plan body.
|
||||
|
||||
**Stability rule.** Once assigned, a U-ID is never renumbered. Reordering units leaves their IDs in place (e.g., U1, U3, U5 in their new order is correct; renumbering to U1, U2, U3 is not). Splitting a unit keeps the original U-ID on the original concept and assigns the next unused number to the new unit. Deletion leaves a gap; gaps are fine. This rule matters most during deepening (Phase 5.3), which is the most likely accidental-renumber vector.
|
||||
|
||||
@@ -603,7 +602,7 @@ deepened: YYYY-MM-DD # optional, set when the confidence check substantively st
|
||||
a gap. This anchor is what ce-work references in blockers and verification, so
|
||||
stability across plan edits is load-bearing. -->
|
||||
|
||||
- [ ] U1. **[Name]**
|
||||
- U1. **[Name]**
|
||||
|
||||
**Goal:** [What this unit accomplishes]
|
||||
|
||||
@@ -723,7 +722,6 @@ For larger `Deep` plans, extend the core template only when useful with sections
|
||||
- **Horizontal rules (`---`) between top-level sections** in Standard and Deep plans, mirroring the `ce-brainstorm` requirements doc convention. Improves scannability of dense plans where many H2 sections sit close together. Omit for Lightweight plans where the whole doc fits on a single screen.
|
||||
- **All file paths must be repo-relative** — never use absolute paths like `/Users/name/Code/project/src/file.ts`. Use `src/file.ts` instead. Absolute paths make plans non-portable across machines, worktrees, and teammates. When a plan targets a different repo than the document's home, state the target repo once at the top of the plan (e.g., `**Target repo:** my-other-project`) and use repo-relative paths throughout
|
||||
- Prefer path plus class/component/pattern references over brittle line numbers
|
||||
- Keep implementation units checkable with `- [ ]` syntax for progress tracking
|
||||
- Do not include implementation code — no imports, exact method signatures, or framework-specific syntax
|
||||
- Pseudo-code sketches and DSL grammars are allowed in the High-Level Technical Design section and per-unit technical design fields when they communicate design direction. Frame them explicitly as directional guidance, not implementation specification
|
||||
- Mermaid diagrams are encouraged when they clarify relationships or flows that prose alone would make hard to follow — ERDs for data model changes, sequence diagrams for multi-service interactions, state diagrams for lifecycle transitions, flowcharts for complex branching logic
|
||||
|
||||
Reference in New Issue
Block a user