@sixsevenai/ai-dlc-installer 1.5.0 → 1.5.2

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.
Files changed (10) hide show
  1. package/library/commands/ai-dlc/cheatsheet.md +63 -63
  2. package/library/commands/ai-dlc/construct-unit.md +14 -0
  3. package/library/commands/ai-dlc/quickstart.md +150 -150
  4. package/library/commands/commit.md +15 -11
  5. package/library/commands/git/branch-report.md +176 -0
  6. package/library/commands/git/branch-validate.md +279 -0
  7. package/library/commands/git/rebase.md +232 -0
  8. package/library/commands/im-lost.md +245 -245
  9. package/library/commands/issue-to-done.md +320 -320
  10. package/package.json +1 -1
package/library/commands/ai-dlc/cheatsheet.md CHANGED
@@ -1,63 +1,63 @@
1
- ---
2
- command: ai-dlc:cheatsheet
3
- description: Display a quick-reference card of all AI-DLC slash commands organized by phase
4
- phase: cross-cutting
5
- allowed-tools: Read
6
- ---
7
-
8
- # AI-DLC Cheatsheet
9
-
10
- Output the following quick-reference card directly to the user. Do not add commentary — just present the card as-is in a single, readable block.
11
-
12
- ---
13
-
14
- ```
15
- AI-DLC Quick Reference
16
- ======================
17
-
18
- INCEPTION FLOW
19
- /ai-dlc:start-intent Define business intent (WHAT and WHY)
20
- /ai-dlc:create-units Decompose into atomic Units
21
- /ai-dlc:generate-stories Create INVEST user stories
22
- /ai-dlc:elicit-nfrs Define non-functional requirements
23
- /ai-dlc:assess-risks Identify risks and mitigations
24
- /ai-dlc:plan-bolt Estimate work in 1-3 day Bolts
25
- /ai-dlc:validate-phase inception Verify phase completeness
26
-
27
- CONSTRUCTION FLOW
28
- /ai-dlc:domain-model DDD domain modeling
29
- /ai-dlc:logical-design Architecture and ADRs
30
- /ai-dlc:design-api OpenAPI contract design
31
- /ai-dlc:generate-code Production code generation
32
- /ai-dlc:build-tests Test suite generation
33
- /ai-dlc:review-code 7-dimension code review
34
- /ai-dlc:validate-phase construction Verify phase completeness
35
-
36
- OPERATIONS FLOW
37
- /ai-dlc:package-unit Create deployment artifacts
38
- /ai-dlc:deploy Deploy to environment
39
- /ai-dlc:setup-monitoring Configure observability
40
- /ai-dlc:create-runbook Incident response procedures
41
- /ai-dlc:validate-phase operations Verify phase completeness
42
-
43
- UTILITY COMMANDS
44
- /ai-dlc:status Show current phase and progress
45
- /ai-dlc:next-phase Transition to next phase
46
- /ai-dlc:archive-session Archive completed work
47
- /ai-dlc:talk Interactive training with AI-DLC expert
48
- /ai-dlc:quickstart Guided onboarding (~5 min)
49
-
50
- COMPANION: SPECKIT (spec-driven development)
51
- /spec:specify Create feature specification
52
- /spec:clarify Fill spec gaps with questions
53
- /spec:plan Generate implementation plan
54
- /spec:tasks Generate dependency-ordered tasks
55
- /spec:implement Execute tasks from tasks.md
56
- /spec:to-intent Bridge spec to AI-DLC intent
57
-
58
- COMPANION: TASK (lightweight task planning)
59
- /task:plan Decompose prompt into task plan
60
- /task:execute Execute plan step-by-step
61
- /task:clarify Refine plan with questions
62
- /task:complete Finalize with Complete.md + commit
63
- ```
1
+ ---
2
+ command: ai-dlc:cheatsheet
3
+ description: Display a quick-reference card of all AI-DLC slash commands organized by phase
4
+ phase: cross-cutting
5
+ allowed-tools: Read
6
+ ---
7
+
8
+ # AI-DLC Cheatsheet
9
+
10
+ Output the following quick-reference card directly to the user. Do not add commentary — just present the card as-is in a single, readable block.
11
+
12
+ ---
13
+
14
+ ```
15
+ AI-DLC Quick Reference
16
+ ======================
17
+
18
+ INCEPTION FLOW
19
+ /ai-dlc:start-intent Define business intent (WHAT and WHY)
20
+ /ai-dlc:create-units Decompose into atomic Units
21
+ /ai-dlc:generate-stories Create INVEST user stories
22
+ /ai-dlc:elicit-nfrs Define non-functional requirements
23
+ /ai-dlc:assess-risks Identify risks and mitigations
24
+ /ai-dlc:plan-bolt Estimate work in 1-3 day Bolts
25
+ /ai-dlc:validate-phase inception Verify phase completeness
26
+
27
+ CONSTRUCTION FLOW
28
+ /ai-dlc:domain-model DDD domain modeling
29
+ /ai-dlc:logical-design Architecture and ADRs
30
+ /ai-dlc:design-api OpenAPI contract design
31
+ /ai-dlc:generate-code Production code generation
32
+ /ai-dlc:build-tests Test suite generation
33
+ /ai-dlc:review-code 7-dimension code review
34
+ /ai-dlc:validate-phase construction Verify phase completeness
35
+
36
+ OPERATIONS FLOW
37
+ /ai-dlc:package-unit Create deployment artifacts
38
+ /ai-dlc:deploy Deploy to environment
39
+ /ai-dlc:setup-monitoring Configure observability
40
+ /ai-dlc:create-runbook Incident response procedures
41
+ /ai-dlc:validate-phase operations Verify phase completeness
42
+
43
+ UTILITY COMMANDS
44
+ /ai-dlc:status Show current phase and progress
45
+ /ai-dlc:next-phase Transition to next phase
46
+ /ai-dlc:archive-session Archive completed work
47
+ /ai-dlc:talk Interactive training with AI-DLC expert
48
+ /ai-dlc:quickstart Guided onboarding (~5 min)
49
+
50
+ COMPANION: SPECKIT (spec-driven development)
51
+ /spec:specify Create feature specification
52
+ /spec:clarify Fill spec gaps with questions
53
+ /spec:plan Generate implementation plan
54
+ /spec:tasks Generate dependency-ordered tasks
55
+ /spec:implement Execute tasks from tasks.md
56
+ /spec:to-intent Bridge spec to AI-DLC intent
57
+
58
+ COMPANION: TASK (lightweight task planning)
59
+ /task:plan Decompose prompt into task plan
60
+ /task:execute Execute plan step-by-step
61
+ /task:clarify Refine plan with questions
62
+ /task:complete Finalize with Complete.md + commit
63
+ ```
package/library/commands/ai-dlc/construct-unit.md CHANGED
@@ -57,6 +57,20 @@ Has UI: ${has-ui !== false}
57
57
  Has API: ${has-api !== false}
58
58
  Has DB: ${has-db || false}
59
59
 
60
+ <auto-detection>
61
+ **IMPORTANT — Flag Auto-Detection:**
62
+ Before starting, run `ai-dlc prepare ai-dlc:construct-unit --unit ${unit-name}` and check the `suggestedDesignSteps` array in the JSON response.
63
+
64
+ If the user did NOT explicitly pass `--has-ui`, `--has-api`, or `--has-db` flags, use the CLI's detection results:
65
+ - **high confidence** suggestions → treat as if the flag was set to `true`
66
+ - **medium confidence** suggestions → treat as if the flag was set to `true`, but note it was auto-detected
67
+ - **low confidence** suggestions → skip unless you independently confirm the need after reading artifacts
68
+
69
+ If the user DID explicitly pass a flag, that flag always takes precedence over auto-detection.
70
+
71
+ Log which design steps were auto-detected vs explicitly requested so the user can see what happened.
72
+ </auto-detection>
73
+
60
74
  Execute the complete Construction workflow:
61
75
 
62
76
  <execution-steps>
package/library/commands/ai-dlc/quickstart.md CHANGED
@@ -1,150 +1,150 @@
1
- ---
2
- command: ai-dlc:quickstart
3
- description: Interactive 5-minute onboarding walkthrough for new AI-DLC users — covers core concepts, runs your first Intent, and shows next steps
4
- argument-hint: ""
5
- phase: cross-cutting
6
- allowed-tools: Task, Read, AskUserQuestion
7
- args: []
8
- ---
9
-
10
- # AI-DLC Quickstart
11
-
12
- A guided, conversational onboarding flow for new team members. Covers the three phases, core concepts, and walks you through creating your first Intent.
13
-
14
- ## Command: /ai-dlc:quickstart
15
-
16
- ## Context Isolation: Required
17
-
18
- **MANDATORY**: Use the Task tool to spawn the ai-dlc-trainer subagent. Do NOT execute the walkthrough in this context.
19
-
20
- Use Task tool with these parameters:
21
- - **subagent_type**: `ai-dlc-trainer`
22
- - **prompt**: See below
23
-
24
- ## Subagent Prompt
25
-
26
- ```
27
- You are running the AI-DLC Quickstart walkthrough for a new user. Keep everything concise and actionable — aim for ~5 minutes total.
28
-
29
- Follow these steps IN ORDER. After each step, pause and let the user respond before continuing.
30
-
31
- ---
32
-
33
- STEP 1: WELCOME AND OVERVIEW
34
-
35
- Print exactly:
36
-
37
- ## Welcome to AI-DLC
38
-
39
- **AI-DLC** (AI-Driven Lifecycle) replaces the traditional SDLC with three phases:
40
-
41
- | Phase | Purpose | Key Output |
42
- |-------|---------|------------|
43
- | **Inception** | Define WHAT and WHY | Intent, Units, Stories, NFRs, Risks, Bolt Plan |
44
- | **Construction** | Build production software | Domain Models, Code, Tests, Reviews |
45
- | **Operations** | Deploy, monitor, maintain | Deployments, Monitoring, Runbooks |
46
-
47
- **Two concepts to know:**
48
- - **Unit** — An atomic work item estimated at 1-3 Bolts
49
- - **Bolt** — A 1-3 day timebox that delivers a tangible artifact
50
-
51
- Every project starts with an **Intent** — a plain-language statement of your business goal.
52
-
53
- Then ask: "Ready to create your first Intent? (yes / I have questions first)"
54
-
55
- If the user has questions, answer them briefly, then proceed.
56
-
57
- ---
58
-
59
- STEP 2: CREATE YOUR FIRST INTENT
60
-
61
- Say:
62
-
63
- Let's start Inception. Run this command now:
64
-
65
- ```
66
- /ai-dlc:start-intent "Build a task management app for small teams"
67
- ```
68
-
69
- Or replace the text in quotes with your own idea. I'll wait while you run it.
70
-
71
- Wait for the user to confirm they ran it.
72
-
73
- ---
74
-
75
- STEP 3: CHECK YOUR PROGRESS
76
-
77
- Say:
78
-
79
- Now let's see what AI-DLC recorded. Run:
80
-
81
- ```
82
- /ai-dlc:status
83
- ```
84
-
85
- This shows your current phase, active session, and completed artifacts. You should see your new Intent listed under Inception.
86
-
87
- Wait for the user to confirm.
88
-
89
- ---
90
-
91
- STEP 4: EXPLAIN NEXT STEPS
92
-
93
- Print exactly:
94
-
95
- ## What Comes Next
96
-
97
- With your Intent created, here is the Inception sequence:
98
-
99
- 1. `/ai-dlc:create-units` — Break your Intent into Units
100
- 2. `/ai-dlc:generate-stories` — Create user stories for each Unit
101
- 3. `/ai-dlc:elicit-nfrs` — Capture non-functional requirements
102
- 4. `/ai-dlc:assess-risks project` — Identify risks and mitigations
103
- 5. `/ai-dlc:plan-bolt` — Estimate each Unit in Bolts
104
- 6. `/ai-dlc:validate-phase inception` — Confirm Inception is complete
105
-
106
- Once Inception passes validation, run `/ai-dlc:next-phase` to move into Construction.
107
-
108
- **Alternative:** Use `/ai-dlc:mob-elaborate` for a single collaborative session that produces Units, NFRs, and Risks together.
109
-
110
- ---
111
-
112
- STEP 5: POINT TO DEEPER RESOURCES
113
-
114
- Say:
115
-
116
- ## Resources
117
-
118
- - **Getting Started Guide**: Read `.claude/docs/GETTING-STARTED-GUIDE.md` for a full walkthrough
119
- - **Ask the Expert**: Run `/ai-dlc:talk` to chat with Dr. Alex Chen about methodology
120
- - **Agent Directory**: Run `/agent-directory` to see all 58 specialized agents
121
- - **Status Anytime**: Run `/ai-dlc:status` to see where you are
122
-
123
- You're all set. Run `/ai-dlc:create-units` to continue, or ask me anything.
124
-
125
- ---
126
-
127
- End the session after Step 5 unless the user asks follow-up questions.
128
- ```
129
-
130
- ## Usage Examples
131
-
132
- ```bash
133
- /ai-dlc:quickstart
134
- ```
135
-
136
- ## What You'll Learn
137
-
138
- - **Core Concepts**: Phases, Units, and Bolts
139
- - **First Command**: Create an Intent hands-on
140
- - **Status Check**: See your progress in AI-DLC
141
- - **Next Steps**: The full Inception command sequence
142
- - **Resources**: Where to learn more
143
-
144
- ## Prerequisites
145
-
146
- None — designed for first-time users.
147
-
148
- ## Duration
149
-
150
- Approximately 5 minutes.
1
+ ---
2
+ command: ai-dlc:quickstart
3
+ description: Interactive 5-minute onboarding walkthrough for new AI-DLC users — covers core concepts, runs your first Intent, and shows next steps
4
+ argument-hint: ""
5
+ phase: cross-cutting
6
+ allowed-tools: Task, Read, AskUserQuestion
7
+ args: []
8
+ ---
9
+
10
+ # AI-DLC Quickstart
11
+
12
+ A guided, conversational onboarding flow for new team members. Covers the three phases, core concepts, and walks you through creating your first Intent.
13
+
14
+ ## Command: /ai-dlc:quickstart
15
+
16
+ ## Context Isolation: Required
17
+
18
+ **MANDATORY**: Use the Task tool to spawn the ai-dlc-trainer subagent. Do NOT execute the walkthrough in this context.
19
+
20
+ Use Task tool with these parameters:
21
+ - **subagent_type**: `ai-dlc-trainer`
22
+ - **prompt**: See below
23
+
24
+ ## Subagent Prompt
25
+
26
+ ```
27
+ You are running the AI-DLC Quickstart walkthrough for a new user. Keep everything concise and actionable — aim for ~5 minutes total.
28
+
29
+ Follow these steps IN ORDER. After each step, pause and let the user respond before continuing.
30
+
31
+ ---
32
+
33
+ STEP 1: WELCOME AND OVERVIEW
34
+
35
+ Print exactly:
36
+
37
+ ## Welcome to AI-DLC
38
+
39
+ **AI-DLC** (AI-Driven Lifecycle) replaces the traditional SDLC with three phases:
40
+
41
+ | Phase | Purpose | Key Output |
42
+ |-------|---------|------------|
43
+ | **Inception** | Define WHAT and WHY | Intent, Units, Stories, NFRs, Risks, Bolt Plan |
44
+ | **Construction** | Build production software | Domain Models, Code, Tests, Reviews |
45
+ | **Operations** | Deploy, monitor, maintain | Deployments, Monitoring, Runbooks |
46
+
47
+ **Two concepts to know:**
48
+ - **Unit** — An atomic work item estimated at 1-3 Bolts
49
+ - **Bolt** — A 1-3 day timebox that delivers a tangible artifact
50
+
51
+ Every project starts with an **Intent** — a plain-language statement of your business goal.
52
+
53
+ Then ask: "Ready to create your first Intent? (yes / I have questions first)"
54
+
55
+ If the user has questions, answer them briefly, then proceed.
56
+
57
+ ---
58
+
59
+ STEP 2: CREATE YOUR FIRST INTENT
60
+
61
+ Say:
62
+
63
+ Let's start Inception. Run this command now:
64
+
65
+ ```
66
+ /ai-dlc:start-intent "Build a task management app for small teams"
67
+ ```
68
+
69
+ Or replace the text in quotes with your own idea. I'll wait while you run it.
70
+
71
+ Wait for the user to confirm they ran it.
72
+
73
+ ---
74
+
75
+ STEP 3: CHECK YOUR PROGRESS
76
+
77
+ Say:
78
+
79
+ Now let's see what AI-DLC recorded. Run:
80
+
81
+ ```
82
+ /ai-dlc:status
83
+ ```
84
+
85
+ This shows your current phase, active session, and completed artifacts. You should see your new Intent listed under Inception.
86
+
87
+ Wait for the user to confirm.
88
+
89
+ ---
90
+
91
+ STEP 4: EXPLAIN NEXT STEPS
92
+
93
+ Print exactly:
94
+
95
+ ## What Comes Next
96
+
97
+ With your Intent created, here is the Inception sequence:
98
+
99
+ 1. `/ai-dlc:create-units` — Break your Intent into Units
100
+ 2. `/ai-dlc:generate-stories` — Create user stories for each Unit
101
+ 3. `/ai-dlc:elicit-nfrs` — Capture non-functional requirements
102
+ 4. `/ai-dlc:assess-risks project` — Identify risks and mitigations
103
+ 5. `/ai-dlc:plan-bolt` — Estimate each Unit in Bolts
104
+ 6. `/ai-dlc:validate-phase inception` — Confirm Inception is complete
105
+
106
+ Once Inception passes validation, run `/ai-dlc:next-phase` to move into Construction.
107
+
108
+ **Alternative:** Use `/ai-dlc:mob-elaborate` for a single collaborative session that produces Units, NFRs, and Risks together.
109
+
110
+ ---
111
+
112
+ STEP 5: POINT TO DEEPER RESOURCES
113
+
114
+ Say:
115
+
116
+ ## Resources
117
+
118
+ - **Getting Started Guide**: Read `.claude/docs/GETTING-STARTED-GUIDE.md` for a full walkthrough
119
+ - **Ask the Expert**: Run `/ai-dlc:talk` to chat with Dr. Alex Chen about methodology
120
+ - **Agent Directory**: Run `/agent-directory` to see all 58 specialized agents
121
+ - **Status Anytime**: Run `/ai-dlc:status` to see where you are
122
+
123
+ You're all set. Run `/ai-dlc:create-units` to continue, or ask me anything.
124
+
125
+ ---
126
+
127
+ End the session after Step 5 unless the user asks follow-up questions.
128
+ ```
129
+
130
+ ## Usage Examples
131
+
132
+ ```bash
133
+ /ai-dlc:quickstart
134
+ ```
135
+
136
+ ## What You'll Learn
137
+
138
+ - **Core Concepts**: Phases, Units, and Bolts
139
+ - **First Command**: Create an Intent hands-on
140
+ - **Status Check**: See your progress in AI-DLC
141
+ - **Next Steps**: The full Inception command sequence
142
+ - **Resources**: Where to learn more
143
+
144
+ ## Prerequisites
145
+
146
+ None — designed for first-time users.
147
+
148
+ ## Duration
149
+
150
+ Approximately 5 minutes.
package/library/commands/commit.md CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  command: commit
3
3
  description: Intelligently group staged changes into logical commits
4
- argument-hint: "[--all] [--staged] [--review] [--generate-pr] [--generate-merge-pr] [--generate-merge-pr-tag]"
4
+ argument-hint: "[--all] [--staged] [--review] [--generate-pr] [--generate-merge-pr] [--generate-merge-pr-tag] [--no-squash]"
5
5
  allowed-tools: Bash, Read, Glob, Grep
6
6
  ---
7
7
 
@@ -17,8 +17,8 @@ Intelligently group staged changes into logical commits.
17
17
  /commit --staged --review # Review proposed groupings before committing
18
18
  /commit --all --review # Review proposed groupings for all changes
19
19
  /commit --generate-pr # Commit and create pull request
20
- /commit --generate-merge-pr # Commit, create PR, and merge to main
21
- /commit --generate-merge-pr-tag # Commit, create PR, merge, and tag release
20
+ /commit --generate-merge-pr # Commit, create PR, and squash merge to main
21
+ /commit --generate-merge-pr-tag # Commit, create PR, squash merge, and tag release
22
22
  ```
23
23
 
24
24
  ## Options
@@ -27,8 +27,9 @@ Intelligently group staged changes into logical commits.
27
27
  - `--all`: Include both staged and unstaged changes
28
28
  - `--review`: Show proposed groupings and ask for confirmation before committing
29
29
  - `--generate-pr`: Create a pull request after committing
30
- - `--generate-merge-pr`: Create and merge a PR after committing
31
- - `--generate-merge-pr-tag`: Create, merge PR, and create a semantic version tag
30
+ - `--generate-merge-pr`: Create and squash merge a PR after committing
31
+ - `--generate-merge-pr-tag`: Create, squash merge PR, and create a semantic version tag
32
+ - `--no-squash`: Use regular merge instead of squash merge (applies to `--generate-merge-pr` and `--generate-merge-pr-tag`)
32
33
  - `--force`: Bypass PR readiness checks (open AI-DLC sessions/specs)
33
34
 
34
35
  ## How It Works
@@ -37,7 +38,7 @@ Intelligently group staged changes into logical commits.
37
38
  2. **Groups** related changes (tests with source, features together, docs/config separately)
38
39
  3. **Generates** conventional commit messages with emojis
39
40
  4. **Creates** commits automatically (or shows review if `--review` flag)
40
- 5. **Optional PR workflow**: Push → Create PR → Merge → Tag with semantic versioning
41
+ 5. **Optional PR workflow**: Push → Create PR → Squash Merge → Tag with semantic versioning
41
42
 
42
43
  ---
43
44
 
@@ -117,11 +118,11 @@ Creates a pull request on GitHub (runs Branch Sync Gate first)
117
118
  </execution-mode>
118
119
 
119
120
  <execution-mode name="generate-merge-pr" trigger="--generate-merge-pr">
120
- Creates PR, merges to main, and pulls main locally (runs Branch Sync Gate first)
121
+ Creates PR, squash merges to main, and pulls main locally (runs Branch Sync Gate first). Use `--no-squash` for regular merge.
121
122
  </execution-mode>
122
123
 
123
124
  <execution-mode name="generate-merge-pr-tag" trigger="--generate-merge-pr-tag">
124
- Creates PR, merges, pulls main, and creates a semantic version tag (v1.0.0 → v1.0.1) (runs Branch Sync Gate first)
125
+ Creates PR, squash merges, pulls main, and creates a semantic version tag (v1.0.0 → v1.0.1) (runs Branch Sync Gate first). Use `--no-squash` for regular merge.
125
126
  </execution-mode>
126
127
 
127
128
  ---
@@ -140,11 +141,14 @@ Creates PR, merges, pulls main, and creates a semantic version tag (v1.0.0 → v
140
141
  /commit --generate-pr # Commit and create PR
141
142
  /commit --all --generate-pr # Commit all and create PR
142
143
 
143
- /commit --generate-merge-pr # Commit, create PR, and merge to main
144
- /commit --all --generate-merge-pr # Commit all, create PR, and merge
144
+ /commit --generate-merge-pr # Commit, create PR, and squash merge to main
145
+ /commit --all --generate-merge-pr # Commit all, create PR, and squash merge
145
146
 
146
- /commit --generate-merge-pr-tag # Full workflow: commit → push → PR → merge → tag
147
+ /commit --generate-merge-pr-tag # Full workflow: commit → push → PR → squash merge → tag
147
148
  /commit --all --generate-merge-pr-tag # Full workflow with all changes
149
+
150
+ /commit --generate-merge-pr --no-squash # Regular merge instead of squash
151
+ /commit --generate-merge-pr-tag --no-squash # Regular merge with tagging
148
152
  ```
149
153
 
150
154
  **With review:**