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
|
|
@@ -293,17 +293,17 @@ RESEARCH INTEGRATION
|
|
|
293
293
|
3. Check if similar queries already exist
|
|
294
294
|
|
|
295
295
|
**Suggest Research**:
|
|
296
|
-
- `/
|
|
297
|
-
- `/
|
|
296
|
+
- `/agileflow:context MODE=research TOPIC="Database schema normalization for [domain]"`
|
|
297
|
+
- `/agileflow:context MODE=research TOPIC="Query optimization techniques for [database type]"`
|
|
298
298
|
|
|
299
299
|
SLASH COMMANDS
|
|
300
300
|
|
|
301
|
-
- `/
|
|
302
|
-
- `/
|
|
303
|
-
- `/
|
|
304
|
-
- `/
|
|
305
|
-
- `/
|
|
306
|
-
- `/
|
|
301
|
+
- `/agileflow:context MODE=research TOPIC=...` → Research schema patterns, optimization techniques
|
|
302
|
+
- `/agileflow:ai-code-review` → Review migration and query changes
|
|
303
|
+
- `/agileflow:adr-new` → Document major schema decisions
|
|
304
|
+
- `/agileflow:tech-debt` → Document performance debt (slow queries, missing indexes)
|
|
305
|
+
- `/agileflow:impact-analysis` → Analyze impact of schema changes on other tables
|
|
306
|
+
- `/agileflow:status STORY=... STATUS=...` → Update status
|
|
307
307
|
|
|
308
308
|
WORKFLOW
|
|
309
309
|
|
|
@@ -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
|
|
@@ -474,10 +474,10 @@ COORDINATION WITH OTHER AGENTS
|
|
|
474
474
|
|
|
475
475
|
SLASH COMMANDS
|
|
476
476
|
|
|
477
|
-
- `/
|
|
478
|
-
- `/
|
|
479
|
-
- `/
|
|
480
|
-
- `/
|
|
477
|
+
- `/agileflow:context MODE=research TOPIC=...` → Research migration best practices
|
|
478
|
+
- `/agileflow:ai-code-review` → Review migration code for safety
|
|
479
|
+
- `/agileflow:adr-new` → Document migration decisions
|
|
480
|
+
- `/agileflow:status STORY=... STATUS=...` → Update status
|
|
481
481
|
|
|
482
482
|
WORKFLOW
|
|
483
483
|
|
|
@@ -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
|
|
@@ -324,10 +324,10 @@ COORDINATION WITH OTHER AGENTS
|
|
|
324
324
|
|
|
325
325
|
SLASH COMMANDS
|
|
326
326
|
|
|
327
|
-
- `/
|
|
328
|
-
- `/
|
|
329
|
-
- `/
|
|
330
|
-
- `/
|
|
327
|
+
- `/agileflow:context MODE=research TOPIC=...` → Research design system best practices
|
|
328
|
+
- `/agileflow:ai-code-review` → Review design specs for completeness
|
|
329
|
+
- `/agileflow:adr-new` → Document design decisions
|
|
330
|
+
- `/agileflow:status STORY=... STATUS=...` → Update status
|
|
331
331
|
|
|
332
332
|
WORKFLOW
|
|
333
333
|
|
|
@@ -107,17 +107,17 @@ Before starting work on ANY story:
|
|
|
107
107
|
1. **Check Session Harness**:
|
|
108
108
|
- Look for `docs/00-meta/environment.json`
|
|
109
109
|
- If exists → Session harness is active ✅
|
|
110
|
-
- If missing → Suggest `/
|
|
110
|
+
- If missing → Suggest `/agileflow:session:init` to user
|
|
111
111
|
|
|
112
112
|
2. **Test Baseline Check**:
|
|
113
113
|
- Read `test_status` from story in `docs/09-agents/status.json`
|
|
114
114
|
- If `"passing"` → Proceed with implementation ✅
|
|
115
115
|
- If `"failing"` → STOP. Cannot start new work with failing baseline ⚠️
|
|
116
|
-
- If `"not_run"` → Run `/
|
|
116
|
+
- If `"not_run"` → Run `/agileflow:verify` first to establish baseline
|
|
117
117
|
- If `"skipped"` → Check why tests are skipped, document override decision
|
|
118
118
|
|
|
119
119
|
3. **Environment Verification** (if session harness active):
|
|
120
|
-
- Run `/
|
|
120
|
+
- Run `/agileflow:session:resume` to verify environment and load context
|
|
121
121
|
- Check for regressions (tests were passing, now failing)
|
|
122
122
|
- If regression detected → Fix before proceeding with new story
|
|
123
123
|
|
|
@@ -126,7 +126,7 @@ Before starting work on ANY story:
|
|
|
126
126
|
1. **Incremental Testing**:
|
|
127
127
|
- Run tests frequently during development (not just at end)
|
|
128
128
|
- Fix test failures immediately (don't accumulate debt)
|
|
129
|
-
- Use `/
|
|
129
|
+
- Use `/agileflow:verify US-XXXX` to check specific story tests
|
|
130
130
|
|
|
131
131
|
2. **Real-time Status Updates**:
|
|
132
132
|
- Update `test_status` in status.json as tests are written/fixed
|
|
@@ -137,12 +137,12 @@ Before starting work on ANY story:
|
|
|
137
137
|
After completing ANY changes:
|
|
138
138
|
|
|
139
139
|
1. **Run Full Test Suite**:
|
|
140
|
-
- Execute `/
|
|
140
|
+
- Execute `/agileflow:verify US-XXXX` to run tests for the story
|
|
141
141
|
- Check exit code (0 = success required for completion)
|
|
142
142
|
- Review test output for warnings or flaky tests
|
|
143
143
|
|
|
144
144
|
2. **Update Test Status**:
|
|
145
|
-
- `/
|
|
145
|
+
- `/agileflow:verify` automatically updates `test_status` in status.json
|
|
146
146
|
- Verify the update was successful
|
|
147
147
|
- Expected: `test_status: "passing"` with test results metadata
|
|
148
148
|
|
|
@@ -178,7 +178,7 @@ If tests are failing but you need to proceed:
|
|
|
178
178
|
After completing major milestones (epic complete, sprint end):
|
|
179
179
|
|
|
180
180
|
1. **Establish Baseline**:
|
|
181
|
-
- Suggest `/
|
|
181
|
+
- Suggest `/agileflow:baseline "Epic EP-XXXX complete"` to user
|
|
182
182
|
- Requires: All tests passing, git working tree clean
|
|
183
183
|
- Creates git tag + metadata for reset point
|
|
184
184
|
|
|
@@ -198,18 +198,18 @@ The verification protocol integrates into the standard workflow:
|
|
|
198
198
|
|
|
199
199
|
**ERROR HANDLING**
|
|
200
200
|
|
|
201
|
-
If `/
|
|
201
|
+
If `/agileflow:verify` fails:
|
|
202
202
|
- Read error output carefully
|
|
203
203
|
- Check if test command is configured in `docs/00-meta/environment.json`
|
|
204
204
|
- Verify test dependencies are installed
|
|
205
|
-
- If project has no tests → Suggest `/
|
|
205
|
+
- If project has no tests → Suggest `/agileflow:session:init` to set up testing
|
|
206
206
|
- If tests are misconfigured → Coordinate with AG-CI
|
|
207
207
|
|
|
208
208
|
**SESSION RESUME PROTOCOL**
|
|
209
209
|
|
|
210
210
|
When resuming work after context loss:
|
|
211
211
|
|
|
212
|
-
1. **Run Resume Command**: `/
|
|
212
|
+
1. **Run Resume Command**: `/agileflow:session:resume` loads context automatically
|
|
213
213
|
2. **Check Session State**: Review `docs/09-agents/session-state.json`
|
|
214
214
|
3. **Verify Test Status**: Ensure no regressions occurred
|
|
215
215
|
4. **Load Previous Insights**: Check Dev Agent Record from previous stories
|
|
@@ -227,26 +227,26 @@ SLASH COMMANDS (Proactive Use)
|
|
|
227
227
|
AG-DEVOPS can directly invoke AgileFlow commands to streamline workflows:
|
|
228
228
|
|
|
229
229
|
**Core Capabilities** (align with commands):
|
|
230
|
-
- `/
|
|
231
|
-
- `/
|
|
232
|
-
- `/
|
|
233
|
-
- `/
|
|
234
|
-
- `/
|
|
235
|
-
- `/
|
|
236
|
-
- `/
|
|
237
|
-
- `/
|
|
238
|
-
- `/
|
|
239
|
-
- `/
|
|
240
|
-
- `/
|
|
241
|
-
- `/
|
|
230
|
+
- `/agileflow:packages ACTION=update` → Scan and update dependencies
|
|
231
|
+
- `/agileflow:packages ACTION=dashboard` → Generate dependency health report
|
|
232
|
+
- `/agileflow:setup-deployment` → Configure deployment pipelines
|
|
233
|
+
- `/agileflow:setup-tests` → Bootstrap test infrastructure
|
|
234
|
+
- `/agileflow:ai-code-review` → Automated code review
|
|
235
|
+
- `/agileflow:impact-analysis` → Analyze change impact
|
|
236
|
+
- `/agileflow:tech-debt` → Scan and track technical debt
|
|
237
|
+
- `/agileflow:docs-sync` → Keep docs in sync with code
|
|
238
|
+
- `/agileflow:generate-changelog` → Auto-generate changelog
|
|
239
|
+
- `/agileflow:stakeholder-update` → Create executive summary
|
|
240
|
+
- `/agileflow:custom-template` → Manage document templates
|
|
241
|
+
- `/agileflow:agent-feedback` → Collect retrospective feedback
|
|
242
242
|
|
|
243
243
|
**Research & Documentation**:
|
|
244
|
-
- `/
|
|
245
|
-
- `/
|
|
244
|
+
- `/agileflow:context MODE=research TOPIC=...` → Research DevOps tools, deployment strategies
|
|
245
|
+
- `/agileflow:adr-new` → Document infrastructure/deployment decisions
|
|
246
246
|
|
|
247
247
|
**Coordination**:
|
|
248
|
-
- `/
|
|
249
|
-
- `/
|
|
248
|
+
- `/agileflow:board` → Visualize story status after updates
|
|
249
|
+
- `/agileflow:velocity` → Check metrics and trends
|
|
250
250
|
|
|
251
251
|
AGENT COORDINATION
|
|
252
252
|
|
|
@@ -277,7 +277,7 @@ RESEARCH INTEGRATION
|
|
|
277
277
|
**Before Starting Implementation**:
|
|
278
278
|
1. Check docs/10-research/ for relevant DevOps/deployment research
|
|
279
279
|
2. Search for topics: CI/CD platforms, deployment strategies, monitoring tools
|
|
280
|
-
3. If no research exists or research is stale (>90 days), suggest: `/
|
|
280
|
+
3. If no research exists or research is stale (>90 days), suggest: `/agileflow:context MODE=research TOPIC=...`
|
|
281
281
|
|
|
282
282
|
**After User Provides Research**:
|
|
283
283
|
- Offer to save to docs/10-research/<YYYYMMDD>-<slug>.md
|
|
@@ -310,13 +310,13 @@ WORKFLOW
|
|
|
310
310
|
9. Complete implementation and verify
|
|
311
311
|
10. Update status.json: status → in-review
|
|
312
312
|
11. Append bus message: `{"ts":"<ISO>","from":"AG-DEVOPS","type":"status","story":"<US_ID>","text":"DevOps setup complete, ready for review"}`
|
|
313
|
-
12. Use `/
|
|
313
|
+
12. Use `/agileflow:pr-template` command to generate PR description
|
|
314
314
|
13. After merge: update status.json: status → done
|
|
315
315
|
|
|
316
316
|
CORE CAPABILITIES
|
|
317
317
|
|
|
318
318
|
### 1. Dependency Management
|
|
319
|
-
Commands: /
|
|
319
|
+
Commands: /agileflow:packages ACTION=update, /agileflow:packages ACTION=dashboard
|
|
320
320
|
|
|
321
321
|
**Capabilities**:
|
|
322
322
|
- Scan dependencies across all package managers
|
|
@@ -333,7 +333,7 @@ Commands: /AgileFlow:packages ACTION=update, /AgileFlow:packages ACTION=dashboar
|
|
|
333
333
|
- No deprecated dependencies in production
|
|
334
334
|
|
|
335
335
|
### 2. Deployment Automation
|
|
336
|
-
Commands: /
|
|
336
|
+
Commands: /agileflow:setup-deployment
|
|
337
337
|
|
|
338
338
|
**Capabilities**:
|
|
339
339
|
- Detect project type and recommend deployment platform
|
|
@@ -350,7 +350,7 @@ Commands: /AgileFlow:setup-deployment
|
|
|
350
350
|
- Rollback procedures documented and tested
|
|
351
351
|
|
|
352
352
|
### 3. Testing Infrastructure
|
|
353
|
-
Commands: /setup-tests, /
|
|
353
|
+
Commands: /setup-tests, /agileflow:impact-analysis
|
|
354
354
|
|
|
355
355
|
**Capabilities**:
|
|
356
356
|
- Bootstrap testing frameworks for any project type
|
|
@@ -367,7 +367,7 @@ Commands: /setup-tests, /AgileFlow:impact-analysis
|
|
|
367
367
|
- Zero flaky tests in main branch
|
|
368
368
|
|
|
369
369
|
### 4. Code Quality & Review
|
|
370
|
-
Commands: /
|
|
370
|
+
Commands: /agileflow:ai-code-review
|
|
371
371
|
|
|
372
372
|
**Capabilities**:
|
|
373
373
|
- Automated code review based on best practices
|
|
@@ -384,7 +384,7 @@ Commands: /AgileFlow:ai-code-review
|
|
|
384
384
|
- Code duplication <5%
|
|
385
385
|
|
|
386
386
|
### 5. Technical Debt Management
|
|
387
|
-
Commands: /
|
|
387
|
+
Commands: /agileflow:tech-debt
|
|
388
388
|
|
|
389
389
|
**Capabilities**:
|
|
390
390
|
- Scan codebase for technical debt indicators
|
|
@@ -400,7 +400,7 @@ Commands: /AgileFlow:tech-debt
|
|
|
400
400
|
- 10-20% of sprint capacity reserved for debt reduction
|
|
401
401
|
|
|
402
402
|
### 6. Documentation Synchronization
|
|
403
|
-
Commands: /
|
|
403
|
+
Commands: /agileflow:docs-sync
|
|
404
404
|
|
|
405
405
|
**Capabilities**:
|
|
406
406
|
- Detect code changes requiring doc updates
|
|
@@ -416,7 +416,7 @@ Commands: /AgileFlow:docs-sync
|
|
|
416
416
|
- README always up-to-date
|
|
417
417
|
|
|
418
418
|
### 7. Changelog Management
|
|
419
|
-
Commands: /
|
|
419
|
+
Commands: /agileflow:generate-changelog
|
|
420
420
|
|
|
421
421
|
**Capabilities**:
|
|
422
422
|
- Parse commits and PRs since last release
|
|
@@ -433,7 +433,7 @@ Commands: /AgileFlow:generate-changelog
|
|
|
433
433
|
- Follows semantic versioning
|
|
434
434
|
|
|
435
435
|
### 8. Stakeholder Communication
|
|
436
|
-
Commands: /
|
|
436
|
+
Commands: /agileflow:stakeholder-update
|
|
437
437
|
|
|
438
438
|
**Capabilities**:
|
|
439
439
|
- Aggregate project status from all sources
|
|
@@ -450,7 +450,7 @@ Commands: /AgileFlow:stakeholder-update
|
|
|
450
450
|
- Tone appropriate for audience
|
|
451
451
|
|
|
452
452
|
### 9. Template Management
|
|
453
|
-
Commands: /
|
|
453
|
+
Commands: /agileflow:custom-template
|
|
454
454
|
|
|
455
455
|
**Capabilities**:
|
|
456
456
|
- Create custom document templates
|
|
@@ -465,7 +465,7 @@ Commands: /AgileFlow:custom-template
|
|
|
465
465
|
- Templates versioned with code
|
|
466
466
|
|
|
467
467
|
### 10. Agent Feedback & Retrospectives
|
|
468
|
-
Commands: /
|
|
468
|
+
Commands: /agileflow:agent-feedback
|
|
469
469
|
|
|
470
470
|
**Capabilities**:
|
|
471
471
|
- Collect feedback on stories, epics, sprints
|
|
@@ -153,10 +153,10 @@ COORDINATION WITH OTHER AGENTS
|
|
|
153
153
|
|
|
154
154
|
SLASH COMMANDS
|
|
155
155
|
|
|
156
|
-
- `/
|
|
157
|
-
- `/
|
|
158
|
-
- `/
|
|
159
|
-
- `/
|
|
156
|
+
- `/agileflow:context MODE=research TOPIC=...` → Research documentation best practices
|
|
157
|
+
- `/agileflow:ai-code-review` → Review documentation for clarity and completeness
|
|
158
|
+
- `/agileflow:adr-new` → Document documentation decisions
|
|
159
|
+
- `/agileflow:status STORY=... STATUS=...` → Update status
|
|
160
160
|
|
|
161
161
|
WORKFLOW
|
|
162
162
|
|
|
@@ -68,14 +68,14 @@ SLASH COMMANDS (Proactive Use)
|
|
|
68
68
|
EPIC-PLANNER can directly invoke AgileFlow commands:
|
|
69
69
|
|
|
70
70
|
**Research**:
|
|
71
|
-
- `/
|
|
71
|
+
- `/agileflow:context MODE=research TOPIC=...` → Research unfamiliar technologies before planning
|
|
72
72
|
|
|
73
73
|
**Documentation**:
|
|
74
|
-
- `/
|
|
74
|
+
- `/agileflow:adr-new` → Create ADR if epic involves architectural decision
|
|
75
75
|
|
|
76
76
|
**Coordination**:
|
|
77
|
-
- `/
|
|
78
|
-
- `/
|
|
77
|
+
- `/agileflow:board` → Visualize story distribution after planning
|
|
78
|
+
- `/agileflow:velocity` → Check team capacity before estimating
|
|
79
79
|
|
|
80
80
|
AGENT ASSIGNMENT GUIDE
|
|
81
81
|
|
|
@@ -94,7 +94,7 @@ RESEARCH INTEGRATION
|
|
|
94
94
|
|
|
95
95
|
**Before Planning**:
|
|
96
96
|
1. Check docs/10-research/ for relevant research on the feature
|
|
97
|
-
2. If technology is unfamiliar, invoke `/
|
|
97
|
+
2. If technology is unfamiliar, invoke `/agileflow:context MODE=research TOPIC=...`
|
|
98
98
|
3. Check docs/03-decisions/ for architectural constraints
|
|
99
99
|
4. Check docs/08-project/roadmap.md for priority context
|
|
100
100
|
|
|
@@ -164,7 +164,7 @@ Tests: `src/models/__tests__/user.test.ts` [Source: architecture/testing-strateg
|
|
|
164
164
|
WORKFLOW
|
|
165
165
|
1. **[KNOWLEDGE LOADING]** Before planning:
|
|
166
166
|
- Read CLAUDE.md for project architecture and conventions
|
|
167
|
-
- Check docs/10-research/ for relevant research (or invoke `/
|
|
167
|
+
- Check docs/10-research/ for relevant research (or invoke `/agileflow:context MODE=research`)
|
|
168
168
|
- Check docs/03-decisions/ for relevant ADRs and constraints
|
|
169
169
|
- Check docs/08-project/roadmap.md for priorities
|
|
170
170
|
- Review docs/09-agents/status.json for current team capacity
|
|
@@ -280,7 +280,7 @@ This updates your expertise with what you learned, so you're faster next time.
|
|
|
280
280
|
**After User Describes Feature**:
|
|
281
281
|
1. Clarify scope and constraints
|
|
282
282
|
2. Check docs/03-decisions/ for relevant ADRs (architectural constraints)
|
|
283
|
-
3. Check docs/10-research/ for relevant research (or suggest `/
|
|
283
|
+
3. Check docs/10-research/ for relevant research (or suggest `/agileflow:context MODE=research`)
|
|
284
284
|
4. Propose epic structure:
|
|
285
285
|
- Epic goal + success metrics
|
|
286
286
|
- 3-8 stories with clear AC, estimates, owners, dependencies
|