agileflow 2.94.0 → 2.94.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +5 -0
- package/README.md +6 -6
- package/package.json +1 -1
- package/scripts/claude-tmux.sh +76 -3
- package/scripts/session-manager.js +24 -1
- package/src/core/agents/council-advocate.md +202 -0
- package/src/core/agents/council-analyst.md +248 -0
- package/src/core/agents/council-optimist.md +166 -0
- package/src/core/commands/council.md +517 -0
- package/src/core/commands/help.md +189 -3
- package/src/core/commands/ideate.md +145 -20
- package/src/core/commands/session/end.md +74 -0
- package/src/core/council/sessions/.gitkeep +0 -0
- package/src/core/council/shared_reasoning.template.md +106 -0
|
@@ -8,7 +8,69 @@ compact_context:
|
|
|
8
8
|
- "ACTIVE COMMAND: /agileflow:help - System guide (display-only, no file writes)"
|
|
9
9
|
- "MUST output markdown (never writes files)"
|
|
10
10
|
- "MUST show folder map, concepts, daily workflow, all commands"
|
|
11
|
-
- "Include dynamic injection:
|
|
11
|
+
- "Include dynamic injection: Available commands (61 total):
|
|
12
|
+
- `/agileflow:adr NUMBER=<number> TITLE=<text> CONTEXT=<text> DECISION=<text> CONSEQUENCES=<text> \[LINKS=<text>\]` - Create an Architecture Decision Record
|
|
13
|
+
- `/agileflow:adr-list` - List all Architecture Decision Records
|
|
14
|
+
- `/agileflow:adr-update NUMBER=<number> \[STATUS=<status>\] \[REASON=<text>\]` - Update ADR status or content
|
|
15
|
+
- `/agileflow:adr-view NUMBER=<number>` - View ADR details with contextual actions
|
|
16
|
+
- `/agileflow:agent AGENT\_ID=<id> ROLE=<text> \[TOOLS=<list>\] \[SCOPE=<list>\]` - Onboard a new agent with profile and contract
|
|
17
|
+
- `/agileflow:assign STORY=<US\-ID> NEW\_OWNER=<id> \[NEW\_STATUS=<status>\] \[NOTE=<text>\]` - Assign or reassign a story to an owner
|
|
18
|
+
- `/agileflow:audit STORY=<US\-ID>` - Audit story completion \- tests \+ acceptance criteria verification \(GSD pattern\)
|
|
19
|
+
- `/agileflow:auto SOURCE=<path\|url> \[EPIC=<EP\-ID>\] \[OWNER=<id>\] \[AUTO\_CREATE=true\|false\]` - Auto\-generate stories from PRDs, mockups, or specs
|
|
20
|
+
- `/agileflow:baseline` - Mark current state as verified baseline
|
|
21
|
+
- `/agileflow:batch <operation> <pattern> \[<action>\]` - Process multiple items with functional patterns \(map/pmap/filter/reduce\)
|
|
22
|
+
- `/agileflow:changelog \(no arguments\)` - Auto\-generate changelog from commit history
|
|
23
|
+
- `/agileflow:choose <decision> \[<context>\]` - AI\-directed decision making with structured options
|
|
24
|
+
- `/agileflow:ci \(no arguments\)` - Bootstrap CI/CD workflow with testing and quality checks
|
|
25
|
+
- `/agileflow:council <question> \[--mode parallel\|debate\] \[--rounds N\]` - Convene AI Council for strategic decisions with three perspectives \(Optimist, Advocate, Analyst\)
|
|
26
|
+
- `/agileflow:compress \(no arguments\)` - Compress status\.json by removing verbose fields and keeping only tracking metadata
|
|
27
|
+
- `/agileflow:context-export \(no arguments\)` - Export concise context excerpt for web AI tools
|
|
28
|
+
- `/agileflow:context-full \(no arguments\)` - Generate/refresh full context brief for web AI tools
|
|
29
|
+
- `/agileflow:context-note NOTE=<text>` - Add timestamped note to context file
|
|
30
|
+
- `/agileflow:debt \(no arguments\)` - Track and prioritize technical debt items
|
|
31
|
+
- `/agileflow:deploy \(no arguments\)` - Set up automated deployment pipeline
|
|
32
|
+
- `/agileflow:diagnose \(no arguments\)` - System health diagnostics
|
|
33
|
+
- `/agileflow:epic EPIC=<EP\-ID> TITLE=<text> OWNER=<id> GOAL=<text> \[STORIES=<list>\] \[RESEARCH=<file>\]` - Create a new epic with stories
|
|
34
|
+
- `/agileflow:epic-list` - List all epics with status and progress
|
|
35
|
+
- `/agileflow:epic-view EPIC=<EP\-ID>` - View epic details with stories and contextual actions
|
|
36
|
+
- `/agileflow:feedback \(no arguments\)` - Collect and process agent feedback
|
|
37
|
+
- `/agileflow:handoff STORY=<US\-ID> FROM=<id> TO=<id> \[SUMMARY=<text>\] \[BLOCKERS=<list>\]` - Document work handoff between agents
|
|
38
|
+
- `/agileflow:help \(no arguments\)` - Display AgileFlow system overview and commands
|
|
39
|
+
- `/agileflow:multi-expert <question>` - Deploy multiple domain experts on the same problem for higher confidence
|
|
40
|
+
- `/agileflow:packages \(no arguments\)` - Manage dependencies with updates and security audits
|
|
41
|
+
- `/agileflow:pr STORY=<US\-ID> \[TITLE=<text>\] \[TEST\_EVIDENCE=<text>\]` - Generate pull request description from story
|
|
42
|
+
- `/agileflow:readme-sync FOLDER=<path>\|all` - Synchronize a folder's README\.md with its current contents
|
|
43
|
+
- `/agileflow:research-analyze` - Analyze existing research for implementation in your project
|
|
44
|
+
- `/agileflow:research-ask TOPIC=<text> \[DETAILS=<text>\] \[ERROR=<text>\]` - Generate detailed research prompt for web AI tools \(ChatGPT, Perplexity, etc\.\)
|
|
45
|
+
- `/agileflow:research-import TOPIC=<text> \[CONTENT=<text>\] \[SOURCE=<url>\]` - Import research results and save to research folder
|
|
46
|
+
- `/agileflow:research-list \(no arguments\)` - Show research notes index
|
|
47
|
+
- `/agileflow:research-view FILE=<filename>` - Read a specific research note
|
|
48
|
+
- `/agileflow:rlm DOCUMENT=<path> QUERY=<text> \[MAX\_ITERATIONS=<number>\] \[DEPTH=<number>\]` - Analyze complex documents using RLM \(Recursive Language Models\) pattern
|
|
49
|
+
- `/agileflow:session-cleanup \(no arguments\)` - Interactive session cleanup with AI assessment
|
|
50
|
+
- `/agileflow:session-end \(no arguments\)` - Cleanly end session with optional merge to main
|
|
51
|
+
- `/agileflow:session-history` - View past session history and metrics
|
|
52
|
+
- `/agileflow:session-init \(no arguments\)` - Initialize session harness with test verification
|
|
53
|
+
- `/agileflow:session-new \(no arguments\)` - Create a new parallel session with git worktree
|
|
54
|
+
- `/agileflow:session-resume \(no arguments\)` - Pick a session to switch to or resume
|
|
55
|
+
- `/agileflow:session-spawn` - Spawn multiple parallel Claude Code sessions in git worktrees
|
|
56
|
+
- `/agileflow:session-status` - View current session state and activity
|
|
57
|
+
- `/agileflow:skill-create` - Generate a custom skill with web research, cookbook pattern, and MCP integration
|
|
58
|
+
- `/agileflow:skill-delete` - Remove an installed skill from \.claude/skills/
|
|
59
|
+
- `/agileflow:skill-edit` - Edit an existing skill's SKILL\.md, cookbook entries, or references
|
|
60
|
+
- `/agileflow:skill-list \(no arguments\)` - List all installed skills with their descriptions and status
|
|
61
|
+
- `/agileflow:skill-test` - Verify a skill works correctly by testing its activation and functionality
|
|
62
|
+
- `/agileflow:skill-upgrade` - Upgrade existing skills with self\-improving learning capability
|
|
63
|
+
- `/agileflow:status STORY=<US\-ID> STATUS=<status> \[SUMMARY=<text>\] \[PR=<url>\] \[TO=<agent\-id>\]` - Update story status and progress
|
|
64
|
+
- `/agileflow:story EPIC=<EP\-ID> STORY=<US\-ID> TITLE=<text> OWNER=<id> \[ESTIMATE=<pts>\] \[AC=<list>\] \[TDD=true\]` - Create a user story with acceptance criteria
|
|
65
|
+
- `/agileflow:story-validate STORY=<US\-ID>` - Validate story completeness before development
|
|
66
|
+
- `/agileflow:story-view STORY=<US\-ID>` - View story details with contextual actions
|
|
67
|
+
- `/agileflow:template ACTION=create\|edit\|list\|use \[TYPE=story\|epic\|adr\|custom\] \[NAME=<name>\]` - Create and manage custom document templates
|
|
68
|
+
- `/agileflow:tests \(no arguments\)` - Set up automated testing infrastructure
|
|
69
|
+
- `/agileflow:validate-expertise` - Validate expertise files for drift and staleness
|
|
70
|
+
- `/agileflow:verify` - Run project tests and update story test status
|
|
71
|
+
- `/agileflow:whats-new \(no arguments\)` - Show what's new in AgileFlow
|
|
72
|
+
- `/agileflow:workflow <template> \[<arguments>\]` - Define and run parameterized workflow templates
|
|
73
|
+
"
|
|
12
74
|
state_fields:
|
|
13
75
|
- display_mode
|
|
14
76
|
---
|
|
@@ -61,7 +123,69 @@ Output includes:
|
|
|
61
123
|
- Daily flow: Pick story → Implement to AC → Tests → PR → Update status
|
|
62
124
|
- WIP limit: max 2 stories/agent
|
|
63
125
|
- All available commands with examples
|
|
64
|
-
- Dynamic injection:
|
|
126
|
+
- Dynamic injection: Available commands (61 total):
|
|
127
|
+
- `/agileflow:adr NUMBER=<number> TITLE=<text> CONTEXT=<text> DECISION=<text> CONSEQUENCES=<text> \[LINKS=<text>\]` - Create an Architecture Decision Record
|
|
128
|
+
- `/agileflow:adr-list` - List all Architecture Decision Records
|
|
129
|
+
- `/agileflow:adr-update NUMBER=<number> \[STATUS=<status>\] \[REASON=<text>\]` - Update ADR status or content
|
|
130
|
+
- `/agileflow:adr-view NUMBER=<number>` - View ADR details with contextual actions
|
|
131
|
+
- `/agileflow:agent AGENT\_ID=<id> ROLE=<text> \[TOOLS=<list>\] \[SCOPE=<list>\]` - Onboard a new agent with profile and contract
|
|
132
|
+
- `/agileflow:assign STORY=<US\-ID> NEW\_OWNER=<id> \[NEW\_STATUS=<status>\] \[NOTE=<text>\]` - Assign or reassign a story to an owner
|
|
133
|
+
- `/agileflow:audit STORY=<US\-ID>` - Audit story completion \- tests \+ acceptance criteria verification \(GSD pattern\)
|
|
134
|
+
- `/agileflow:auto SOURCE=<path\|url> \[EPIC=<EP\-ID>\] \[OWNER=<id>\] \[AUTO\_CREATE=true\|false\]` - Auto\-generate stories from PRDs, mockups, or specs
|
|
135
|
+
- `/agileflow:baseline` - Mark current state as verified baseline
|
|
136
|
+
- `/agileflow:batch <operation> <pattern> \[<action>\]` - Process multiple items with functional patterns \(map/pmap/filter/reduce\)
|
|
137
|
+
- `/agileflow:changelog \(no arguments\)` - Auto\-generate changelog from commit history
|
|
138
|
+
- `/agileflow:choose <decision> \[<context>\]` - AI\-directed decision making with structured options
|
|
139
|
+
- `/agileflow:ci \(no arguments\)` - Bootstrap CI/CD workflow with testing and quality checks
|
|
140
|
+
- `/agileflow:council <question> \[--mode parallel\|debate\] \[--rounds N\]` - Convene AI Council for strategic decisions with three perspectives \(Optimist, Advocate, Analyst\)
|
|
141
|
+
- `/agileflow:compress \(no arguments\)` - Compress status\.json by removing verbose fields and keeping only tracking metadata
|
|
142
|
+
- `/agileflow:context-export \(no arguments\)` - Export concise context excerpt for web AI tools
|
|
143
|
+
- `/agileflow:context-full \(no arguments\)` - Generate/refresh full context brief for web AI tools
|
|
144
|
+
- `/agileflow:context-note NOTE=<text>` - Add timestamped note to context file
|
|
145
|
+
- `/agileflow:debt \(no arguments\)` - Track and prioritize technical debt items
|
|
146
|
+
- `/agileflow:deploy \(no arguments\)` - Set up automated deployment pipeline
|
|
147
|
+
- `/agileflow:diagnose \(no arguments\)` - System health diagnostics
|
|
148
|
+
- `/agileflow:epic EPIC=<EP\-ID> TITLE=<text> OWNER=<id> GOAL=<text> \[STORIES=<list>\] \[RESEARCH=<file>\]` - Create a new epic with stories
|
|
149
|
+
- `/agileflow:epic-list` - List all epics with status and progress
|
|
150
|
+
- `/agileflow:epic-view EPIC=<EP\-ID>` - View epic details with stories and contextual actions
|
|
151
|
+
- `/agileflow:feedback \(no arguments\)` - Collect and process agent feedback
|
|
152
|
+
- `/agileflow:handoff STORY=<US\-ID> FROM=<id> TO=<id> \[SUMMARY=<text>\] \[BLOCKERS=<list>\]` - Document work handoff between agents
|
|
153
|
+
- `/agileflow:help \(no arguments\)` - Display AgileFlow system overview and commands
|
|
154
|
+
- `/agileflow:multi-expert <question>` - Deploy multiple domain experts on the same problem for higher confidence
|
|
155
|
+
- `/agileflow:packages \(no arguments\)` - Manage dependencies with updates and security audits
|
|
156
|
+
- `/agileflow:pr STORY=<US\-ID> \[TITLE=<text>\] \[TEST\_EVIDENCE=<text>\]` - Generate pull request description from story
|
|
157
|
+
- `/agileflow:readme-sync FOLDER=<path>\|all` - Synchronize a folder's README\.md with its current contents
|
|
158
|
+
- `/agileflow:research-analyze` - Analyze existing research for implementation in your project
|
|
159
|
+
- `/agileflow:research-ask TOPIC=<text> \[DETAILS=<text>\] \[ERROR=<text>\]` - Generate detailed research prompt for web AI tools \(ChatGPT, Perplexity, etc\.\)
|
|
160
|
+
- `/agileflow:research-import TOPIC=<text> \[CONTENT=<text>\] \[SOURCE=<url>\]` - Import research results and save to research folder
|
|
161
|
+
- `/agileflow:research-list \(no arguments\)` - Show research notes index
|
|
162
|
+
- `/agileflow:research-view FILE=<filename>` - Read a specific research note
|
|
163
|
+
- `/agileflow:rlm DOCUMENT=<path> QUERY=<text> \[MAX\_ITERATIONS=<number>\] \[DEPTH=<number>\]` - Analyze complex documents using RLM \(Recursive Language Models\) pattern
|
|
164
|
+
- `/agileflow:session-cleanup \(no arguments\)` - Interactive session cleanup with AI assessment
|
|
165
|
+
- `/agileflow:session-end \(no arguments\)` - Cleanly end session with optional merge to main
|
|
166
|
+
- `/agileflow:session-history` - View past session history and metrics
|
|
167
|
+
- `/agileflow:session-init \(no arguments\)` - Initialize session harness with test verification
|
|
168
|
+
- `/agileflow:session-new \(no arguments\)` - Create a new parallel session with git worktree
|
|
169
|
+
- `/agileflow:session-resume \(no arguments\)` - Pick a session to switch to or resume
|
|
170
|
+
- `/agileflow:session-spawn` - Spawn multiple parallel Claude Code sessions in git worktrees
|
|
171
|
+
- `/agileflow:session-status` - View current session state and activity
|
|
172
|
+
- `/agileflow:skill-create` - Generate a custom skill with web research, cookbook pattern, and MCP integration
|
|
173
|
+
- `/agileflow:skill-delete` - Remove an installed skill from \.claude/skills/
|
|
174
|
+
- `/agileflow:skill-edit` - Edit an existing skill's SKILL\.md, cookbook entries, or references
|
|
175
|
+
- `/agileflow:skill-list \(no arguments\)` - List all installed skills with their descriptions and status
|
|
176
|
+
- `/agileflow:skill-test` - Verify a skill works correctly by testing its activation and functionality
|
|
177
|
+
- `/agileflow:skill-upgrade` - Upgrade existing skills with self\-improving learning capability
|
|
178
|
+
- `/agileflow:status STORY=<US\-ID> STATUS=<status> \[SUMMARY=<text>\] \[PR=<url>\] \[TO=<agent\-id>\]` - Update story status and progress
|
|
179
|
+
- `/agileflow:story EPIC=<EP\-ID> STORY=<US\-ID> TITLE=<text> OWNER=<id> \[ESTIMATE=<pts>\] \[AC=<list>\] \[TDD=true\]` - Create a user story with acceptance criteria
|
|
180
|
+
- `/agileflow:story-validate STORY=<US\-ID>` - Validate story completeness before development
|
|
181
|
+
- `/agileflow:story-view STORY=<US\-ID>` - View story details with contextual actions
|
|
182
|
+
- `/agileflow:template ACTION=create\|edit\|list\|use \[TYPE=story\|epic\|adr\|custom\] \[NAME=<name>\]` - Create and manage custom document templates
|
|
183
|
+
- `/agileflow:tests \(no arguments\)` - Set up automated testing infrastructure
|
|
184
|
+
- `/agileflow:validate-expertise` - Validate expertise files for drift and staleness
|
|
185
|
+
- `/agileflow:verify` - Run project tests and update story test status
|
|
186
|
+
- `/agileflow:whats-new \(no arguments\)` - Show what's new in AgileFlow
|
|
187
|
+
- `/agileflow:workflow <template> \[<arguments>\]` - Define and run parameterized workflow templates
|
|
188
|
+
|
|
65
189
|
|
|
66
190
|
- **Related**: All AgileFlow commands, system documentation
|
|
67
191
|
<!-- COMPACT_SUMMARY_END -->
|
|
@@ -89,7 +213,69 @@ Print a concise, one-screen overview:
|
|
|
89
213
|
- WIP limit: max 2 stories/agent
|
|
90
214
|
- List ALL available commands with one-line examples
|
|
91
215
|
|
|
92
|
-
|
|
216
|
+
Available commands (61 total):
|
|
217
|
+
- `/agileflow:adr NUMBER=<number> TITLE=<text> CONTEXT=<text> DECISION=<text> CONSEQUENCES=<text> \[LINKS=<text>\]` - Create an Architecture Decision Record
|
|
218
|
+
- `/agileflow:adr-list` - List all Architecture Decision Records
|
|
219
|
+
- `/agileflow:adr-update NUMBER=<number> \[STATUS=<status>\] \[REASON=<text>\]` - Update ADR status or content
|
|
220
|
+
- `/agileflow:adr-view NUMBER=<number>` - View ADR details with contextual actions
|
|
221
|
+
- `/agileflow:agent AGENT\_ID=<id> ROLE=<text> \[TOOLS=<list>\] \[SCOPE=<list>\]` - Onboard a new agent with profile and contract
|
|
222
|
+
- `/agileflow:assign STORY=<US\-ID> NEW\_OWNER=<id> \[NEW\_STATUS=<status>\] \[NOTE=<text>\]` - Assign or reassign a story to an owner
|
|
223
|
+
- `/agileflow:audit STORY=<US\-ID>` - Audit story completion \- tests \+ acceptance criteria verification \(GSD pattern\)
|
|
224
|
+
- `/agileflow:auto SOURCE=<path\|url> \[EPIC=<EP\-ID>\] \[OWNER=<id>\] \[AUTO\_CREATE=true\|false\]` - Auto\-generate stories from PRDs, mockups, or specs
|
|
225
|
+
- `/agileflow:baseline` - Mark current state as verified baseline
|
|
226
|
+
- `/agileflow:batch <operation> <pattern> \[<action>\]` - Process multiple items with functional patterns \(map/pmap/filter/reduce\)
|
|
227
|
+
- `/agileflow:changelog \(no arguments\)` - Auto\-generate changelog from commit history
|
|
228
|
+
- `/agileflow:choose <decision> \[<context>\]` - AI\-directed decision making with structured options
|
|
229
|
+
- `/agileflow:ci \(no arguments\)` - Bootstrap CI/CD workflow with testing and quality checks
|
|
230
|
+
- `/agileflow:council <question> \[--mode parallel\|debate\] \[--rounds N\]` - Convene AI Council for strategic decisions with three perspectives \(Optimist, Advocate, Analyst\)
|
|
231
|
+
- `/agileflow:compress \(no arguments\)` - Compress status\.json by removing verbose fields and keeping only tracking metadata
|
|
232
|
+
- `/agileflow:context-export \(no arguments\)` - Export concise context excerpt for web AI tools
|
|
233
|
+
- `/agileflow:context-full \(no arguments\)` - Generate/refresh full context brief for web AI tools
|
|
234
|
+
- `/agileflow:context-note NOTE=<text>` - Add timestamped note to context file
|
|
235
|
+
- `/agileflow:debt \(no arguments\)` - Track and prioritize technical debt items
|
|
236
|
+
- `/agileflow:deploy \(no arguments\)` - Set up automated deployment pipeline
|
|
237
|
+
- `/agileflow:diagnose \(no arguments\)` - System health diagnostics
|
|
238
|
+
- `/agileflow:epic EPIC=<EP\-ID> TITLE=<text> OWNER=<id> GOAL=<text> \[STORIES=<list>\] \[RESEARCH=<file>\]` - Create a new epic with stories
|
|
239
|
+
- `/agileflow:epic-list` - List all epics with status and progress
|
|
240
|
+
- `/agileflow:epic-view EPIC=<EP\-ID>` - View epic details with stories and contextual actions
|
|
241
|
+
- `/agileflow:feedback \(no arguments\)` - Collect and process agent feedback
|
|
242
|
+
- `/agileflow:handoff STORY=<US\-ID> FROM=<id> TO=<id> \[SUMMARY=<text>\] \[BLOCKERS=<list>\]` - Document work handoff between agents
|
|
243
|
+
- `/agileflow:help \(no arguments\)` - Display AgileFlow system overview and commands
|
|
244
|
+
- `/agileflow:multi-expert <question>` - Deploy multiple domain experts on the same problem for higher confidence
|
|
245
|
+
- `/agileflow:packages \(no arguments\)` - Manage dependencies with updates and security audits
|
|
246
|
+
- `/agileflow:pr STORY=<US\-ID> \[TITLE=<text>\] \[TEST\_EVIDENCE=<text>\]` - Generate pull request description from story
|
|
247
|
+
- `/agileflow:readme-sync FOLDER=<path>\|all` - Synchronize a folder's README\.md with its current contents
|
|
248
|
+
- `/agileflow:research-analyze` - Analyze existing research for implementation in your project
|
|
249
|
+
- `/agileflow:research-ask TOPIC=<text> \[DETAILS=<text>\] \[ERROR=<text>\]` - Generate detailed research prompt for web AI tools \(ChatGPT, Perplexity, etc\.\)
|
|
250
|
+
- `/agileflow:research-import TOPIC=<text> \[CONTENT=<text>\] \[SOURCE=<url>\]` - Import research results and save to research folder
|
|
251
|
+
- `/agileflow:research-list \(no arguments\)` - Show research notes index
|
|
252
|
+
- `/agileflow:research-view FILE=<filename>` - Read a specific research note
|
|
253
|
+
- `/agileflow:rlm DOCUMENT=<path> QUERY=<text> \[MAX\_ITERATIONS=<number>\] \[DEPTH=<number>\]` - Analyze complex documents using RLM \(Recursive Language Models\) pattern
|
|
254
|
+
- `/agileflow:session-cleanup \(no arguments\)` - Interactive session cleanup with AI assessment
|
|
255
|
+
- `/agileflow:session-end \(no arguments\)` - Cleanly end session with optional merge to main
|
|
256
|
+
- `/agileflow:session-history` - View past session history and metrics
|
|
257
|
+
- `/agileflow:session-init \(no arguments\)` - Initialize session harness with test verification
|
|
258
|
+
- `/agileflow:session-new \(no arguments\)` - Create a new parallel session with git worktree
|
|
259
|
+
- `/agileflow:session-resume \(no arguments\)` - Pick a session to switch to or resume
|
|
260
|
+
- `/agileflow:session-spawn` - Spawn multiple parallel Claude Code sessions in git worktrees
|
|
261
|
+
- `/agileflow:session-status` - View current session state and activity
|
|
262
|
+
- `/agileflow:skill-create` - Generate a custom skill with web research, cookbook pattern, and MCP integration
|
|
263
|
+
- `/agileflow:skill-delete` - Remove an installed skill from \.claude/skills/
|
|
264
|
+
- `/agileflow:skill-edit` - Edit an existing skill's SKILL\.md, cookbook entries, or references
|
|
265
|
+
- `/agileflow:skill-list \(no arguments\)` - List all installed skills with their descriptions and status
|
|
266
|
+
- `/agileflow:skill-test` - Verify a skill works correctly by testing its activation and functionality
|
|
267
|
+
- `/agileflow:skill-upgrade` - Upgrade existing skills with self\-improving learning capability
|
|
268
|
+
- `/agileflow:status STORY=<US\-ID> STATUS=<status> \[SUMMARY=<text>\] \[PR=<url>\] \[TO=<agent\-id>\]` - Update story status and progress
|
|
269
|
+
- `/agileflow:story EPIC=<EP\-ID> STORY=<US\-ID> TITLE=<text> OWNER=<id> \[ESTIMATE=<pts>\] \[AC=<list>\] \[TDD=true\]` - Create a user story with acceptance criteria
|
|
270
|
+
- `/agileflow:story-validate STORY=<US\-ID>` - Validate story completeness before development
|
|
271
|
+
- `/agileflow:story-view STORY=<US\-ID>` - View story details with contextual actions
|
|
272
|
+
- `/agileflow:template ACTION=create\|edit\|list\|use \[TYPE=story\|epic\|adr\|custom\] \[NAME=<name>\]` - Create and manage custom document templates
|
|
273
|
+
- `/agileflow:tests \(no arguments\)` - Set up automated testing infrastructure
|
|
274
|
+
- `/agileflow:validate-expertise` - Validate expertise files for drift and staleness
|
|
275
|
+
- `/agileflow:verify` - Run project tests and update story test status
|
|
276
|
+
- `/agileflow:whats-new \(no arguments\)` - Show what's new in AgileFlow
|
|
277
|
+
- `/agileflow:workflow <template> \[<arguments>\]` - Define and run parameterized workflow templates
|
|
278
|
+
|
|
93
279
|
|
|
94
280
|
OUTPUT: plain markdown only (no file writes)
|
|
95
281
|
|
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
---
|
|
2
2
|
description: Generate categorized improvement ideas using multi-expert analysis
|
|
3
|
-
argument-hint: [SCOPE=all|security|perf|code|ux] [DEPTH=quick|deep] [OUTPUT=report|stories|both]
|
|
3
|
+
argument-hint: [SCOPE=all|security|perf|code|ux] [DEPTH=quick|deep|ultradeep] [OUTPUT=report|stories|both]
|
|
4
4
|
compact_context:
|
|
5
5
|
priority: high
|
|
6
6
|
preserve_rules:
|
|
7
7
|
- "ACTIVE COMMAND: /agileflow:ideate - Ideation orchestrator with multi-expert analysis"
|
|
8
8
|
- "CRITICAL: Deploy experts IN PARALLEL in ONE message with multiple Task calls"
|
|
9
9
|
- "CRITICAL: Wait for all results before synthesis (use TaskOutput with block=true)"
|
|
10
|
-
- "CRITICAL: Confidence scoring:
|
|
11
|
-
- "MUST parse arguments: SCOPE (all/security/perf/code/ux) | DEPTH (quick/deep) | OUTPUT (report/stories/both)"
|
|
10
|
+
- "CRITICAL: Confidence scoring varies by depth: quick/deep (HIGH=2+ agree) | ultradeep (HIGH=3+ agree)"
|
|
11
|
+
- "MUST parse arguments: SCOPE (all/security/perf/code/ux) | DEPTH (quick/deep/ultradeep) | OUTPUT (report/stories/both)"
|
|
12
12
|
- "MUST categorize by domain: Security, Performance, Code Quality, UX, Testing, API/Architecture"
|
|
13
13
|
- "MUST estimate effort for each idea: High/Medium/Low impact"
|
|
14
14
|
- "Optional: Generate stories for HIGH-confidence items (if OUTPUT=stories or both)"
|
|
@@ -44,11 +44,11 @@ node .agileflow/scripts/obtain-context.js ideate
|
|
|
44
44
|
/agileflow:ideate SCOPE=all DEPTH=quick OUTPUT=report
|
|
45
45
|
```
|
|
46
46
|
|
|
47
|
-
**What It Does**: Deploy 4-
|
|
47
|
+
**What It Does**: Deploy 4-15 domain experts → Each generates 3-5 ideas → Synthesize with confidence scoring → Categorized report
|
|
48
48
|
|
|
49
49
|
**Arguments**:
|
|
50
50
|
- `SCOPE=all|security|perf|code|ux` (default: all)
|
|
51
|
-
- `DEPTH=quick|deep` (default: quick)
|
|
51
|
+
- `DEPTH=quick|deep|ultradeep` (default: quick) — ultradeep uses 13 experts for ~65 ideas
|
|
52
52
|
- `OUTPUT=report|stories|both` (default: report)
|
|
53
53
|
|
|
54
54
|
### Tool Usage Examples
|
|
@@ -87,7 +87,7 @@ node .agileflow/scripts/obtain-context.js ideate
|
|
|
87
87
|
```
|
|
88
88
|
|
|
89
89
|
**Categories**: Security, Performance, Code Quality, UX/Design, Testing, API/Architecture
|
|
90
|
-
**Confidence**: High (2+ experts agree), Medium (1 expert with evidence)
|
|
90
|
+
**Confidence**: High (2+ experts agree; 3+ for ultradeep), Medium (1 expert with evidence)
|
|
91
91
|
**Output**: `docs/08-project/ideation-<YYYYMMDD>.md` | Optional stories
|
|
92
92
|
<!-- COMPACT_SUMMARY_END -->
|
|
93
93
|
|
|
@@ -104,7 +104,7 @@ node .agileflow/scripts/obtain-context.js ideate
|
|
|
104
104
|
┌─────────────────────────────────────────────────────────────┐
|
|
105
105
|
│ IDEATION ORCHESTRATOR │
|
|
106
106
|
│ 1. Parse SCOPE to determine which experts │
|
|
107
|
-
│ 2. Deploy 4-
|
|
107
|
+
│ 2. Deploy 4-13 experts IN PARALLEL (13 for ultradeep) │
|
|
108
108
|
│ 3. Each expert generates 3-5 improvement ideas │
|
|
109
109
|
│ 4. Collect and synthesize with confidence scoring │
|
|
110
110
|
│ 5. Generate categorized report │
|
|
@@ -153,17 +153,20 @@ You coordinate multiple domain experts to generate improvement suggestions for t
|
|
|
153
153
|
Parse the input arguments:
|
|
154
154
|
|
|
155
155
|
**SCOPE** (which experts to deploy):
|
|
156
|
-
| SCOPE | Experts |
|
|
157
|
-
|
|
158
|
-
| `all` (default) | security, performance, refactor, ui, testing, api (6
|
|
159
|
-
| `security` | security, api, testing (3
|
|
160
|
-
| `perf` | performance, database, api (3
|
|
161
|
-
| `code` | refactor, testing, api (3
|
|
162
|
-
| `ux` | ui, accessibility, api (3
|
|
156
|
+
| SCOPE | Experts (quick/deep) | Experts (ultradeep adds) |
|
|
157
|
+
|-------|----------------------|--------------------------|
|
|
158
|
+
| `all` (default) | security, performance, refactor, ui, testing, api (6) | + accessibility, compliance, database, monitoring, qa, analytics, documentation (13 total) |
|
|
159
|
+
| `security` | security, api, testing (3) | + compliance, monitoring (5 total) |
|
|
160
|
+
| `perf` | performance, database, api (3) | + monitoring, analytics (5 total) |
|
|
161
|
+
| `code` | refactor, testing, api (3) | + documentation, qa (5 total) |
|
|
162
|
+
| `ux` | ui, accessibility, api (3) | + design, analytics (5 total) |
|
|
163
163
|
|
|
164
164
|
**DEPTH**:
|
|
165
165
|
- `quick` (default): Each expert generates 3 ideas, focuses on high-impact only
|
|
166
166
|
- `deep`: Each expert generates 5 ideas, includes lower-priority items
|
|
167
|
+
- `ultradeep`: Deploy 13 experts (SCOPE=all) with 5 ideas each (~65 ideas), comprehensive coverage
|
|
168
|
+
|
|
169
|
+
> **Note**: `DEPTH=ultradeep` is recommended for comprehensive audits, pre-release reviews, or quarterly codebase assessments. It deploys significantly more experts and takes longer to complete.
|
|
167
170
|
|
|
168
171
|
**OUTPUT**:
|
|
169
172
|
- `report` (default): Generate ideation report only
|
|
@@ -255,6 +258,103 @@ FORMAT each idea as:
|
|
|
255
258
|
</invoke>
|
|
256
259
|
```
|
|
257
260
|
|
|
261
|
+
**Example deployment for SCOPE=all DEPTH=ultradeep** (13 experts):
|
|
262
|
+
|
|
263
|
+
```xml
|
|
264
|
+
<!-- Deploy ALL 13 experts in a SINGLE message -->
|
|
265
|
+
<invoke name="Task">
|
|
266
|
+
<parameter name="description">Security ideation</parameter>
|
|
267
|
+
<parameter name="prompt">[prompt with domain=security]</parameter>
|
|
268
|
+
<parameter name="subagent_type">agileflow-security</parameter>
|
|
269
|
+
<parameter name="run_in_background">true</parameter>
|
|
270
|
+
</invoke>
|
|
271
|
+
|
|
272
|
+
<invoke name="Task">
|
|
273
|
+
<parameter name="description">Performance ideation</parameter>
|
|
274
|
+
<parameter name="prompt">[prompt with domain=performance]</parameter>
|
|
275
|
+
<parameter name="subagent_type">agileflow-performance</parameter>
|
|
276
|
+
<parameter name="run_in_background">true</parameter>
|
|
277
|
+
</invoke>
|
|
278
|
+
|
|
279
|
+
<invoke name="Task">
|
|
280
|
+
<parameter name="description">Code quality ideation</parameter>
|
|
281
|
+
<parameter name="prompt">[prompt with domain=refactor]</parameter>
|
|
282
|
+
<parameter name="subagent_type">agileflow-refactor</parameter>
|
|
283
|
+
<parameter name="run_in_background">true</parameter>
|
|
284
|
+
</invoke>
|
|
285
|
+
|
|
286
|
+
<invoke name="Task">
|
|
287
|
+
<parameter name="description">UX ideation</parameter>
|
|
288
|
+
<parameter name="prompt">[prompt with domain=ui]</parameter>
|
|
289
|
+
<parameter name="subagent_type">agileflow-ui</parameter>
|
|
290
|
+
<parameter name="run_in_background">true</parameter>
|
|
291
|
+
</invoke>
|
|
292
|
+
|
|
293
|
+
<invoke name="Task">
|
|
294
|
+
<parameter name="description">Testing ideation</parameter>
|
|
295
|
+
<parameter name="prompt">[prompt with domain=testing]</parameter>
|
|
296
|
+
<parameter name="subagent_type">agileflow-testing</parameter>
|
|
297
|
+
<parameter name="run_in_background">true</parameter>
|
|
298
|
+
</invoke>
|
|
299
|
+
|
|
300
|
+
<invoke name="Task">
|
|
301
|
+
<parameter name="description">API/Architecture ideation</parameter>
|
|
302
|
+
<parameter name="prompt">[prompt with domain=api]</parameter>
|
|
303
|
+
<parameter name="subagent_type">agileflow-api</parameter>
|
|
304
|
+
<parameter name="run_in_background">true</parameter>
|
|
305
|
+
</invoke>
|
|
306
|
+
|
|
307
|
+
<!-- Additional ultradeep experts (7 more) -->
|
|
308
|
+
<invoke name="Task">
|
|
309
|
+
<parameter name="description">Accessibility ideation</parameter>
|
|
310
|
+
<parameter name="prompt">[prompt with domain=accessibility]</parameter>
|
|
311
|
+
<parameter name="subagent_type">agileflow-accessibility</parameter>
|
|
312
|
+
<parameter name="run_in_background">true</parameter>
|
|
313
|
+
</invoke>
|
|
314
|
+
|
|
315
|
+
<invoke name="Task">
|
|
316
|
+
<parameter name="description">Compliance ideation</parameter>
|
|
317
|
+
<parameter name="prompt">[prompt with domain=compliance]</parameter>
|
|
318
|
+
<parameter name="subagent_type">agileflow-compliance</parameter>
|
|
319
|
+
<parameter name="run_in_background">true</parameter>
|
|
320
|
+
</invoke>
|
|
321
|
+
|
|
322
|
+
<invoke name="Task">
|
|
323
|
+
<parameter name="description">Database ideation</parameter>
|
|
324
|
+
<parameter name="prompt">[prompt with domain=database]</parameter>
|
|
325
|
+
<parameter name="subagent_type">agileflow-database</parameter>
|
|
326
|
+
<parameter name="run_in_background">true</parameter>
|
|
327
|
+
</invoke>
|
|
328
|
+
|
|
329
|
+
<invoke name="Task">
|
|
330
|
+
<parameter name="description">Monitoring ideation</parameter>
|
|
331
|
+
<parameter name="prompt">[prompt with domain=monitoring]</parameter>
|
|
332
|
+
<parameter name="subagent_type">agileflow-monitoring</parameter>
|
|
333
|
+
<parameter name="run_in_background">true</parameter>
|
|
334
|
+
</invoke>
|
|
335
|
+
|
|
336
|
+
<invoke name="Task">
|
|
337
|
+
<parameter name="description">QA ideation</parameter>
|
|
338
|
+
<parameter name="prompt">[prompt with domain=qa]</parameter>
|
|
339
|
+
<parameter name="subagent_type">agileflow-qa</parameter>
|
|
340
|
+
<parameter name="run_in_background">true</parameter>
|
|
341
|
+
</invoke>
|
|
342
|
+
|
|
343
|
+
<invoke name="Task">
|
|
344
|
+
<parameter name="description">Analytics ideation</parameter>
|
|
345
|
+
<parameter name="prompt">[prompt with domain=analytics]</parameter>
|
|
346
|
+
<parameter name="subagent_type">agileflow-analytics</parameter>
|
|
347
|
+
<parameter name="run_in_background">true</parameter>
|
|
348
|
+
</invoke>
|
|
349
|
+
|
|
350
|
+
<invoke name="Task">
|
|
351
|
+
<parameter name="description">Documentation ideation</parameter>
|
|
352
|
+
<parameter name="prompt">[prompt with domain=documentation]</parameter>
|
|
353
|
+
<parameter name="subagent_type">agileflow-documentation</parameter>
|
|
354
|
+
<parameter name="run_in_background">true</parameter>
|
|
355
|
+
</invoke>
|
|
356
|
+
```
|
|
357
|
+
|
|
258
358
|
### STEP 3: COLLECT RESULTS
|
|
259
359
|
|
|
260
360
|
Wait for all experts to complete:
|
|
@@ -278,11 +378,13 @@ Analyze all expert ideas and synthesize:
|
|
|
278
378
|
|
|
279
379
|
**Confidence Scoring**:
|
|
280
380
|
|
|
281
|
-
| Confidence | Criteria | Action |
|
|
282
|
-
|
|
283
|
-
| **HIGH** | 2+ experts suggest similar idea | Include prominently, recommend immediate action |
|
|
284
|
-
| **MEDIUM** | 1 expert with specific evidence
|
|
285
|
-
| **LOW** | 1 expert, vague/no evidence | Exclude from report |
|
|
381
|
+
| Confidence | Criteria (quick/deep) | Criteria (ultradeep) | Action |
|
|
382
|
+
|------------|----------------------|----------------------|--------|
|
|
383
|
+
| **HIGH** | 2+ experts suggest similar idea | 3+ experts suggest similar idea | Include prominently, recommend immediate action |
|
|
384
|
+
| **MEDIUM** | 1 expert with specific evidence | 1-2 experts with specific evidence | Include as opportunity |
|
|
385
|
+
| **LOW** | 1 expert, vague/no evidence | 1-2 experts, vague/no evidence | Exclude from report |
|
|
386
|
+
|
|
387
|
+
> For ultradeep mode, the higher threshold (3+) for HIGH confidence prevents noise from having many perspectives and ensures only truly cross-cutting concerns bubble up as top priorities.
|
|
286
388
|
|
|
287
389
|
**Overlap Detection**:
|
|
288
390
|
- Ideas about the same file/component from different experts = HIGH confidence
|
|
@@ -435,12 +537,35 @@ After generating output, present options:
|
|
|
435
537
|
|
|
436
538
|
---
|
|
437
539
|
|
|
540
|
+
### Example: Ultradeep Execution
|
|
541
|
+
|
|
542
|
+
**User**: `/agileflow:ideate SCOPE=all DEPTH=ultradeep OUTPUT=both`
|
|
543
|
+
|
|
544
|
+
**Step 1**: Parse → SCOPE=all (13 experts), DEPTH=ultradeep (5 ideas each), OUTPUT=both
|
|
545
|
+
|
|
546
|
+
**Step 2**: Deploy 13 experts in parallel (security, performance, refactor, ui, testing, api, accessibility, compliance, database, monitoring, qa, analytics, documentation)
|
|
547
|
+
|
|
548
|
+
**Step 3**: Collect results (~65 raw ideas)
|
|
549
|
+
|
|
550
|
+
**Step 4**: Synthesize with ultradeep thresholds:
|
|
551
|
+
- 8 ideas mentioned by 3+ experts → HIGH confidence
|
|
552
|
+
- 25 ideas with 1-2 experts + evidence → MEDIUM confidence
|
|
553
|
+
- 32 ideas too vague or single expert without evidence → excluded
|
|
554
|
+
|
|
555
|
+
**Step 5**: Generate report with 33 ideas, saved to `docs/08-project/ideation-20260106.md`
|
|
556
|
+
|
|
557
|
+
**Step 6**: Generate 8 stories for HIGH-confidence items
|
|
558
|
+
|
|
559
|
+
**Step 7**: Present next steps via AskUserQuestion
|
|
560
|
+
|
|
561
|
+
---
|
|
562
|
+
|
|
438
563
|
## Arguments
|
|
439
564
|
|
|
440
565
|
| Argument | Values | Default | Description |
|
|
441
566
|
|----------|--------|---------|-------------|
|
|
442
567
|
| SCOPE | all, security, perf, code, ux | all | Which domains to analyze |
|
|
443
|
-
| DEPTH | quick, deep | quick |
|
|
568
|
+
| DEPTH | quick, deep, ultradeep | quick | quick (3 ideas, 6 experts), deep (5 ideas, 6 experts), ultradeep (5 ideas, 13 experts) |
|
|
444
569
|
| OUTPUT | report, stories, both | report | What to generate |
|
|
445
570
|
|
|
446
571
|
{{argument}}
|
|
@@ -106,6 +106,8 @@ Display:
|
|
|
106
106
|
To resume later: cd {path} && claude
|
|
107
107
|
```
|
|
108
108
|
|
|
109
|
+
Then proceed to **Step 4: Offer to Close Tab**.
|
|
110
|
+
|
|
109
111
|
### Step 3c: If "End and delete worktree" Selected
|
|
110
112
|
|
|
111
113
|
```bash
|
|
@@ -123,6 +125,8 @@ Display:
|
|
|
123
125
|
git branch -d {branch}
|
|
124
126
|
```
|
|
125
127
|
|
|
128
|
+
Then proceed to **Step 4: Offer to Close Tab**.
|
|
129
|
+
|
|
126
130
|
### Step 3d: If "Cancel" Selected
|
|
127
131
|
|
|
128
132
|
```
|
|
@@ -131,6 +135,39 @@ Session remains active.
|
|
|
131
135
|
|
|
132
136
|
---
|
|
133
137
|
|
|
138
|
+
## Step 4: Offer to Close Tab (if in tmux)
|
|
139
|
+
|
|
140
|
+
After ending a session (via end, delete, or merge), check if we're in tmux and offer to close the tab.
|
|
141
|
+
|
|
142
|
+
**Check if in tmux:**
|
|
143
|
+
```bash
|
|
144
|
+
echo $TMUX
|
|
145
|
+
```
|
|
146
|
+
|
|
147
|
+
If `$TMUX` is set (non-empty), we're in tmux. Ask:
|
|
148
|
+
|
|
149
|
+
```
|
|
150
|
+
AskUserQuestion:
|
|
151
|
+
question: "Close this tmux tab?"
|
|
152
|
+
header: "Close tab"
|
|
153
|
+
multiSelect: false
|
|
154
|
+
options:
|
|
155
|
+
- label: "Yes, close tab"
|
|
156
|
+
description: "Close this terminal tab (Alt+x also works)"
|
|
157
|
+
- label: "No, keep open"
|
|
158
|
+
description: "Stay in this tab"
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
**If "Yes, close tab" selected:**
|
|
162
|
+
```bash
|
|
163
|
+
tmux kill-window
|
|
164
|
+
```
|
|
165
|
+
|
|
166
|
+
**If "No, keep open" selected:**
|
|
167
|
+
Display any final messages and end.
|
|
168
|
+
|
|
169
|
+
---
|
|
170
|
+
|
|
134
171
|
## MERGE FLOW (for "Complete & merge to main")
|
|
135
172
|
|
|
136
173
|
### Merge Step 1: Check for Uncommitted Changes
|
|
@@ -345,6 +382,8 @@ Summary:
|
|
|
345
382
|
💡 To push your changes: git push
|
|
346
383
|
```
|
|
347
384
|
|
|
385
|
+
Then proceed to **Step 4: Offer to Close Tab**.
|
|
386
|
+
|
|
348
387
|
If failed:
|
|
349
388
|
|
|
350
389
|
```
|
|
@@ -532,6 +571,39 @@ Session remains active.
|
|
|
532
571
|
|
|
533
572
|
---
|
|
534
573
|
|
|
574
|
+
### 🚨 RULE #5: OFFER TO CLOSE TMUX TAB
|
|
575
|
+
|
|
576
|
+
After session ends (via end, delete, or merge), check if in tmux and offer to close:
|
|
577
|
+
|
|
578
|
+
```bash
|
|
579
|
+
# Check if in tmux
|
|
580
|
+
echo $TMUX
|
|
581
|
+
```
|
|
582
|
+
|
|
583
|
+
If in tmux, ask:
|
|
584
|
+
```xml
|
|
585
|
+
<invoke name="AskUserQuestion">
|
|
586
|
+
<parameter name="questions">[{
|
|
587
|
+
"question": "Close this tmux tab?",
|
|
588
|
+
"header": "Close tab",
|
|
589
|
+
"multiSelect": false,
|
|
590
|
+
"options": [
|
|
591
|
+
{"label": "Yes, close tab",
|
|
592
|
+
"description": "Close this terminal tab (Alt+x also works)"},
|
|
593
|
+
{"label": "No, keep open",
|
|
594
|
+
"description": "Stay in this tab"}
|
|
595
|
+
]
|
|
596
|
+
}]</parameter>
|
|
597
|
+
</invoke>
|
|
598
|
+
```
|
|
599
|
+
|
|
600
|
+
If "Yes":
|
|
601
|
+
```bash
|
|
602
|
+
tmux kill-window
|
|
603
|
+
```
|
|
604
|
+
|
|
605
|
+
---
|
|
606
|
+
|
|
535
607
|
### KEY FILES
|
|
536
608
|
|
|
537
609
|
| File | Purpose |
|
|
@@ -557,6 +629,7 @@ Session remains active.
|
|
|
557
629
|
f. Execute integrate
|
|
558
630
|
g. Show success with cd command
|
|
559
631
|
5. If end/delete → Execute and show result
|
|
632
|
+
6. If in tmux → Offer to close tab
|
|
560
633
|
```
|
|
561
634
|
|
|
562
635
|
---
|
|
@@ -588,5 +661,6 @@ Session remains active.
|
|
|
588
661
|
- Merge flow: uncommitted → preview → conflicts → strategy → confirm → execute
|
|
589
662
|
- Default strategy: squash
|
|
590
663
|
- Always show cd command to return to main
|
|
664
|
+
- **After session ends: Offer to close tmux tab (if in tmux)**
|
|
591
665
|
|
|
592
666
|
<!-- COMPACT_SUMMARY_END -->
|
|
File without changes
|