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.
Files changed (63) hide show
  1. package/LICENSE +22 -0
  2. package/README.md +536 -0
  3. package/package.json +1 -1
  4. package/src/core/agents/adr-writer.md +3 -19
  5. package/src/core/agents/api.md +9 -43
  6. package/src/core/agents/ci.md +8 -40
  7. package/src/core/agents/configuration/archival.md +301 -0
  8. package/src/core/agents/configuration/attribution.md +318 -0
  9. package/src/core/agents/configuration/ci.md +1077 -0
  10. package/src/core/agents/configuration/git-config.md +511 -0
  11. package/src/core/agents/configuration/hooks.md +507 -0
  12. package/src/core/agents/configuration/verify.md +540 -0
  13. package/src/core/agents/devops.md +7 -35
  14. package/src/core/agents/documentation.md +0 -1
  15. package/src/core/agents/epic-planner.md +3 -22
  16. package/src/core/agents/mentor.md +8 -24
  17. package/src/core/agents/research.md +0 -7
  18. package/src/core/agents/security.md +0 -5
  19. package/src/core/agents/ui.md +8 -42
  20. package/src/core/commands/PATTERNS-AskUserQuestion.md +474 -0
  21. package/src/core/commands/adr.md +5 -0
  22. package/src/core/commands/agent.md +4 -0
  23. package/src/core/commands/assign.md +1 -0
  24. package/src/core/commands/auto.md +1 -1
  25. package/src/core/commands/babysit.md +147 -31
  26. package/src/core/commands/baseline.md +7 -0
  27. package/src/core/commands/blockers.md +2 -0
  28. package/src/core/commands/board.md +9 -0
  29. package/src/core/commands/configure.md +415 -0
  30. package/src/core/commands/context.md +1 -0
  31. package/src/core/commands/deps.md +2 -0
  32. package/src/core/commands/diagnose.md +0 -41
  33. package/src/core/commands/epic.md +8 -0
  34. package/src/core/commands/handoff.md +4 -0
  35. package/src/core/commands/impact.md +1 -1
  36. package/src/core/commands/metrics.md +10 -0
  37. package/src/core/commands/research.md +3 -0
  38. package/src/core/commands/retro.md +11 -1
  39. package/src/core/commands/sprint.md +2 -1
  40. package/src/core/commands/status.md +1 -0
  41. package/src/core/commands/story-validate.md +1 -1
  42. package/src/core/commands/story.md +29 -2
  43. package/src/core/commands/template.md +8 -0
  44. package/src/core/commands/update.md +1 -1
  45. package/src/core/commands/velocity.md +9 -0
  46. package/src/core/commands/verify.md +6 -0
  47. package/src/core/templates/validate-tokens.sh +0 -15
  48. package/src/core/templates/worktrees-guide.md +0 -4
  49. package/tools/agileflow-npx.js +21 -9
  50. package/tools/cli/commands/config.js +284 -0
  51. package/tools/cli/commands/doctor.js +221 -4
  52. package/tools/cli/commands/setup.js +4 -1
  53. package/tools/cli/commands/update.js +59 -15
  54. package/tools/cli/installers/core/installer.js +369 -37
  55. package/tools/cli/installers/ide/claude-code.js +1 -1
  56. package/tools/cli/installers/ide/cursor.js +1 -1
  57. package/tools/cli/installers/ide/windsurf.js +1 -1
  58. package/tools/cli/lib/docs-setup.js +52 -28
  59. package/tools/cli/lib/npm-utils.js +62 -0
  60. package/tools/cli/lib/ui.js +9 -2
  61. package/tools/postinstall.js +71 -13
  62. package/src/core/agents/context7.md +0 -164
  63. 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. Sync to external systems (Notion, GitHub) if enabled
98
- 9. Ensure minimal CI exists and passes
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. Sync externally → SlashCommand("/AgileFlow:github-sync"), SlashCommand("/AgileFlow:notion")
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. **[CRITICAL]** Immediately sync to external systems if enabled:
247
- - SlashCommand("/AgileFlow:notion DATABASE=stories") if `.mcp.json` has notion server
248
- - SlashCommand("/AgileFlow:github-sync") if GITHUB_REPO in .env or gh CLI configured
249
- 7. After implementation: update status.json in-review
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. Sync to Notion/GitHub
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]"
@@ -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. **[CRITICAL]** Immediately sync to external systems:
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
- 11. Complete implementation and tests
659
- 12. **[PROACTIVE]** After completing significant UI work, check if CLAUDE.md should be updated:
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
- 13. Update status.json: status → in-review
664
- 14. Append bus message: `{"ts":"<ISO>","from":"AG-UI","type":"status","story":"<US_ID>","text":"Implementation complete, ready for review"}`
665
- 15. **[CRITICAL]** Sync again after status change:
666
- - Invoke `/AgileFlow:notion DATABASE=stories`
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, invoke commands, and sync to Notion/GitHub automatically."
965
+ 6. Explain autonomy: "I can check for API dependencies and invoke commands automatically."