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.
- package/README.md +64 -64
- package/package.json +1 -1
- package/src/core/agents/accessibility.md +14 -14
- package/src/core/agents/adr-writer.md +5 -5
- package/src/core/agents/analytics.md +14 -14
- package/src/core/agents/api.md +22 -22
- package/src/core/agents/ci.md +20 -20
- package/src/core/agents/compliance.md +14 -14
- package/src/core/agents/configuration/archival.md +1 -1
- package/src/core/agents/configuration/ci.md +3 -3
- package/src/core/agents/configuration/hooks.md +1 -1
- package/src/core/agents/configuration/status-line.md +420 -0
- package/src/core/agents/database.md +18 -18
- package/src/core/agents/datamigration.md +14 -14
- package/src/core/agents/design.md +14 -14
- package/src/core/agents/devops.md +38 -38
- package/src/core/agents/documentation.md +4 -4
- package/src/core/agents/epic-planner.md +7 -7
- package/src/core/agents/integrations.md +17 -17
- package/src/core/agents/mentor.md +33 -33
- package/src/core/agents/mobile.md +15 -15
- package/src/core/agents/monitoring.md +14 -14
- package/src/core/agents/performance.md +16 -16
- package/src/core/agents/product.md +6 -6
- package/src/core/agents/qa.md +14 -14
- package/src/core/agents/readme-updater.md +2 -2
- package/src/core/agents/refactor.md +16 -16
- package/src/core/agents/security.md +20 -20
- package/src/core/agents/testing.md +16 -16
- package/src/core/agents/ui.md +23 -23
- package/src/core/commands/adr.md +5 -4
- package/src/core/commands/agent.md +1 -0
- package/src/core/commands/auto.md +1 -1
- package/src/core/commands/babysit.md +141 -70
- package/src/core/commands/baseline.md +34 -16
- package/src/core/commands/blockers.md +7 -7
- package/src/core/commands/board.md +1 -1
- package/src/core/commands/changelog.md +15 -9
- package/src/core/commands/compress.md +23 -5
- package/src/core/commands/configure.md +44 -9
- package/src/core/commands/context.md +6 -6
- package/src/core/commands/debt.md +1 -1
- package/src/core/commands/deps.md +10 -10
- package/src/core/commands/diagnose.md +11 -1
- package/src/core/commands/docs.md +2 -1
- package/src/core/commands/handoff.md +1 -0
- package/src/core/commands/help.md +9 -0
- package/src/core/commands/impact.md +2 -1
- package/src/core/commands/metrics.md +12 -12
- package/src/core/commands/multi-expert.md +1 -1
- package/src/core/commands/packages.md +12 -12
- package/src/core/commands/pr.md +1 -0
- package/src/core/commands/readme-sync.md +59 -87
- package/src/core/commands/retro.md +12 -12
- package/src/core/commands/review.md +2 -1
- package/src/core/commands/session/end.md +8 -8
- package/src/core/commands/session/history.md +13 -13
- package/src/core/commands/session/init.md +16 -16
- package/src/core/commands/session/resume.md +17 -17
- package/src/core/commands/session/status.md +14 -14
- package/src/core/commands/sprint.md +5 -5
- package/src/core/commands/story-validate.md +4 -3
- package/src/core/commands/story.md +1 -0
- package/src/core/commands/template.md +3 -3
- package/src/core/commands/tests.md +15 -0
- package/src/core/commands/update.md +1 -1
- package/src/core/commands/velocity.md +2 -2
- package/src/core/commands/verify.md +27 -9
- package/src/core/skills/agileflow-tech-debt/SKILL.md +2 -2
- package/src/core/templates/README-template.md +1 -1
- package/src/core/templates/agent-profile-template.md +1 -1
- package/src/core/templates/agileflow-statusline.sh +161 -0
- package/src/core/templates/claude-settings.advanced.example.json +2 -2
- package/src/core/templates/claude-settings.example.json +1 -1
- package/src/core/templates/resume-session.sh +2 -2
- package/src/core/templates/worktrees-guide.md +11 -11
- package/tools/cli/commands/config.js +1 -1
- package/tools/cli/commands/doctor.js +1 -1
- package/tools/cli/commands/status.js +1 -1
- package/tools/cli/commands/uninstall.js +1 -1
- package/tools/cli/installers/ide/claude-code.js +1 -1
- package/tools/cli/installers/ide/cursor.js +2 -2
- package/tools/cli/lib/content-injector.js +1 -1
- package/tools/cli/lib/docs-setup.js +22 -32
- 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 `/
|
|
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 `/
|
|
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 `/
|
|
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 `/
|
|
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 `/
|
|
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
|
-
- `/
|
|
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 `/
|
|
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 `/
|
|
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 `/
|
|
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**: `/
|
|
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
|
-
- `/
|
|
352
|
-
- `/
|
|
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
|
-
- `/
|
|
371
|
-
- `/
|
|
372
|
-
- `/
|
|
373
|
-
- `/
|
|
374
|
-
- `/
|
|
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 `/
|
|
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 /
|
|
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 /
|
|
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("/
|
|
159
|
-
- With parameters: `SlashCommand("/
|
|
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
|
-
- `/
|
|
165
|
-
- `/
|
|
166
|
-
- `/
|
|
167
|
-
- `/
|
|
168
|
-
- `/
|
|
169
|
-
- `/
|
|
170
|
-
- `/
|
|
171
|
-
- `/
|
|
172
|
-
- `/
|
|
173
|
-
- `/
|
|
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("/
|
|
181
|
-
2. Break into stories → SlashCommand("/
|
|
182
|
-
3. Research approach → SlashCommand("/
|
|
183
|
-
4. Check dependencies → SlashCommand("/
|
|
184
|
-
5. Analyze impact → SlashCommand("/
|
|
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("/
|
|
187
|
-
8. Review code → SlashCommand("/
|
|
188
|
-
9. Document decision → SlashCommand("/
|
|
189
|
-
10. Show progress → SlashCommand("/
|
|
190
|
-
11. Generate docs → SlashCommand("/
|
|
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("/
|
|
197
|
-
- After implementation: Chain SlashCommand("/
|
|
198
|
-
- Before refactoring: Invoke SlashCommand("/
|
|
199
|
-
- After epic completion: Invoke SlashCommand("/
|
|
200
|
-
- When discovering architectural decisions: Invoke SlashCommand("/
|
|
201
|
-
- When hitting unknowns: Invoke SlashCommand("/
|
|
202
|
-
- When seeing outdated dependencies: Invoke SlashCommand("/
|
|
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 /
|
|
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 `/
|
|
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 `/
|
|
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 `/
|
|
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 `/
|
|
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 `/
|
|
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
|
-
- `/
|
|
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 `/
|
|
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 `/
|
|
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 `/
|
|
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**: `/
|
|
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
|
-
- `/
|
|
306
|
-
- `/
|
|
307
|
-
- `/
|
|
308
|
-
- `/
|
|
309
|
-
- `/
|
|
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 `/
|
|
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 `/
|
|
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 `/
|
|
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 `/
|
|
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 `/
|
|
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
|
-
- `/
|
|
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 `/
|
|
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 `/
|
|
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 `/
|
|
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**: `/
|
|
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
|
-
- `/
|
|
346
|
-
- `/
|
|
347
|
-
- `/
|
|
348
|
-
- `/
|
|
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 `/
|
|
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 `/
|
|
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 `/
|
|
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 `/
|
|
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 `/
|
|
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
|
-
- `/
|
|
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 `/
|
|
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 `/
|
|
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 `/
|
|
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**: `/
|
|
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
|
-
- `/
|
|
305
|
-
- `/
|
|
306
|
-
- `/
|
|
307
|
-
- `/
|
|
308
|
-
- `/
|
|
309
|
-
- `/
|
|
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
|
-
- `/
|
|
216
|
-
- `/
|
|
217
|
-
- `/
|
|
218
|
-
- `/
|
|
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
|
-
- `/
|
|
230
|
-
- `/
|
|
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
|
|
package/src/core/agents/qa.md
CHANGED
|
@@ -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 `/
|
|
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 `/
|
|
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 `/
|
|
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 `/
|
|
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 `/
|
|
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
|
-
- `/
|
|
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 `/
|
|
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 `/
|
|
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 `/
|
|
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**: `/
|
|
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
|
-
- `/
|
|
561
|
-
- `/
|
|
562
|
-
- `/
|
|
563
|
-
- `/
|
|
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 `/
|
|
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 `/
|
|
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
|