create-sdd-project 0.8.9 → 0.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "create-sdd-project",
3
- "version": "0.8.9",
3
+ "version": "0.9.1",
4
4
  "description": "Create a new SDD DevFlow project with AI-assisted development workflow",
5
5
  "bin": {
6
6
  "create-sdd-project": "bin/cli.js"
@@ -59,9 +59,9 @@ Ask user to classify complexity before starting. See `references/complexity-guid
59
59
 
60
60
  | Tier | Spec | Ticket | Plan | QA |
61
61
  |------|:----:|:------:|:----:|:--:|
62
- | Simple | Skip | Skip | Skip | Skip |
63
- | Standard | Yes | Yes | Yes | Yes |
64
- | Complex | Yes | Yes + ADR | Yes | Yes |
62
+ | Simple | Skip | Lite | Skip | Skip |
63
+ | Standard | Yes | Full | Yes | Yes |
64
+ | Complex | Yes | Full + ADR | Yes | Yes |
65
65
 
66
66
  ---
67
67
 
@@ -85,9 +85,10 @@ See `references/branching-strategy.md` for details.
85
85
 
86
86
  1. Verify product tracker exists, no active feature, dependencies met
87
87
  2. Create feature branch: `feature/<feature-id>-<short-description>`
88
- 3. **Std/Cplx:** Copy ALL sections from `references/ticket-template.md` (Spec, Implementation Plan, Acceptance Criteria, Definition of Done, Workflow Checklist, Completion Log) fill `## Spec` section. Do NOT omit empty sections they are filled in later steps. **After generating the ticket, verify it contains ALL 6 sections in this exact order: Spec Implementation Plan Acceptance Criteria → Definition of Done → Workflow Checklist → Completion Log. If any section is missing, add it now.**
89
- 4. **Complex:** Also review `decisions.md` for related ADRs
90
- 5. Update product tracker → Active Session: feature, step `1/6 (Setup)`, branch, complexity. Update Features table: status `in-progress`, step `1/6`
88
+ 3. **Simple:** Generate a **lite ticket** at `docs/tickets/<feature-id>-<short-desc>.md` using `references/ticket-template.md`. Fill the header and a one-line `## Spec > Description`. Set `## Implementation Plan` to `N/A Simple task`. Fill lightweight Acceptance Criteria and Definition of Done. Set Workflow Checklist to Steps 1, 3, 4, 5 only. Leave Completion Log and Merge Checklist Evidence empty (filled in later steps). **Verify the ticket contains ALL 7 sections.**
89
+ 4. **Std/Cplx:** Copy ALL sections from `references/ticket-template.md` (Spec, Implementation Plan, Acceptance Criteria, Definition of Done, Workflow Checklist, Completion Log) → fill `## Spec` section. Do NOT omit empty sections — they are filled in later steps. **After generating the ticket, verify it contains ALL 7 sections in this exact order: Spec → Implementation Plan → Acceptance Criteria → Definition of Done → Workflow Checklist → Completion Log → Merge Checklist Evidence. If any section is missing, add it now.**
90
+ 5. **Complex:** Also review `decisions.md` for related ADRs
91
+ 6. Update product tracker → Active Session: feature, step `1/6 (Setup)`, branch, complexity. Update Features table: status `in-progress`, step `1/6`
91
92
 
92
93
  **→ CHECKPOINT: Ticket Approval** (Std/Cplx only — Simple skips to Step 3)
93
94
 
@@ -153,7 +154,7 @@ Update tracker (Active Session + Features table): step `4/6 (Finalize)`. Mark ti
153
154
 
154
155
  **→ CHECKPOINT: Merge Approval**
155
156
 
156
- **STOP.** Read `references/merge-checklist.md` and execute ALL actions in order. Do NOT request merge approval until every action is done.
157
+ **STOP.** Read `references/merge-checklist.md` and execute ALL actions in order (including filling the `## Merge Checklist Evidence` table in the ticket). Do NOT request merge approval until every action is done.
157
158
 
158
159
  ---
159
160
 
@@ -71,7 +71,7 @@ Complexity and Autonomy Level combine to determine the effective workflow overhe
71
71
 
72
72
  | Combination | Effect |
73
73
  |-------------|--------|
74
- | Simple + Any Level | Minimal overhead (branch → TDD → commit → PR) |
74
+ | Simple + Any Level | Lite ticket, no spec/plan/QA (branch → lite ticket → TDD → commit → PR + merge checklist) |
75
75
  | Standard + L1 | Maximum oversight (5 checkpoints) |
76
76
  | Standard + L2 | Balanced (Plan + Merge checkpoints only) |
77
77
  | Standard + L3-4 | Fast execution, quality gates + QA still enforced |
@@ -3,19 +3,21 @@
3
3
  > Execute ALL actions below IN ORDER before requesting merge approval from the user.
4
4
  > Do NOT skip any action. Do NOT request merge approval until every action is complete.
5
5
 
6
- ## Action 0: Validate ticket structure (Std/Cplx)
6
+ ## Action 0: Validate ticket structure
7
7
 
8
8
  Re-read the ticket file (`docs/tickets/<feature-id>.md`).
9
9
 
10
- Verify it contains ALL required sections: **Acceptance Criteria**, **Definition of Done**, **Workflow Checklist**, **Completion Log**.
10
+ Verify it contains ALL required sections: **Acceptance Criteria**, **Definition of Done**, **Workflow Checklist**, **Completion Log**, **Merge Checklist Evidence**.
11
11
 
12
12
  **If ANY section is missing**, add it from `references/ticket-template.md` before continuing.
13
13
 
14
- ## Action 1: Mark all items (Std/Cplx)
14
+ **Simple (lite ticket):** Verify same sections exist. Spec and Implementation Plan may be minimal (one-liner / N/A).
15
+
16
+ ## Action 1: Mark all items
15
17
 
16
18
  In the ticket file, mark ALL items `[x]` in:
17
19
 
18
- - **Workflow Checklist** — Steps 0 through 5 (all that apply to this complexity tier)
20
+ - **Workflow Checklist** — all steps that apply to this complexity tier (Simple: 1, 3, 4, 5. Standard: 0–5. Complex: 0–5)
19
21
  - **Acceptance Criteria** — every item
20
22
  - **Definition of Done** — every item
21
23
 
@@ -46,6 +48,17 @@ Commit ALL documentation updates from actions 0–4. Use commit message: `docs:
46
48
 
47
49
  Run `git status`. **No unstaged or untracked files allowed.** If any remain, stage and commit them.
48
50
 
49
- ## Action 7: Request merge approval
51
+ ## Action 7: Fill Merge Checklist Evidence
52
+
53
+ In the ticket, fill the `## Merge Checklist Evidence` table. For each action (0–6), mark `[x]` and write the actual evidence (not placeholders). Example:
54
+
55
+ | Action | Done | Evidence |
56
+ |--------|:----:|----------|
57
+ | 0. Validate ticket structure | [x] | Sections verified: Spec, Plan, AC, DoD, Workflow, Log, Evidence |
58
+ | 1. Mark all items | [x] | AC: 12/12, DoD: 7/7, Workflow: 0-5/6 |
59
+
60
+ ## Action 8: Request merge approval
61
+
62
+ Verify the Merge Checklist Evidence table is fully filled (all rows `[x]` with real evidence).
50
63
 
51
64
  THEN — and only then — request merge approval from the user.
@@ -87,4 +87,20 @@ This creates a feedback loop for improving future reviews. -->
87
87
 
88
88
  ---
89
89
 
90
+ ## Merge Checklist Evidence
91
+
92
+ > **MANDATORY before requesting merge approval.** Read `references/merge-checklist.md` and execute ALL actions. Record evidence below.
93
+
94
+ | Action | Done | Evidence |
95
+ |--------|:----:|----------|
96
+ | 0. Validate ticket structure | [ ] | Sections verified: (list) |
97
+ | 1. Mark all items | [ ] | AC: _/_, DoD: _/_, Workflow: _/_ |
98
+ | 2. Verify product tracker | [ ] | Active Session: step _/6, Features table: _/6 |
99
+ | 3. Update key_facts.md | [ ] | Updated: (list) / N/A |
100
+ | 4. Update decisions.md | [ ] | ADR-XXX added / N/A |
101
+ | 5. Commit documentation | [ ] | Commit: (hash) |
102
+ | 6. Verify clean working tree | [ ] | `git status`: clean |
103
+
104
+ ---
105
+
90
106
  *Ticket created: [YYYY-MM-DD]*
@@ -59,9 +59,9 @@ Ask user to classify complexity before starting. See `references/complexity-guid
59
59
 
60
60
  | Tier | Spec | Ticket | Plan | QA |
61
61
  |------|:----:|:------:|:----:|:--:|
62
- | Simple | Skip | Skip | Skip | Skip |
63
- | Standard | Yes | Yes | Yes | Yes |
64
- | Complex | Yes | Yes + ADR | Yes | Yes |
62
+ | Simple | Skip | Lite | Skip | Skip |
63
+ | Standard | Yes | Full | Yes | Yes |
64
+ | Complex | Yes | Full + ADR | Yes | Yes |
65
65
 
66
66
  ---
67
67
 
@@ -85,9 +85,10 @@ See `references/branching-strategy.md` for details.
85
85
 
86
86
  1. Verify product tracker exists, no active feature, dependencies met
87
87
  2. Create feature branch: `feature/<feature-id>-<short-description>`
88
- 3. **Std/Cplx:** Copy ALL sections from `references/ticket-template.md` (Spec, Implementation Plan, Acceptance Criteria, Definition of Done, Workflow Checklist, Completion Log) fill `## Spec` section. Do NOT omit empty sections they are filled in later steps. **After generating the ticket, verify it contains ALL 6 sections in this exact order: Spec Implementation Plan Acceptance Criteria → Definition of Done → Workflow Checklist → Completion Log. If any section is missing, add it now.**
89
- 4. **Complex:** Also review `decisions.md` for related ADRs
90
- 5. Update product tracker → Active Session: feature, step `1/6 (Setup)`, branch, complexity. Update Features table: status `in-progress`, step `1/6`
88
+ 3. **Simple:** Generate a **lite ticket** at `docs/tickets/<feature-id>-<short-desc>.md` using `references/ticket-template.md`. Fill the header and a one-line `## Spec > Description`. Set `## Implementation Plan` to `N/A Simple task`. Fill lightweight Acceptance Criteria and Definition of Done. Set Workflow Checklist to Steps 1, 3, 4, 5 only. Leave Completion Log and Merge Checklist Evidence empty (filled in later steps). **Verify the ticket contains ALL 7 sections.**
89
+ 4. **Std/Cplx:** Copy ALL sections from `references/ticket-template.md` (Spec, Implementation Plan, Acceptance Criteria, Definition of Done, Workflow Checklist, Completion Log) → fill `## Spec` section. Do NOT omit empty sections — they are filled in later steps. **After generating the ticket, verify it contains ALL 7 sections in this exact order: Spec → Implementation Plan → Acceptance Criteria → Definition of Done → Workflow Checklist → Completion Log → Merge Checklist Evidence. If any section is missing, add it now.**
90
+ 5. **Complex:** Also review `decisions.md` for related ADRs
91
+ 6. Update product tracker → Active Session: feature, step `1/6 (Setup)`, branch, complexity. Update Features table: status `in-progress`, step `1/6`
91
92
 
92
93
  **→ CHECKPOINT: Ticket Approval** (Std/Cplx only — Simple skips to Step 3)
93
94
 
@@ -153,7 +154,7 @@ Update tracker (Active Session + Features table): step `4/6 (Finalize)`. Mark ti
153
154
 
154
155
  **→ CHECKPOINT: Merge Approval**
155
156
 
156
- **STOP.** Read `references/merge-checklist.md` and execute ALL actions in order. Do NOT request merge approval until every action is done.
157
+ **STOP.** Read `references/merge-checklist.md` and execute ALL actions in order (including filling the `## Merge Checklist Evidence` table in the ticket). Do NOT request merge approval until every action is done.
157
158
 
158
159
  ---
159
160
 
@@ -71,7 +71,7 @@ Complexity and Autonomy Level combine to determine the effective workflow overhe
71
71
 
72
72
  | Combination | Effect |
73
73
  |-------------|--------|
74
- | Simple + Any Level | Minimal overhead (branch → TDD → commit → PR) |
74
+ | Simple + Any Level | Lite ticket, no spec/plan/QA (branch → lite ticket → TDD → commit → PR + merge checklist) |
75
75
  | Standard + L1 | Maximum oversight (5 checkpoints) |
76
76
  | Standard + L2 | Balanced (Plan + Merge checkpoints only) |
77
77
  | Standard + L3-4 | Fast execution, quality gates + QA still enforced |
@@ -3,19 +3,21 @@
3
3
  > Execute ALL actions below IN ORDER before requesting merge approval from the user.
4
4
  > Do NOT skip any action. Do NOT request merge approval until every action is complete.
5
5
 
6
- ## Action 0: Validate ticket structure (Std/Cplx)
6
+ ## Action 0: Validate ticket structure
7
7
 
8
8
  Re-read the ticket file (`docs/tickets/<feature-id>.md`).
9
9
 
10
- Verify it contains ALL required sections: **Acceptance Criteria**, **Definition of Done**, **Workflow Checklist**, **Completion Log**.
10
+ Verify it contains ALL required sections: **Acceptance Criteria**, **Definition of Done**, **Workflow Checklist**, **Completion Log**, **Merge Checklist Evidence**.
11
11
 
12
12
  **If ANY section is missing**, add it from `references/ticket-template.md` before continuing.
13
13
 
14
- ## Action 1: Mark all items (Std/Cplx)
14
+ **Simple (lite ticket):** Verify same sections exist. Spec and Implementation Plan may be minimal (one-liner / N/A).
15
+
16
+ ## Action 1: Mark all items
15
17
 
16
18
  In the ticket file, mark ALL items `[x]` in:
17
19
 
18
- - **Workflow Checklist** — Steps 0 through 5 (all that apply to this complexity tier)
20
+ - **Workflow Checklist** — all steps that apply to this complexity tier (Simple: 1, 3, 4, 5. Standard: 0–5. Complex: 0–5)
19
21
  - **Acceptance Criteria** — every item
20
22
  - **Definition of Done** — every item
21
23
 
@@ -46,6 +48,17 @@ Commit ALL documentation updates from actions 0–4. Use commit message: `docs:
46
48
 
47
49
  Run `git status`. **No unstaged or untracked files allowed.** If any remain, stage and commit them.
48
50
 
49
- ## Action 7: Request merge approval
51
+ ## Action 7: Fill Merge Checklist Evidence
52
+
53
+ In the ticket, fill the `## Merge Checklist Evidence` table. For each action (0–6), mark `[x]` and write the actual evidence (not placeholders). Example:
54
+
55
+ | Action | Done | Evidence |
56
+ |--------|:----:|----------|
57
+ | 0. Validate ticket structure | [x] | Sections verified: Spec, Plan, AC, DoD, Workflow, Log, Evidence |
58
+ | 1. Mark all items | [x] | AC: 12/12, DoD: 7/7, Workflow: 0-5/6 |
59
+
60
+ ## Action 8: Request merge approval
61
+
62
+ Verify the Merge Checklist Evidence table is fully filled (all rows `[x]` with real evidence).
50
63
 
51
64
  THEN — and only then — request merge approval from the user.
@@ -87,4 +87,20 @@ This creates a feedback loop for improving future reviews. -->
87
87
 
88
88
  ---
89
89
 
90
+ ## Merge Checklist Evidence
91
+
92
+ > **MANDATORY before requesting merge approval.** Read `references/merge-checklist.md` and execute ALL actions. Record evidence below.
93
+
94
+ | Action | Done | Evidence |
95
+ |--------|:----:|----------|
96
+ | 0. Validate ticket structure | [ ] | Sections verified: (list) |
97
+ | 1. Mark all items | [ ] | AC: _/_, DoD: _/_, Workflow: _/_ |
98
+ | 2. Verify product tracker | [ ] | Active Session: step _/6, Features table: _/6 |
99
+ | 3. Update key_facts.md | [ ] | Updated: (list) / N/A |
100
+ | 4. Update decisions.md | [ ] | ADR-XXX added / N/A |
101
+ | 5. Commit documentation | [ ] | Commit: (hash) |
102
+ | 6. Verify clean working tree | [ ] | `git status`: clean |
103
+
104
+ ---
105
+
90
106
  *Ticket created: [YYYY-MM-DD]*