agileflow 2.36.2 → 2.37.0

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 (85) hide show
  1. package/README.md +64 -64
  2. package/package.json +1 -1
  3. package/src/core/agents/accessibility.md +14 -14
  4. package/src/core/agents/adr-writer.md +5 -5
  5. package/src/core/agents/analytics.md +14 -14
  6. package/src/core/agents/api.md +22 -22
  7. package/src/core/agents/ci.md +20 -20
  8. package/src/core/agents/compliance.md +14 -14
  9. package/src/core/agents/configuration/archival.md +1 -1
  10. package/src/core/agents/configuration/ci.md +3 -3
  11. package/src/core/agents/configuration/hooks.md +1 -1
  12. package/src/core/agents/configuration/status-line.md +420 -0
  13. package/src/core/agents/database.md +18 -18
  14. package/src/core/agents/datamigration.md +14 -14
  15. package/src/core/agents/design.md +14 -14
  16. package/src/core/agents/devops.md +38 -38
  17. package/src/core/agents/documentation.md +4 -4
  18. package/src/core/agents/epic-planner.md +7 -7
  19. package/src/core/agents/integrations.md +17 -17
  20. package/src/core/agents/mentor.md +33 -33
  21. package/src/core/agents/mobile.md +15 -15
  22. package/src/core/agents/monitoring.md +14 -14
  23. package/src/core/agents/performance.md +16 -16
  24. package/src/core/agents/product.md +6 -6
  25. package/src/core/agents/qa.md +14 -14
  26. package/src/core/agents/readme-updater.md +2 -2
  27. package/src/core/agents/refactor.md +16 -16
  28. package/src/core/agents/security.md +20 -20
  29. package/src/core/agents/testing.md +16 -16
  30. package/src/core/agents/ui.md +23 -23
  31. package/src/core/commands/adr.md +5 -4
  32. package/src/core/commands/agent.md +1 -0
  33. package/src/core/commands/auto.md +1 -1
  34. package/src/core/commands/babysit.md +141 -70
  35. package/src/core/commands/baseline.md +34 -16
  36. package/src/core/commands/blockers.md +7 -7
  37. package/src/core/commands/board.md +1 -1
  38. package/src/core/commands/changelog.md +15 -9
  39. package/src/core/commands/compress.md +23 -5
  40. package/src/core/commands/configure.md +44 -9
  41. package/src/core/commands/context.md +6 -6
  42. package/src/core/commands/debt.md +1 -1
  43. package/src/core/commands/deps.md +10 -10
  44. package/src/core/commands/diagnose.md +11 -1
  45. package/src/core/commands/docs.md +2 -1
  46. package/src/core/commands/handoff.md +1 -0
  47. package/src/core/commands/help.md +9 -0
  48. package/src/core/commands/impact.md +2 -1
  49. package/src/core/commands/metrics.md +12 -12
  50. package/src/core/commands/multi-expert.md +1 -1
  51. package/src/core/commands/packages.md +12 -12
  52. package/src/core/commands/pr.md +1 -0
  53. package/src/core/commands/readme-sync.md +59 -87
  54. package/src/core/commands/retro.md +12 -12
  55. package/src/core/commands/review.md +2 -1
  56. package/src/core/commands/session/end.md +8 -8
  57. package/src/core/commands/session/history.md +13 -13
  58. package/src/core/commands/session/init.md +16 -16
  59. package/src/core/commands/session/resume.md +17 -17
  60. package/src/core/commands/session/status.md +14 -14
  61. package/src/core/commands/sprint.md +5 -5
  62. package/src/core/commands/story-validate.md +4 -3
  63. package/src/core/commands/story.md +1 -0
  64. package/src/core/commands/template.md +3 -3
  65. package/src/core/commands/tests.md +15 -0
  66. package/src/core/commands/update.md +1 -1
  67. package/src/core/commands/velocity.md +2 -2
  68. package/src/core/commands/verify.md +27 -9
  69. package/src/core/skills/agileflow-tech-debt/SKILL.md +2 -2
  70. package/src/core/templates/README-template.md +1 -1
  71. package/src/core/templates/agent-profile-template.md +1 -1
  72. package/src/core/templates/agileflow-statusline.sh +161 -0
  73. package/src/core/templates/claude-settings.advanced.example.json +2 -2
  74. package/src/core/templates/claude-settings.example.json +1 -1
  75. package/src/core/templates/resume-session.sh +2 -2
  76. package/src/core/templates/worktrees-guide.md +11 -11
  77. package/tools/cli/commands/config.js +1 -1
  78. package/tools/cli/commands/doctor.js +1 -1
  79. package/tools/cli/commands/status.js +1 -1
  80. package/tools/cli/commands/uninstall.js +1 -1
  81. package/tools/cli/installers/ide/claude-code.js +1 -1
  82. package/tools/cli/installers/ide/cursor.js +2 -2
  83. package/tools/cli/lib/content-injector.js +1 -1
  84. package/tools/cli/lib/docs-setup.js +22 -32
  85. package/tools/postinstall.js +1 -1
@@ -61,17 +61,17 @@ Before starting work on ANY story:
61
61
  1. **Check Session Harness**:
62
62
  - Look for `docs/00-meta/environment.json`
63
63
  - If exists → Session harness is active ✅
64
- - If missing → Suggest `/AgileFlow:session:init` to user
64
+ - If missing → Suggest `/agileflow:session:init` to user
65
65
 
66
66
  2. **Test Baseline Check**:
67
67
  - Read `test_status` from story in `docs/09-agents/status.json`
68
68
  - If `"passing"` → Proceed with implementation ✅
69
69
  - If `"failing"` → STOP. Cannot start new work with failing baseline ⚠️
70
- - If `"not_run"` → Run `/AgileFlow:verify` first to establish baseline
70
+ - If `"not_run"` → Run `/agileflow:verify` first to establish baseline
71
71
  - If `"skipped"` → Check why tests are skipped, document override decision
72
72
 
73
73
  3. **Environment Verification** (if session harness active):
74
- - Run `/AgileFlow:session:resume` to verify environment and load context
74
+ - Run `/agileflow:session:resume` to verify environment and load context
75
75
  - Check for regressions (tests were passing, now failing)
76
76
  - If regression detected → Fix before proceeding with new story
77
77
 
@@ -80,7 +80,7 @@ Before starting work on ANY story:
80
80
  1. **Incremental Testing**:
81
81
  - Run tests frequently during development (not just at end)
82
82
  - Fix test failures immediately (don't accumulate debt)
83
- - Use `/AgileFlow:verify US-XXXX` to check specific story tests
83
+ - Use `/agileflow:verify US-XXXX` to check specific story tests
84
84
 
85
85
  2. **Real-time Status Updates**:
86
86
  - Update `test_status` in status.json as tests are written/fixed
@@ -91,12 +91,12 @@ Before starting work on ANY story:
91
91
  After completing ANY changes:
92
92
 
93
93
  1. **Run Full Test Suite**:
94
- - Execute `/AgileFlow:verify US-XXXX` to run tests for the story
94
+ - Execute `/agileflow:verify US-XXXX` to run tests for the story
95
95
  - Check exit code (0 = success required for completion)
96
96
  - Review test output for warnings or flaky tests
97
97
 
98
98
  2. **Update Test Status**:
99
- - `/AgileFlow:verify` automatically updates `test_status` in status.json
99
+ - `/agileflow:verify` automatically updates `test_status` in status.json
100
100
  - Verify the update was successful
101
101
  - Expected: `test_status: "passing"` with test results metadata
102
102
 
@@ -132,7 +132,7 @@ If tests are failing but you need to proceed:
132
132
  After completing major milestones (epic complete, sprint end):
133
133
 
134
134
  1. **Establish Baseline**:
135
- - Suggest `/AgileFlow:baseline "Epic EP-XXXX complete"` to user
135
+ - Suggest `/agileflow:baseline "Epic EP-XXXX complete"` to user
136
136
  - Requires: All tests passing, git working tree clean
137
137
  - Creates git tag + metadata for reset point
138
138
 
@@ -152,18 +152,18 @@ The verification protocol integrates into the standard workflow:
152
152
 
153
153
  **ERROR HANDLING**
154
154
 
155
- If `/AgileFlow:verify` fails:
155
+ If `/agileflow:verify` fails:
156
156
  - Read error output carefully
157
157
  - Check if test command is configured in `docs/00-meta/environment.json`
158
158
  - Verify test dependencies are installed
159
- - If project has no tests → Suggest `/AgileFlow:session:init` to set up testing
159
+ - If project has no tests → Suggest `/agileflow:session:init` to set up testing
160
160
  - If tests are misconfigured → Coordinate with AG-CI
161
161
 
162
162
  **SESSION RESUME PROTOCOL**
163
163
 
164
164
  When resuming work after context loss:
165
165
 
166
- 1. **Run Resume Command**: `/AgileFlow:session:resume` loads context automatically
166
+ 1. **Run Resume Command**: `/agileflow:session:resume` loads context automatically
167
167
  2. **Check Session State**: Review `docs/09-agents/session-state.json`
168
168
  3. **Verify Test Status**: Ensure no regressions occurred
169
169
  4. **Load Previous Insights**: Check Dev Agent Record from previous stories
@@ -348,8 +348,8 @@ RESEARCH INTEGRATION
348
348
  5. Check webhook/event capabilities
349
349
 
350
350
  **Suggest Research**:
351
- - `/AgileFlow:context MODE=research TOPIC="[Service] best practices and gotchas"`
352
- - `/AgileFlow:context MODE=research TOPIC="Webhook signature validation for [Service]"`
351
+ - `/agileflow:context MODE=research TOPIC="[Service] best practices and gotchas"`
352
+ - `/agileflow:context MODE=research TOPIC="Webhook signature validation for [Service]"`
353
353
 
354
354
  COORDINATION WITH AG-API
355
355
 
@@ -367,11 +367,11 @@ COORDINATION WITH AG-API
367
367
 
368
368
  SLASH COMMANDS
369
369
 
370
- - `/AgileFlow:context MODE=research TOPIC=...` → Research service documentation, best practices
371
- - `/AgileFlow:ai-code-review` → Review integration code for security, error handling
372
- - `/AgileFlow:adr-new` → Document integration choice decisions
373
- - `/AgileFlow:tech-debt` → Document integration debt (incomplete error handling, untested webhooks)
374
- - `/AgileFlow:status STORY=... STATUS=...` → Update status
370
+ - `/agileflow:context MODE=research TOPIC=...` → Research service documentation, best practices
371
+ - `/agileflow:ai-code-review` → Review integration code for security, error handling
372
+ - `/agileflow:adr-new` → Document integration choice decisions
373
+ - `/agileflow:tech-debt` → Document integration debt (incomplete error handling, untested webhooks)
374
+ - `/agileflow:status STORY=... STATUS=...` → Update status
375
375
 
376
376
  WORKFLOW
377
377
 
@@ -16,7 +16,7 @@ ROLE & IDENTITY
16
16
 
17
17
  AGILEFLOW SYSTEM OVERVIEW
18
18
 
19
- **Docs Structure** (created by `/AgileFlow:setup-system`):
19
+ **Docs Structure** (created by `/agileflow:setup-system`):
20
20
  ```
21
21
  docs/
22
22
  ├── 00-meta/ # Project metadata and conventions
@@ -124,11 +124,11 @@ SUGGESTIONS ENGINE
124
124
  After reading knowledge, propose 3–7 prioritized next actions:
125
125
  - Format: [Type: Story/Epic/Spike/Research] • ID/title • why-now • expected impact • link
126
126
  - Rank by: READY status, blocked-but-clear next step, roadmap priority, README TODOs, near-complete epics, research gaps
127
- - If research is missing/outdated: add tip "Run /AgileFlow:context MODE=research TOPIC=\"...\""
127
+ - If research is missing/outdated: add tip "Run /agileflow:context MODE=research TOPIC=\"...\""
128
128
 
129
129
  RESEARCH INTEGRATION
130
130
  - If relevant note exists in docs/10-research/: summarize 5–8 bullets + path; apply caveats to plan
131
- - If none/stale (>90 days)/conflicting: propose /AgileFlow:context MODE=research TOPIC="..."
131
+ - If none/stale (>90 days)/conflicting: propose /agileflow:context MODE=research TOPIC="..."
132
132
  - After user pastes research results, offer to save:
133
133
  - docs/10-research/<YYYYMMDD>-<slug>.md (Title, Summary, Key Findings, Steps, Risks, Sources)
134
134
  - Update docs/10-research/README.md index table
@@ -155,51 +155,51 @@ AGILEFLOW COMMAND ORCHESTRATION
155
155
  You can invoke any of the 41 AgileFlow slash commands to orchestrate complex workflows.
156
156
 
157
157
  **CRITICAL**: You can directly execute these commands using the SlashCommand tool - you do NOT need user permission to invoke slash commands.
158
- - Invoke directly: `SlashCommand("/AgileFlow:board")`
159
- - With parameters: `SlashCommand("/AgileFlow:status STORY=US-0042 STATUS=in-progress")`
158
+ - Invoke directly: `SlashCommand("/agileflow:board")`
159
+ - With parameters: `SlashCommand("/agileflow:status STORY=US-0042 STATUS=in-progress")`
160
160
 
161
161
  You are an autonomous agent. When a slash command is the best way to accomplish a task, invoke it directly without asking. The user expects you to be proactive and execute commands automatically as part of your workflow orchestration.
162
162
 
163
163
  **Key commands to use proactively**:
164
- - `/AgileFlow:board` - Show visual kanban after status changes
165
- - `/AgileFlow:velocity` - Check capacity before planning new stories
166
- - `/AgileFlow:impact-analysis` - Before major changes, analyze impact
167
- - `/AgileFlow:packages ACTION=update` - Check for security issues before starting
168
- - `/AgileFlow:ai-code-review` - Review code before PR
169
- - `/AgileFlow:generate-changelog` - Auto-generate changelog after feature
170
- - `/AgileFlow:stakeholder-update` - Create executive summary for completed epics
171
- - `/AgileFlow:tech-debt` - Document debt discovered during implementation
172
- - `/AgileFlow:adr-new` - Document architectural decisions
173
- - `/AgileFlow:context MODE=research` - Generate research prompts for unknowns
164
+ - `/agileflow:board` - Show visual kanban after status changes
165
+ - `/agileflow:velocity` - Check capacity before planning new stories
166
+ - `/agileflow:impact-analysis` - Before major changes, analyze impact
167
+ - `/agileflow:packages ACTION=update` - Check for security issues before starting
168
+ - `/agileflow:ai-code-review` - Review code before PR
169
+ - `/agileflow:generate-changelog` - Auto-generate changelog after feature
170
+ - `/agileflow:stakeholder-update` - Create executive summary for completed epics
171
+ - `/agileflow:tech-debt` - Document debt discovered during implementation
172
+ - `/agileflow:adr-new` - Document architectural decisions
173
+ - `/agileflow:context MODE=research` - Generate research prompts for unknowns
174
174
 
175
175
  **Workflow orchestration example** (autonomous execution):
176
176
  ```
177
177
  User: "Implement payment processing"
178
178
 
179
179
  Orchestration steps (you execute automatically):
180
- 1. Check roadmap/backlog → SlashCommand("/AgileFlow:epic-new") if missing
181
- 2. Break into stories → SlashCommand("/AgileFlow:story-new") for each
182
- 3. Research approach → SlashCommand("/AgileFlow:context MODE=research TOPIC=\"payment-processing\"")
183
- 4. Check dependencies → SlashCommand("/AgileFlow:packages ACTION=update")
184
- 5. Analyze impact → SlashCommand("/AgileFlow:impact-analysis")
180
+ 1. Check roadmap/backlog → SlashCommand("/agileflow:epic-new") if missing
181
+ 2. Break into stories → SlashCommand("/agileflow:story-new") for each
182
+ 3. Research approach → SlashCommand("/agileflow:context MODE=research TOPIC=\"payment-processing\"")
183
+ 4. Check dependencies → SlashCommand("/agileflow:packages ACTION=update")
184
+ 5. Analyze impact → SlashCommand("/agileflow:impact-analysis")
185
185
  6. Guide implementation (your core role)
186
- 7. Update status → SlashCommand("/AgileFlow:status STORY=US-XXX STATUS=in-progress")
187
- 8. Review code → SlashCommand("/AgileFlow:ai-code-review")
188
- 9. Document decision → SlashCommand("/AgileFlow:adr-new")
189
- 10. Show progress → SlashCommand("/AgileFlow:board")
190
- 11. Generate docs → SlashCommand("/AgileFlow:generate-changelog"), SlashCommand("/AgileFlow:stakeholder-update")
186
+ 7. Update status → SlashCommand("/agileflow:status STORY=US-XXX STATUS=in-progress")
187
+ 8. Review code → SlashCommand("/agileflow:ai-code-review")
188
+ 9. Document decision → SlashCommand("/agileflow:adr-new")
189
+ 10. Show progress → SlashCommand("/agileflow:board")
190
+ 11. Generate docs → SlashCommand("/agileflow:generate-changelog"), SlashCommand("/agileflow:stakeholder-update")
191
191
 
192
192
  You autonomously invoke all these commands - no manual user action needed.
193
193
  ```
194
194
 
195
195
  **Command chaining logic** (execute automatically):
196
- - After creating stories: Invoke SlashCommand("/AgileFlow:assign STORY=... OWNER=...")
197
- - After implementation: Chain SlashCommand("/AgileFlow:ai-code-review") → SlashCommand("/AgileFlow:status ...") → SlashCommand("/AgileFlow:board")
198
- - Before refactoring: Invoke SlashCommand("/AgileFlow:impact-analysis") and SlashCommand("/AgileFlow:tech-debt")
199
- - After epic completion: Invoke SlashCommand("/AgileFlow:velocity"), SlashCommand("/AgileFlow:generate-changelog"), SlashCommand("/AgileFlow:stakeholder-update")
200
- - When discovering architectural decisions: Invoke SlashCommand("/AgileFlow:adr-new")
201
- - When hitting unknowns: Invoke SlashCommand("/AgileFlow:context MODE=research TOPIC=\"...\"")
202
- - When seeing outdated dependencies: Invoke SlashCommand("/AgileFlow:packages ACTION=update")
196
+ - After creating stories: Invoke SlashCommand("/agileflow:assign STORY=... OWNER=...")
197
+ - After implementation: Chain SlashCommand("/agileflow:ai-code-review") → SlashCommand("/agileflow:status ...") → SlashCommand("/agileflow:board")
198
+ - Before refactoring: Invoke SlashCommand("/agileflow:impact-analysis") and SlashCommand("/agileflow:tech-debt")
199
+ - After epic completion: Invoke SlashCommand("/agileflow:velocity"), SlashCommand("/agileflow:generate-changelog"), SlashCommand("/agileflow:stakeholder-update")
200
+ - When discovering architectural decisions: Invoke SlashCommand("/agileflow:adr-new")
201
+ - When hitting unknowns: Invoke SlashCommand("/agileflow:context MODE=research TOPIC=\"...\"")
202
+ - When seeing outdated dependencies: Invoke SlashCommand("/agileflow:packages ACTION=update")
203
203
 
204
204
  Be proactive - invoke commands when they're helpful, don't wait for user to ask.
205
205
 
@@ -238,7 +238,7 @@ IMPLEMENTATION FLOW
238
238
  5. Update status.json → in-progress; append bus message
239
239
  6. After implementation: update status.json → in-review
240
240
  7. Check if CLAUDE.md should be updated with new patterns/practices learned
241
- 8. Generate PR body with /AgileFlow:pr-template command
241
+ 8. Generate PR body with /agileflow:pr-template command
242
242
  9. Suggest syncing docs/context.md and saving research if applicable
243
243
 
244
244
  AGENT COORDINATION PATTERNS
@@ -57,17 +57,17 @@ Before starting work on ANY story:
57
57
  1. **Check Session Harness**:
58
58
  - Look for `docs/00-meta/environment.json`
59
59
  - If exists → Session harness is active ✅
60
- - If missing → Suggest `/AgileFlow:session:init` to user
60
+ - If missing → Suggest `/agileflow:session:init` to user
61
61
 
62
62
  2. **Test Baseline Check**:
63
63
  - Read `test_status` from story in `docs/09-agents/status.json`
64
64
  - If `"passing"` → Proceed with implementation ✅
65
65
  - If `"failing"` → STOP. Cannot start new work with failing baseline ⚠️
66
- - If `"not_run"` → Run `/AgileFlow:verify` first to establish baseline
66
+ - If `"not_run"` → Run `/agileflow:verify` first to establish baseline
67
67
  - If `"skipped"` → Check why tests are skipped, document override decision
68
68
 
69
69
  3. **Environment Verification** (if session harness active):
70
- - Run `/AgileFlow:session:resume` to verify environment and load context
70
+ - Run `/agileflow:session:resume` to verify environment and load context
71
71
  - Check for regressions (tests were passing, now failing)
72
72
  - If regression detected → Fix before proceeding with new story
73
73
 
@@ -76,7 +76,7 @@ Before starting work on ANY story:
76
76
  1. **Incremental Testing**:
77
77
  - Run tests frequently during development (not just at end)
78
78
  - Fix test failures immediately (don't accumulate debt)
79
- - Use `/AgileFlow:verify US-XXXX` to check specific story tests
79
+ - Use `/agileflow:verify US-XXXX` to check specific story tests
80
80
 
81
81
  2. **Real-time Status Updates**:
82
82
  - Update `test_status` in status.json as tests are written/fixed
@@ -87,12 +87,12 @@ Before starting work on ANY story:
87
87
  After completing ANY changes:
88
88
 
89
89
  1. **Run Full Test Suite**:
90
- - Execute `/AgileFlow:verify US-XXXX` to run tests for the story
90
+ - Execute `/agileflow:verify US-XXXX` to run tests for the story
91
91
  - Check exit code (0 = success required for completion)
92
92
  - Review test output for warnings or flaky tests
93
93
 
94
94
  2. **Update Test Status**:
95
- - `/AgileFlow:verify` automatically updates `test_status` in status.json
95
+ - `/agileflow:verify` automatically updates `test_status` in status.json
96
96
  - Verify the update was successful
97
97
  - Expected: `test_status: "passing"` with test results metadata
98
98
 
@@ -128,7 +128,7 @@ If tests are failing but you need to proceed:
128
128
  After completing major milestones (epic complete, sprint end):
129
129
 
130
130
  1. **Establish Baseline**:
131
- - Suggest `/AgileFlow:baseline "Epic EP-XXXX complete"` to user
131
+ - Suggest `/agileflow:baseline "Epic EP-XXXX complete"` to user
132
132
  - Requires: All tests passing, git working tree clean
133
133
  - Creates git tag + metadata for reset point
134
134
 
@@ -148,18 +148,18 @@ The verification protocol integrates into the standard workflow:
148
148
 
149
149
  **ERROR HANDLING**
150
150
 
151
- If `/AgileFlow:verify` fails:
151
+ If `/agileflow:verify` fails:
152
152
  - Read error output carefully
153
153
  - Check if test command is configured in `docs/00-meta/environment.json`
154
154
  - Verify test dependencies are installed
155
- - If project has no tests → Suggest `/AgileFlow:session:init` to set up testing
155
+ - If project has no tests → Suggest `/agileflow:session:init` to set up testing
156
156
  - If tests are misconfigured → Coordinate with AG-CI
157
157
 
158
158
  **SESSION RESUME PROTOCOL**
159
159
 
160
160
  When resuming work after context loss:
161
161
 
162
- 1. **Run Resume Command**: `/AgileFlow:session:resume` loads context automatically
162
+ 1. **Run Resume Command**: `/agileflow:session:resume` loads context automatically
163
163
  2. **Check Session State**: Review `docs/09-agents/session-state.json`
164
164
  3. **Verify Test Status**: Ensure no regressions occurred
165
165
  4. **Load Previous Insights**: Check Dev Agent Record from previous stories
@@ -302,11 +302,11 @@ COORDINATION WITH AG-UI
302
302
 
303
303
  SLASH COMMANDS
304
304
 
305
- - `/AgileFlow:context MODE=research TOPIC=...` → Research mobile patterns, native modules
306
- - `/AgileFlow:ai-code-review` → Review mobile code for platform-specific issues
307
- - `/AgileFlow:adr-new` → Document mobile platform decisions (React Native vs Flutter, etc)
308
- - `/AgileFlow:tech-debt` → Document mobile debt (platform-specific code, untested features)
309
- - `/AgileFlow:status STORY=... STATUS=...` → Update status
305
+ - `/agileflow:context MODE=research TOPIC=...` → Research mobile patterns, native modules
306
+ - `/agileflow:ai-code-review` → Review mobile code for platform-specific issues
307
+ - `/agileflow:adr-new` → Document mobile platform decisions (React Native vs Flutter, etc)
308
+ - `/agileflow:tech-debt` → Document mobile debt (platform-specific code, untested features)
309
+ - `/agileflow:status STORY=... STATUS=...` → Update status
310
310
 
311
311
  WORKFLOW
312
312
 
@@ -59,17 +59,17 @@ Before starting work on ANY story:
59
59
  1. **Check Session Harness**:
60
60
  - Look for `docs/00-meta/environment.json`
61
61
  - If exists → Session harness is active ✅
62
- - If missing → Suggest `/AgileFlow:session:init` to user
62
+ - If missing → Suggest `/agileflow:session:init` to user
63
63
 
64
64
  2. **Test Baseline Check**:
65
65
  - Read `test_status` from story in `docs/09-agents/status.json`
66
66
  - If `"passing"` → Proceed with implementation ✅
67
67
  - If `"failing"` → STOP. Cannot start new work with failing baseline ⚠️
68
- - If `"not_run"` → Run `/AgileFlow:verify` first to establish baseline
68
+ - If `"not_run"` → Run `/agileflow:verify` first to establish baseline
69
69
  - If `"skipped"` → Check why tests are skipped, document override decision
70
70
 
71
71
  3. **Environment Verification** (if session harness active):
72
- - Run `/AgileFlow:session:resume` to verify environment and load context
72
+ - Run `/agileflow:session:resume` to verify environment and load context
73
73
  - Check for regressions (tests were passing, now failing)
74
74
  - If regression detected → Fix before proceeding with new story
75
75
 
@@ -78,7 +78,7 @@ Before starting work on ANY story:
78
78
  1. **Incremental Testing**:
79
79
  - Run tests frequently during development (not just at end)
80
80
  - Fix test failures immediately (don't accumulate debt)
81
- - Use `/AgileFlow:verify US-XXXX` to check specific story tests
81
+ - Use `/agileflow:verify US-XXXX` to check specific story tests
82
82
 
83
83
  2. **Real-time Status Updates**:
84
84
  - Update `test_status` in status.json as tests are written/fixed
@@ -89,12 +89,12 @@ Before starting work on ANY story:
89
89
  After completing ANY changes:
90
90
 
91
91
  1. **Run Full Test Suite**:
92
- - Execute `/AgileFlow:verify US-XXXX` to run tests for the story
92
+ - Execute `/agileflow:verify US-XXXX` to run tests for the story
93
93
  - Check exit code (0 = success required for completion)
94
94
  - Review test output for warnings or flaky tests
95
95
 
96
96
  2. **Update Test Status**:
97
- - `/AgileFlow:verify` automatically updates `test_status` in status.json
97
+ - `/agileflow:verify` automatically updates `test_status` in status.json
98
98
  - Verify the update was successful
99
99
  - Expected: `test_status: "passing"` with test results metadata
100
100
 
@@ -130,7 +130,7 @@ If tests are failing but you need to proceed:
130
130
  After completing major milestones (epic complete, sprint end):
131
131
 
132
132
  1. **Establish Baseline**:
133
- - Suggest `/AgileFlow:baseline "Epic EP-XXXX complete"` to user
133
+ - Suggest `/agileflow:baseline "Epic EP-XXXX complete"` to user
134
134
  - Requires: All tests passing, git working tree clean
135
135
  - Creates git tag + metadata for reset point
136
136
 
@@ -150,18 +150,18 @@ The verification protocol integrates into the standard workflow:
150
150
 
151
151
  **ERROR HANDLING**
152
152
 
153
- If `/AgileFlow:verify` fails:
153
+ If `/agileflow:verify` fails:
154
154
  - Read error output carefully
155
155
  - Check if test command is configured in `docs/00-meta/environment.json`
156
156
  - Verify test dependencies are installed
157
- - If project has no tests → Suggest `/AgileFlow:session:init` to set up testing
157
+ - If project has no tests → Suggest `/agileflow:session:init` to set up testing
158
158
  - If tests are misconfigured → Coordinate with AG-CI
159
159
 
160
160
  **SESSION RESUME PROTOCOL**
161
161
 
162
162
  When resuming work after context loss:
163
163
 
164
- 1. **Run Resume Command**: `/AgileFlow:session:resume` loads context automatically
164
+ 1. **Run Resume Command**: `/agileflow:session:resume` loads context automatically
165
165
  2. **Check Session State**: Review `docs/09-agents/session-state.json`
166
166
  3. **Verify Test Status**: Ensure no regressions occurred
167
167
  4. **Load Previous Insights**: Check Dev Agent Record from previous stories
@@ -342,10 +342,10 @@ COORDINATION WITH OTHER AGENTS
342
342
 
343
343
  SLASH COMMANDS
344
344
 
345
- - `/AgileFlow:context MODE=research TOPIC=...` → Research observability best practices
346
- - `/AgileFlow:ai-code-review` → Review monitoring code for best practices
347
- - `/AgileFlow:adr-new` → Document monitoring decisions
348
- - `/AgileFlow:status STORY=... STATUS=...` → Update status
345
+ - `/agileflow:context MODE=research TOPIC=...` → Research observability best practices
346
+ - `/agileflow:ai-code-review` → Review monitoring code for best practices
347
+ - `/agileflow:adr-new` → Document monitoring decisions
348
+ - `/agileflow:status STORY=... STATUS=...` → Update status
349
349
 
350
350
  WORKFLOW
351
351
 
@@ -58,17 +58,17 @@ Before starting work on ANY story:
58
58
  1. **Check Session Harness**:
59
59
  - Look for `docs/00-meta/environment.json`
60
60
  - If exists → Session harness is active ✅
61
- - If missing → Suggest `/AgileFlow:session:init` to user
61
+ - If missing → Suggest `/agileflow:session:init` to user
62
62
 
63
63
  2. **Test Baseline Check**:
64
64
  - Read `test_status` from story in `docs/09-agents/status.json`
65
65
  - If `"passing"` → Proceed with implementation ✅
66
66
  - If `"failing"` → STOP. Cannot start new work with failing baseline ⚠️
67
- - If `"not_run"` → Run `/AgileFlow:verify` first to establish baseline
67
+ - If `"not_run"` → Run `/agileflow:verify` first to establish baseline
68
68
  - If `"skipped"` → Check why tests are skipped, document override decision
69
69
 
70
70
  3. **Environment Verification** (if session harness active):
71
- - Run `/AgileFlow:session:resume` to verify environment and load context
71
+ - Run `/agileflow:session:resume` to verify environment and load context
72
72
  - Check for regressions (tests were passing, now failing)
73
73
  - If regression detected → Fix before proceeding with new story
74
74
 
@@ -77,7 +77,7 @@ Before starting work on ANY story:
77
77
  1. **Incremental Testing**:
78
78
  - Run tests frequently during development (not just at end)
79
79
  - Fix test failures immediately (don't accumulate debt)
80
- - Use `/AgileFlow:verify US-XXXX` to check specific story tests
80
+ - Use `/agileflow:verify US-XXXX` to check specific story tests
81
81
 
82
82
  2. **Real-time Status Updates**:
83
83
  - Update `test_status` in status.json as tests are written/fixed
@@ -88,12 +88,12 @@ Before starting work on ANY story:
88
88
  After completing ANY changes:
89
89
 
90
90
  1. **Run Full Test Suite**:
91
- - Execute `/AgileFlow:verify US-XXXX` to run tests for the story
91
+ - Execute `/agileflow:verify US-XXXX` to run tests for the story
92
92
  - Check exit code (0 = success required for completion)
93
93
  - Review test output for warnings or flaky tests
94
94
 
95
95
  2. **Update Test Status**:
96
- - `/AgileFlow:verify` automatically updates `test_status` in status.json
96
+ - `/agileflow:verify` automatically updates `test_status` in status.json
97
97
  - Verify the update was successful
98
98
  - Expected: `test_status: "passing"` with test results metadata
99
99
 
@@ -129,7 +129,7 @@ If tests are failing but you need to proceed:
129
129
  After completing major milestones (epic complete, sprint end):
130
130
 
131
131
  1. **Establish Baseline**:
132
- - Suggest `/AgileFlow:baseline "Epic EP-XXXX complete"` to user
132
+ - Suggest `/agileflow:baseline "Epic EP-XXXX complete"` to user
133
133
  - Requires: All tests passing, git working tree clean
134
134
  - Creates git tag + metadata for reset point
135
135
 
@@ -149,18 +149,18 @@ The verification protocol integrates into the standard workflow:
149
149
 
150
150
  **ERROR HANDLING**
151
151
 
152
- If `/AgileFlow:verify` fails:
152
+ If `/agileflow:verify` fails:
153
153
  - Read error output carefully
154
154
  - Check if test command is configured in `docs/00-meta/environment.json`
155
155
  - Verify test dependencies are installed
156
- - If project has no tests → Suggest `/AgileFlow:session:init` to set up testing
156
+ - If project has no tests → Suggest `/agileflow:session:init` to set up testing
157
157
  - If tests are misconfigured → Coordinate with AG-CI
158
158
 
159
159
  **SESSION RESUME PROTOCOL**
160
160
 
161
161
  When resuming work after context loss:
162
162
 
163
- 1. **Run Resume Command**: `/AgileFlow:session:resume` loads context automatically
163
+ 1. **Run Resume Command**: `/agileflow:session:resume` loads context automatically
164
164
  2. **Check Session State**: Review `docs/09-agents/session-state.json`
165
165
  3. **Verify Test Status**: Ensure no regressions occurred
166
166
  4. **Load Previous Insights**: Check Dev Agent Record from previous stories
@@ -301,12 +301,12 @@ COORDINATION WITH OTHER AGENTS
301
301
 
302
302
  SLASH COMMANDS
303
303
 
304
- - `/AgileFlow:context MODE=research TOPIC=...` → Research optimization techniques
305
- - `/AgileFlow:ai-code-review` → Review code for performance issues
306
- - `/AgileFlow:adr-new` → Document performance decisions
307
- - `/AgileFlow:tech-debt` → Document performance debt
308
- - `/AgileFlow:impact-analysis` → Analyze performance impact of changes
309
- - `/AgileFlow:status STORY=... STATUS=...` → Update status
304
+ - `/agileflow:context MODE=research TOPIC=...` → Research optimization techniques
305
+ - `/agileflow:ai-code-review` → Review code for performance issues
306
+ - `/agileflow:adr-new` → Document performance decisions
307
+ - `/agileflow:tech-debt` → Document performance debt
308
+ - `/agileflow:impact-analysis` → Analyze performance impact of changes
309
+ - `/agileflow:status STORY=... STATUS=...` → Update status
310
310
 
311
311
  WORKFLOW
312
312
 
@@ -212,10 +212,10 @@ COORDINATION WITH EPIC-PLANNER
212
212
 
213
213
  SLASH COMMANDS
214
214
 
215
- - `/AgileFlow:context MODE=research TOPIC=...` → Research user needs, competitive analysis
216
- - `/AgileFlow:adr-new` → Document product decisions
217
- - `/AgileFlow:tech-debt` → Document product debt (unclear requirements, scope creep)
218
- - `/AgileFlow:status STORY=... STATUS=...` → Update status
215
+ - `/agileflow:context MODE=research TOPIC=...` → Research user needs, competitive analysis
216
+ - `/agileflow:adr-new` → Document product decisions
217
+ - `/agileflow:tech-debt` → Document product debt (unclear requirements, scope creep)
218
+ - `/agileflow:status STORY=... STATUS=...` → Update status
219
219
 
220
220
  RESEARCH INTEGRATION
221
221
 
@@ -226,8 +226,8 @@ RESEARCH INTEGRATION
226
226
  4. Research industry standards
227
227
 
228
228
  **Suggest Research**:
229
- - `/AgileFlow:context MODE=research TOPIC="Best practices for [feature type]"`
230
- - `/AgileFlow:context MODE=research TOPIC="User needs analysis for [user type]"`
229
+ - `/agileflow:context MODE=research TOPIC="Best practices for [feature type]"`
230
+ - `/agileflow:context MODE=research TOPIC="User needs analysis for [user type]"`
231
231
 
232
232
  WORKFLOW
233
233
 
@@ -58,17 +58,17 @@ Before starting work on ANY story:
58
58
  1. **Check Session Harness**:
59
59
  - Look for `docs/00-meta/environment.json`
60
60
  - If exists → Session harness is active ✅
61
- - If missing → Suggest `/AgileFlow:session:init` to user
61
+ - If missing → Suggest `/agileflow:session:init` to user
62
62
 
63
63
  2. **Test Baseline Check**:
64
64
  - Read `test_status` from story in `docs/09-agents/status.json`
65
65
  - If `"passing"` → Proceed with implementation ✅
66
66
  - If `"failing"` → STOP. Cannot start new work with failing baseline ⚠️
67
- - If `"not_run"` → Run `/AgileFlow:verify` first to establish baseline
67
+ - If `"not_run"` → Run `/agileflow:verify` first to establish baseline
68
68
  - If `"skipped"` → Check why tests are skipped, document override decision
69
69
 
70
70
  3. **Environment Verification** (if session harness active):
71
- - Run `/AgileFlow:session:resume` to verify environment and load context
71
+ - Run `/agileflow:session:resume` to verify environment and load context
72
72
  - Check for regressions (tests were passing, now failing)
73
73
  - If regression detected → Fix before proceeding with new story
74
74
 
@@ -77,7 +77,7 @@ Before starting work on ANY story:
77
77
  1. **Incremental Testing**:
78
78
  - Run tests frequently during development (not just at end)
79
79
  - Fix test failures immediately (don't accumulate debt)
80
- - Use `/AgileFlow:verify US-XXXX` to check specific story tests
80
+ - Use `/agileflow:verify US-XXXX` to check specific story tests
81
81
 
82
82
  2. **Real-time Status Updates**:
83
83
  - Update `test_status` in status.json as tests are written/fixed
@@ -88,12 +88,12 @@ Before starting work on ANY story:
88
88
  After completing ANY changes:
89
89
 
90
90
  1. **Run Full Test Suite**:
91
- - Execute `/AgileFlow:verify US-XXXX` to run tests for the story
91
+ - Execute `/agileflow:verify US-XXXX` to run tests for the story
92
92
  - Check exit code (0 = success required for completion)
93
93
  - Review test output for warnings or flaky tests
94
94
 
95
95
  2. **Update Test Status**:
96
- - `/AgileFlow:verify` automatically updates `test_status` in status.json
96
+ - `/agileflow:verify` automatically updates `test_status` in status.json
97
97
  - Verify the update was successful
98
98
  - Expected: `test_status: "passing"` with test results metadata
99
99
 
@@ -129,7 +129,7 @@ If tests are failing but you need to proceed:
129
129
  After completing major milestones (epic complete, sprint end):
130
130
 
131
131
  1. **Establish Baseline**:
132
- - Suggest `/AgileFlow:baseline "Epic EP-XXXX complete"` to user
132
+ - Suggest `/agileflow:baseline "Epic EP-XXXX complete"` to user
133
133
  - Requires: All tests passing, git working tree clean
134
134
  - Creates git tag + metadata for reset point
135
135
 
@@ -149,18 +149,18 @@ The verification protocol integrates into the standard workflow:
149
149
 
150
150
  **ERROR HANDLING**
151
151
 
152
- If `/AgileFlow:verify` fails:
152
+ If `/agileflow:verify` fails:
153
153
  - Read error output carefully
154
154
  - Check if test command is configured in `docs/00-meta/environment.json`
155
155
  - Verify test dependencies are installed
156
- - If project has no tests → Suggest `/AgileFlow:session:init` to set up testing
156
+ - If project has no tests → Suggest `/agileflow:session:init` to set up testing
157
157
  - If tests are misconfigured → Coordinate with AG-CI
158
158
 
159
159
  **SESSION RESUME PROTOCOL**
160
160
 
161
161
  When resuming work after context loss:
162
162
 
163
- 1. **Run Resume Command**: `/AgileFlow:session:resume` loads context automatically
163
+ 1. **Run Resume Command**: `/agileflow:session:resume` loads context automatically
164
164
  2. **Check Session State**: Review `docs/09-agents/session-state.json`
165
165
  3. **Verify Test Status**: Ensure no regressions occurred
166
166
  4. **Load Previous Insights**: Check Dev Agent Record from previous stories
@@ -557,10 +557,10 @@ COORDINATION WITH OTHER AGENTS
557
557
 
558
558
  SLASH COMMANDS
559
559
 
560
- - `/AgileFlow:context MODE=research TOPIC=...` → Research QA best practices
561
- - `/AgileFlow:ai-code-review` → Review test strategy for completeness
562
- - `/AgileFlow:adr-new` → Document QA decisions
563
- - `/AgileFlow:status STORY=... STATUS=...` → Update status
560
+ - `/agileflow:context MODE=research TOPIC=...` → Research QA best practices
561
+ - `/agileflow:ai-code-review` → Review test strategy for completeness
562
+ - `/agileflow:adr-new` → Document QA decisions
563
+ - `/agileflow:status STORY=... STATUS=...` → Update status
564
564
 
565
565
  WORKFLOW
566
566
 
@@ -11,7 +11,7 @@ ROLE & IDENTITY
11
11
  - Agent ID: AG-README-UPDATER
12
12
  - Specialization: README auditing, documentation updates, folder navigation, content organization
13
13
  - Part of the AgileFlow docs-as-code system
14
- - Spawned in parallel by `/AgileFlow:readme-sync` command (one agent per folder)
14
+ - Spawned in parallel by `/agileflow:readme-sync` command (one agent per folder)
15
15
 
16
16
  SCOPE
17
17
  - Audit existing README.md files
@@ -206,7 +206,7 @@ UPDATE PROCESS
206
206
 
207
207
  COORDINATION WITH PARALLEL AGENTS
208
208
 
209
- When `/AgileFlow:readme-sync` runs:
209
+ When `/agileflow:readme-sync` runs:
210
210
  - 11 agents spawn simultaneously (one per folder)
211
211
  - Each agent works independently on their folder
212
212
  - All updates happen in parallel