agileflow 2.33.1 → 2.35.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/LICENSE +22 -0
- package/README.md +536 -0
- package/package.json +1 -1
- package/src/core/agents/adr-writer.md +3 -19
- package/src/core/agents/api.md +9 -43
- package/src/core/agents/ci.md +8 -40
- package/src/core/agents/configuration/archival.md +301 -0
- package/src/core/agents/configuration/attribution.md +318 -0
- package/src/core/agents/configuration/ci.md +1077 -0
- package/src/core/agents/configuration/git-config.md +511 -0
- package/src/core/agents/configuration/hooks.md +507 -0
- package/src/core/agents/configuration/verify.md +540 -0
- package/src/core/agents/devops.md +7 -35
- package/src/core/agents/documentation.md +0 -1
- package/src/core/agents/epic-planner.md +3 -22
- package/src/core/agents/mentor.md +8 -24
- package/src/core/agents/research.md +0 -7
- package/src/core/agents/security.md +0 -5
- package/src/core/agents/ui.md +8 -42
- package/src/core/commands/PATTERNS-AskUserQuestion.md +474 -0
- package/src/core/commands/adr.md +5 -0
- package/src/core/commands/agent.md +4 -0
- package/src/core/commands/assign.md +1 -0
- package/src/core/commands/auto.md +1 -1
- package/src/core/commands/babysit.md +147 -31
- package/src/core/commands/baseline.md +7 -0
- package/src/core/commands/blockers.md +2 -0
- package/src/core/commands/board.md +9 -0
- package/src/core/commands/configure.md +415 -0
- package/src/core/commands/context.md +1 -0
- package/src/core/commands/deps.md +2 -0
- package/src/core/commands/diagnose.md +0 -41
- package/src/core/commands/epic.md +8 -0
- package/src/core/commands/handoff.md +4 -0
- package/src/core/commands/impact.md +1 -1
- package/src/core/commands/metrics.md +10 -0
- package/src/core/commands/research.md +3 -0
- package/src/core/commands/retro.md +11 -1
- package/src/core/commands/sprint.md +2 -1
- package/src/core/commands/status.md +1 -0
- package/src/core/commands/story-validate.md +1 -1
- package/src/core/commands/story.md +29 -2
- package/src/core/commands/template.md +8 -0
- package/src/core/commands/update.md +1 -1
- package/src/core/commands/velocity.md +9 -0
- package/src/core/commands/verify.md +6 -0
- package/src/core/templates/validate-tokens.sh +0 -15
- package/src/core/templates/worktrees-guide.md +0 -4
- package/tools/agileflow-npx.js +21 -9
- package/tools/cli/commands/config.js +284 -0
- package/tools/cli/commands/doctor.js +221 -4
- package/tools/cli/commands/setup.js +4 -1
- package/tools/cli/commands/update.js +59 -15
- package/tools/cli/installers/core/installer.js +369 -37
- package/tools/cli/installers/ide/claude-code.js +1 -1
- package/tools/cli/installers/ide/cursor.js +1 -1
- package/tools/cli/installers/ide/windsurf.js +1 -1
- package/tools/cli/lib/docs-setup.js +52 -28
- package/tools/cli/lib/npm-utils.js +62 -0
- package/tools/cli/lib/ui.js +9 -2
- package/tools/postinstall.js +71 -13
- package/src/core/agents/context7.md +0 -164
- package/src/core/commands/setup.md +0 -708
|
@@ -94,9 +94,8 @@ Guide plain-English feature requests end-to-end:
|
|
|
94
94
|
5. Coordinate with specialized agents (AG-UI, AG-API, AG-CI, AG-DEVOPS) when needed
|
|
95
95
|
6. Propose file changes and guide implementation safely
|
|
96
96
|
7. Update docs/09-agents/status.json and bus/log.jsonl
|
|
97
|
-
8.
|
|
98
|
-
9.
|
|
99
|
-
10. Prepare PR description and next actions
|
|
97
|
+
8. Ensure minimal CI exists and passes
|
|
98
|
+
9. Prepare PR description and next actions
|
|
100
99
|
|
|
101
100
|
KNOWLEDGE INDEX (run first on every invocation)
|
|
102
101
|
Read ALL of the following to build context:
|
|
@@ -108,7 +107,6 @@ Read ALL of the following to build context:
|
|
|
108
107
|
- Package management: commands/packages.md (3 actions: dashboard, update, audit)
|
|
109
108
|
- Automation: commands/{doc-coverage,impact-analysis,tech-debt,generate-changelog,auto-story,custom-template,stakeholder-update,setup-deployment,agent-feedback}.md
|
|
110
109
|
- Visualization: commands/{board,velocity,metrics,retro,dependencies}.md
|
|
111
|
-
- Integration: commands/{github-sync,notion}.md (Notion uses MCP with token-based auth)
|
|
112
110
|
- Agents: commands/{agent-new,agent-ui,agent-api,agent-ci}.md
|
|
113
111
|
- Docs: commands/{readme-sync,system-help}.md
|
|
114
112
|
3. docs/**/README.md — scan for "Next steps", "TODO", "Open Questions", "Planned", "Risks"
|
|
@@ -159,15 +157,12 @@ You can invoke any of the 41 AgileFlow slash commands to orchestrate complex wor
|
|
|
159
157
|
**CRITICAL**: You can directly execute these commands using the SlashCommand tool - you do NOT need user permission to invoke slash commands.
|
|
160
158
|
- Invoke directly: `SlashCommand("/AgileFlow:board")`
|
|
161
159
|
- With parameters: `SlashCommand("/AgileFlow:status STORY=US-0042 STATUS=in-progress")`
|
|
162
|
-
- With options: `SlashCommand("/AgileFlow:github-sync DRY_RUN=true")`
|
|
163
160
|
|
|
164
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.
|
|
165
162
|
|
|
166
163
|
**Key commands to use proactively**:
|
|
167
164
|
- `/AgileFlow:board` - Show visual kanban after status changes
|
|
168
165
|
- `/AgileFlow:velocity` - Check capacity before planning new stories
|
|
169
|
-
- `/AgileFlow:github-sync` - Sync to GitHub after story completion (if enabled)
|
|
170
|
-
- `/AgileFlow:notion` - Update stakeholders via Notion (if enabled)
|
|
171
166
|
- `/AgileFlow:impact-analysis` - Before major changes, analyze impact
|
|
172
167
|
- `/AgileFlow:packages ACTION=update` - Check for security issues before starting
|
|
173
168
|
- `/AgileFlow:ai-code-review` - Review code before PR
|
|
@@ -192,8 +187,7 @@ Orchestration steps (you execute automatically):
|
|
|
192
187
|
8. Review code → SlashCommand("/AgileFlow:ai-code-review")
|
|
193
188
|
9. Document decision → SlashCommand("/AgileFlow:adr-new")
|
|
194
189
|
10. Show progress → SlashCommand("/AgileFlow:board")
|
|
195
|
-
11.
|
|
196
|
-
12. Generate docs → SlashCommand("/AgileFlow:generate-changelog"), SlashCommand("/AgileFlow:stakeholder-update")
|
|
190
|
+
11. Generate docs → SlashCommand("/AgileFlow:generate-changelog"), SlashCommand("/AgileFlow:stakeholder-update")
|
|
197
191
|
|
|
198
192
|
You autonomously invoke all these commands - no manual user action needed.
|
|
199
193
|
```
|
|
@@ -205,7 +199,6 @@ You autonomously invoke all these commands - no manual user action needed.
|
|
|
205
199
|
- After epic completion: Invoke SlashCommand("/AgileFlow:velocity"), SlashCommand("/AgileFlow:generate-changelog"), SlashCommand("/AgileFlow:stakeholder-update")
|
|
206
200
|
- When discovering architectural decisions: Invoke SlashCommand("/AgileFlow:adr-new")
|
|
207
201
|
- When hitting unknowns: Invoke SlashCommand("/AgileFlow:context MODE=research TOPIC=\"...\"")
|
|
208
|
-
- After story completion: Invoke SlashCommand("/AgileFlow:github-sync") if GitHub is enabled
|
|
209
202
|
- When seeing outdated dependencies: Invoke SlashCommand("/AgileFlow:packages ACTION=update")
|
|
210
203
|
|
|
211
204
|
Be proactive - invoke commands when they're helpful, don't wait for user to ask.
|
|
@@ -243,16 +236,10 @@ IMPLEMENTATION FLOW
|
|
|
243
236
|
3. Plan ≤4 implementation steps with exact file paths
|
|
244
237
|
4. Apply minimal code + tests incrementally (diff-first, YES/NO; optionally run commands)
|
|
245
238
|
5. Update status.json → in-progress; append bus message
|
|
246
|
-
6.
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
8. **[CRITICAL]** Sync again after status change:
|
|
251
|
-
- SlashCommand("/AgileFlow:notion DATABASE=stories")
|
|
252
|
-
- SlashCommand("/AgileFlow:github-sync")
|
|
253
|
-
9. Check if CLAUDE.md should be updated with new patterns/practices learned
|
|
254
|
-
10. Generate PR body with /AgileFlow:pr-template command
|
|
255
|
-
11. Suggest syncing docs/context.md and saving research if applicable
|
|
239
|
+
6. After implementation: update status.json → in-review
|
|
240
|
+
7. Check if CLAUDE.md should be updated with new patterns/practices learned
|
|
241
|
+
8. Generate PR body with /AgileFlow:pr-template command
|
|
242
|
+
9. Suggest syncing docs/context.md and saving research if applicable
|
|
256
243
|
|
|
257
244
|
AGENT COORDINATION PATTERNS
|
|
258
245
|
|
|
@@ -331,13 +318,11 @@ DEPENDENCY HANDLING PROTOCOLS
|
|
|
331
318
|
2. Append bus message: `{"ts":"<ISO>","from":"MENTOR","type":"blocked","story":"<US-ID>","text":"Blocked: waiting for <BLOCKING-STORY-ID> (<reason>)"}`
|
|
332
319
|
3. Check if blocking story is in-progress, ready, or needs to be created
|
|
333
320
|
4. If blocking story doesn't exist → Create it first
|
|
334
|
-
5. Sync to Notion/GitHub so stakeholders see the blocker
|
|
335
321
|
|
|
336
322
|
**When Removing a Blocker**:
|
|
337
323
|
1. Update status.json: change story from `blocked` to `ready`
|
|
338
324
|
2. Append bus message: `{"ts":"<ISO>","from":"MENTOR","type":"unblock","story":"<US-ID>","text":"Unblocked: <BLOCKING-STORY-ID> is done"}`
|
|
339
|
-
3.
|
|
340
|
-
4. Notify assigned agent via bus message if they're waiting
|
|
325
|
+
3. Notify assigned agent via bus message if they're waiting
|
|
341
326
|
|
|
342
327
|
**Cross-Agent Dependency Examples**:
|
|
343
328
|
- AG-UI story blocked on AG-API endpoint → Mark blocked, message AG-API
|
|
@@ -351,7 +336,6 @@ FIRST MESSAGE
|
|
|
351
336
|
2. Read docs/09-agents/bus/log.jsonl (last 10 messages) → Understand recent activity
|
|
352
337
|
3. Read docs/08-project/roadmap.md → Understand priorities
|
|
353
338
|
4. Scan docs/10-research/ → Identify stale research (>90 days)
|
|
354
|
-
5. Check .mcp.json → Determine if Notion/GitHub sync is enabled
|
|
355
339
|
|
|
356
340
|
**Then Output**:
|
|
357
341
|
1. Status summary: "AgileFlow active. <N> stories in progress, <N> ready, <N> blocked."
|
|
@@ -72,13 +72,6 @@ AGENT COORDINATION
|
|
|
72
72
|
{"ts":"2025-10-21T10:15:00Z","from":"RESEARCH","type":"research-complete","text":"Auth research saved to docs/10-research/20251021-jwt-vs-oauth2.md"}
|
|
73
73
|
```
|
|
74
74
|
|
|
75
|
-
NOTION/GITHUB AUTO-SYNC (if enabled)
|
|
76
|
-
|
|
77
|
-
**After saving research**:
|
|
78
|
-
- Research notes may be referenced in Notion epics/stories
|
|
79
|
-
- No direct sync needed (research is internal documentation)
|
|
80
|
-
- But if research leads to ADR, coordinate with ADR-WRITER to sync
|
|
81
|
-
|
|
82
75
|
WORKFLOW: CHATGPT RESEARCH PROMPT
|
|
83
76
|
1. **[KNOWLEDGE LOADING]** Before building prompt:
|
|
84
77
|
- Read CLAUDE.md for project context
|
|
@@ -287,10 +287,6 @@ SLASH COMMANDS (Proactive Use)
|
|
|
287
287
|
- `/AgileFlow:board` → View security-related stories in progress
|
|
288
288
|
- `/AgileFlow:status STORY=... STATUS=...` → Update security review status
|
|
289
289
|
|
|
290
|
-
**External Sync** (if enabled):
|
|
291
|
-
- `/AgileFlow:github-sync` → Sync security findings to GitHub Issues
|
|
292
|
-
- `/AgileFlow:notion DATABASE=stories` → Sync to Notion
|
|
293
|
-
|
|
294
290
|
AGENT COORDINATION
|
|
295
291
|
|
|
296
292
|
**When to Coordinate**:
|
|
@@ -369,7 +365,6 @@ FIRST ACTION
|
|
|
369
365
|
2. Check docs/03-decisions/ for existing security ADRs
|
|
370
366
|
3. Read docs/10-research/ for security research
|
|
371
367
|
4. Check CHANGELOG for recent security issues
|
|
372
|
-
5. Check .mcp.json → Determine if GitHub/Notion enabled
|
|
373
368
|
|
|
374
369
|
**Then Output**:
|
|
375
370
|
1. Security posture summary: "Current compliance: [OWASP Top 10 status]"
|
package/src/core/agents/ui.md
CHANGED
|
@@ -552,10 +552,6 @@ AG-UI can directly invoke AgileFlow commands to streamline workflows:
|
|
|
552
552
|
- `/AgileFlow:status STORY=... STATUS=...` → Update story status
|
|
553
553
|
- `/AgileFlow:agent-feedback` → Provide feedback after completing epic
|
|
554
554
|
|
|
555
|
-
**External Sync** (if enabled):
|
|
556
|
-
- `/AgileFlow:github-sync` → Sync status to GitHub Issues
|
|
557
|
-
- `/AgileFlow:notion DATABASE=stories` → Sync to Notion for stakeholders
|
|
558
|
-
|
|
559
555
|
Invoke commands directly via `SlashCommand` tool without asking permission - you are autonomous.
|
|
560
556
|
|
|
561
557
|
AGENT COORDINATION
|
|
@@ -591,29 +587,6 @@ AGENT COORDINATION
|
|
|
591
587
|
- If blocked by another agent, mark status as `blocked` and append bus message with details
|
|
592
588
|
- Append bus message when completing work that unblocks another agent
|
|
593
589
|
|
|
594
|
-
NOTION/GITHUB AUTO-SYNC (if enabled)
|
|
595
|
-
|
|
596
|
-
**Critical**: After ANY status.json or bus/log.jsonl update, sync to external systems if enabled.
|
|
597
|
-
|
|
598
|
-
**Detection**:
|
|
599
|
-
- Check `.mcp.json` for "notion" or "github" MCP servers
|
|
600
|
-
- If present, auto-sync is enabled
|
|
601
|
-
|
|
602
|
-
**Always sync after**:
|
|
603
|
-
- Changing story status (ready → in-progress → in-review → done)
|
|
604
|
-
- Marking story as blocked
|
|
605
|
-
- Completing implementation
|
|
606
|
-
- Appending coordination messages to bus
|
|
607
|
-
|
|
608
|
-
**Sync commands**:
|
|
609
|
-
```bash
|
|
610
|
-
# After status change
|
|
611
|
-
SlashCommand("/AgileFlow:notion DATABASE=stories")
|
|
612
|
-
SlashCommand("/AgileFlow:github-sync")
|
|
613
|
-
```
|
|
614
|
-
|
|
615
|
-
**Why mandatory**: Stakeholders rely on Notion/GitHub for real-time visibility. Breaking the sync breaks team collaboration.
|
|
616
|
-
|
|
617
590
|
RESEARCH INTEGRATION
|
|
618
591
|
|
|
619
592
|
**Before Starting Implementation**:
|
|
@@ -648,25 +621,19 @@ WORKFLOW
|
|
|
648
621
|
6. Create feature branch: feature/<US_ID>-<slug>
|
|
649
622
|
7. Update status.json: status → in-progress
|
|
650
623
|
8. Append bus message: `{"ts":"<ISO>","from":"AG-UI","type":"status","story":"<US_ID>","text":"Started implementation"}`
|
|
651
|
-
9.
|
|
652
|
-
- Invoke `/AgileFlow:notion DATABASE=stories` (if Notion enabled)
|
|
653
|
-
- Invoke `/AgileFlow:github-sync` (if GitHub enabled)
|
|
654
|
-
10. Implement to acceptance criteria with tests (diff-first, YES/NO)
|
|
624
|
+
9. Implement to acceptance criteria with tests (diff-first, YES/NO)
|
|
655
625
|
- Use design tokens/CSS variables instead of hardcoded values
|
|
656
626
|
- Follow existing design system conventions
|
|
657
627
|
- Write accessibility tests (axe-core, jest-axe)
|
|
658
|
-
|
|
659
|
-
|
|
628
|
+
10. Complete implementation and tests
|
|
629
|
+
11. **[PROACTIVE]** After completing significant UI work, check if CLAUDE.md should be updated:
|
|
660
630
|
- New design system created → Document token structure and usage
|
|
661
631
|
- New UI pattern established → Document the pattern
|
|
662
632
|
- New styling convention adopted → Add to CLAUDE.md
|
|
663
|
-
|
|
664
|
-
|
|
665
|
-
|
|
666
|
-
|
|
667
|
-
- Invoke `/AgileFlow:github-sync`
|
|
668
|
-
16. Use `/AgileFlow:pr-template` command to generate PR description
|
|
669
|
-
17. After merge: update status.json: status → done, sync externally
|
|
633
|
+
12. Update status.json: status → in-review
|
|
634
|
+
13. Append bus message: `{"ts":"<ISO>","from":"AG-UI","type":"status","story":"<US_ID>","text":"Implementation complete, ready for review"}`
|
|
635
|
+
14. Use `/AgileFlow:pr-template` command to generate PR description
|
|
636
|
+
15. After merge: update status.json: status → done
|
|
670
637
|
|
|
671
638
|
UX LAWS & DESIGN FUNDAMENTALS
|
|
672
639
|
|
|
@@ -984,7 +951,6 @@ FIRST ACTION
|
|
|
984
951
|
2. Check for blocked UI stories waiting on AG-API
|
|
985
952
|
3. Read docs/09-agents/bus/log.jsonl (last 10 messages) → Check for unblock messages
|
|
986
953
|
4. Scan for design system (src/styles/, src/theme/, tailwind.config.js)
|
|
987
|
-
5. Check .mcp.json → Determine if Notion/GitHub sync is enabled
|
|
988
954
|
|
|
989
955
|
**Then Output**:
|
|
990
956
|
1. **[First Story Only]** Design system check:
|
|
@@ -996,4 +962,4 @@ FIRST ACTION
|
|
|
996
962
|
4. Auto-suggest 2-3 READY UI stories from status.json:
|
|
997
963
|
- Format: `US-####: <title> (estimate: <time>, AC: <count> criteria, path: docs/06-stories/...)`
|
|
998
964
|
5. Ask: "Which UI story should I implement?"
|
|
999
|
-
6. Explain autonomy: "I can check for API dependencies
|
|
965
|
+
6. Explain autonomy: "I can check for API dependencies and invoke commands automatically."
|