agileflow 2.51.0 → 2.56.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 (90) hide show
  1. package/README.md +80 -460
  2. package/package.json +18 -3
  3. package/scripts/agileflow-configure.js +134 -63
  4. package/scripts/agileflow-welcome.js +161 -31
  5. package/scripts/generators/agent-registry.js +45 -57
  6. package/scripts/generators/command-registry.js +48 -32
  7. package/scripts/generators/index.js +2 -6
  8. package/scripts/generators/inject-babysit.js +9 -2
  9. package/scripts/generators/inject-help.js +3 -1
  10. package/scripts/generators/inject-readme.js +7 -3
  11. package/scripts/generators/skill-registry.js +60 -33
  12. package/scripts/get-env.js +13 -12
  13. package/scripts/lib/frontmatter-parser.js +82 -0
  14. package/scripts/obtain-context.js +79 -26
  15. package/scripts/session-coordinator.sh +232 -0
  16. package/scripts/session-manager.js +512 -0
  17. package/src/core/agents/orchestrator.md +275 -0
  18. package/src/core/commands/adr.md +38 -16
  19. package/src/core/commands/agent.md +39 -22
  20. package/src/core/commands/assign.md +17 -0
  21. package/src/core/commands/auto.md +60 -46
  22. package/src/core/commands/babysit.md +302 -637
  23. package/src/core/commands/baseline.md +20 -0
  24. package/src/core/commands/blockers.md +33 -48
  25. package/src/core/commands/board.md +19 -0
  26. package/src/core/commands/changelog.md +20 -0
  27. package/src/core/commands/ci.md +17 -0
  28. package/src/core/commands/context.md +43 -40
  29. package/src/core/commands/debt.md +76 -45
  30. package/src/core/commands/deploy.md +20 -0
  31. package/src/core/commands/deps.md +40 -46
  32. package/src/core/commands/diagnose.md +24 -18
  33. package/src/core/commands/docs.md +18 -0
  34. package/src/core/commands/epic.md +31 -0
  35. package/src/core/commands/feedback.md +33 -21
  36. package/src/core/commands/handoff.md +29 -0
  37. package/src/core/commands/help.md +16 -7
  38. package/src/core/commands/impact.md +31 -61
  39. package/src/core/commands/metrics.md +17 -35
  40. package/src/core/commands/packages.md +21 -0
  41. package/src/core/commands/pr.md +15 -0
  42. package/src/core/commands/readme-sync.md +42 -9
  43. package/src/core/commands/research.md +58 -11
  44. package/src/core/commands/retro.md +42 -50
  45. package/src/core/commands/review.md +22 -27
  46. package/src/core/commands/session/end.md +53 -297
  47. package/src/core/commands/session/history.md +38 -257
  48. package/src/core/commands/session/init.md +44 -446
  49. package/src/core/commands/session/new.md +152 -0
  50. package/src/core/commands/session/resume.md +51 -447
  51. package/src/core/commands/session/status.md +32 -244
  52. package/src/core/commands/sprint.md +33 -0
  53. package/src/core/commands/status.md +18 -0
  54. package/src/core/commands/story-validate.md +32 -0
  55. package/src/core/commands/story.md +21 -6
  56. package/src/core/commands/template.md +18 -0
  57. package/src/core/commands/tests.md +22 -0
  58. package/src/core/commands/update.md +72 -58
  59. package/src/core/commands/validate-expertise.md +25 -37
  60. package/src/core/commands/velocity.md +33 -74
  61. package/src/core/commands/verify.md +16 -0
  62. package/src/core/experts/documentation/expertise.yaml +16 -2
  63. package/src/core/skills/agileflow-retro-facilitator/SKILL.md +57 -219
  64. package/src/core/skills/agileflow-retro-facilitator/cookbook/4ls.md +86 -0
  65. package/src/core/skills/agileflow-retro-facilitator/cookbook/glad-sad-mad.md +79 -0
  66. package/src/core/skills/agileflow-retro-facilitator/cookbook/start-stop-continue.md +142 -0
  67. package/src/core/skills/agileflow-retro-facilitator/prompts/action-items.md +83 -0
  68. package/src/core/skills/writing-skills/SKILL.md +352 -0
  69. package/src/core/skills/writing-skills/testing-skills-with-subagents.md +232 -0
  70. package/tools/cli/agileflow-cli.js +4 -2
  71. package/tools/cli/commands/config.js +20 -13
  72. package/tools/cli/commands/doctor.js +25 -9
  73. package/tools/cli/commands/list.js +10 -6
  74. package/tools/cli/commands/setup.js +54 -3
  75. package/tools/cli/commands/status.js +6 -8
  76. package/tools/cli/commands/uninstall.js +5 -5
  77. package/tools/cli/commands/update.js +51 -7
  78. package/tools/cli/installers/core/installer.js +8 -4
  79. package/tools/cli/installers/ide/_base-ide.js +58 -1
  80. package/tools/cli/installers/ide/claude-code.js +3 -61
  81. package/tools/cli/installers/ide/codex.js +440 -0
  82. package/tools/cli/installers/ide/cursor.js +21 -51
  83. package/tools/cli/installers/ide/manager.js +2 -6
  84. package/tools/cli/installers/ide/windsurf.js +20 -50
  85. package/tools/cli/lib/content-injector.js +26 -49
  86. package/tools/cli/lib/docs-setup.js +3 -2
  87. package/tools/cli/lib/npm-utils.js +39 -12
  88. package/tools/cli/lib/ui.js +31 -10
  89. package/tools/cli/lib/version-checker.js +3 -3
  90. package/tools/postinstall.js +2 -3
package/README.md CHANGED
@@ -3,531 +3,151 @@
3
3
  </p>
4
4
 
5
5
  [![npm version](https://img.shields.io/npm/v/agileflow?color=brightgreen)](https://www.npmjs.com/package/agileflow)
6
- [![Commands](https://img.shields.io/badge/commands-41-blue)](#commands)
7
- [![Subagents](https://img.shields.io/badge/subagents-26-orange)](SUBAGENTS.md)
8
- [![Skills](https://img.shields.io/badge/skills-23-purple)](#skills)
6
+ [![Commands](https://img.shields.io/badge/commands-41-blue)](docs/04-architecture/commands.md)
7
+ [![Agents/Experts](https://img.shields.io/badge/agents%2Fexperts-26-orange)](docs/04-architecture/subagents.md)
8
+ [![Skills](https://img.shields.io/badge/skills-23-purple)](docs/04-architecture/skills.md)
9
9
 
10
- **AI-driven agile development for Claude Code, Cursor, Windsurf, and more.** Combining Scrum, Kanban, ADRs, and docs-as-code principles into one framework-agnostic system.
10
+ **AI-driven agile development for Claude Code, Cursor, Windsurf, OpenAI Codex CLI, and more.** Combining Scrum, Kanban, ADRs, and docs-as-code principles into one framework-agnostic system.
11
+
12
+ ---
11
13
 
12
14
  ## Quick Start
13
15
 
14
16
  ### Installation
15
17
 
16
- #### Option 1: Global Installation (Recommended)
17
-
18
+ **Global (Recommended):**
18
19
  ```bash
19
20
  npm install -g agileflow
20
21
  agileflow setup
21
22
  ```
22
23
 
23
- #### Option 2: Project-Level Installation
24
-
24
+ **Project-Level:**
25
25
  ```bash
26
26
  npm install agileflow
27
27
  npx agileflow setup
28
28
  ```
29
29
 
30
- This will:
31
- 1. Prompt where to install AgileFlow
32
- 2. Prompt to select your IDE(s)
33
- 3. Install AgileFlow core (commands, agents, skills)
34
- 4. Configure your selected IDEs
35
- 5. Create documentation structure
36
-
37
- ### CLI Commands
38
-
39
- **Global installation:**
40
- ```bash
41
- agileflow setup # Set up AgileFlow in project
42
- agileflow status # Check installation + updates
43
- agileflow update # Update to latest version
44
- agileflow list # List installed components
45
- agileflow doctor # Diagnose issues
46
- agileflow uninstall # Remove from project
47
- ```
48
-
49
- **Project-level installation (use `npx`):**
50
- ```bash
51
- npx agileflow setup # Set up AgileFlow in project
52
- npx agileflow status # Check installation + updates
53
- npx agileflow update # Update to latest version
54
- npx agileflow list # List installed components
55
- npx agileflow doctor # Diagnose issues
56
- npx agileflow uninstall # Remove from project
57
- ```
58
-
59
30
  ### After Setup
60
31
 
61
- **Initialize the system:**
62
- ```
63
- /agileflow:setup
64
- ```
65
- Scaffolds docs structure, templates, and optional CI configuration.
66
-
67
- **Get help:**
68
- ```
69
- /agileflow:help
70
- ```
71
- View system overview and available commands.
72
-
73
- **Use the mentor (recommended):**
74
- ```
75
- Use the mentor subagent to guide me through implementing <feature>
32
+ ```bash
33
+ /agileflow:help # View all commands
34
+ /agileflow:babysit # Interactive mentor for implementation
35
+ /agileflow:configure # Configure hooks, status line, etc.
76
36
  ```
77
- Interactive mentor guides you through epic/story creation, implementation, and PR preparation.
78
37
 
79
38
  ### Supported IDEs
80
39
 
81
40
  | IDE | Status | Config Location |
82
41
  |-----|--------|-----------------|
83
- | Claude Code | Supported | `.claude/commands/agileflow/` |
84
- | Cursor | Supported | `.cursor/rules/agileflow/` |
85
- | Windsurf | Supported | `.windsurf/workflows/agileflow/` |
42
+ | Claude Code | Supported | `.claude/commands/agileflow/` |
43
+ | Cursor | Supported | `.cursor/rules/agileflow/` |
44
+ | Windsurf | Supported | `.windsurf/workflows/agileflow/` |
45
+ | OpenAI Codex CLI | Supported | `.codex/skills/` |
46
+
47
+ ---
86
48
 
87
49
  ## Why AgileFlow?
88
50
 
89
51
  AgileFlow combines three proven methodologies:
90
52
 
91
- - **Agile (Scrum/Kanban)** - Break work into Epics → Stories → Acceptance Criteria with WIP limits
53
+ - **Agile (Scrum/Kanban)** - Break work into Epics → Stories → Acceptance Criteria
92
54
  - **ADRs** - Record architectural decisions so future teams don't re-debate
93
- - **Docs-as-Code** - Humans and AI agents coordinate via versioned files (traceable, reviewable, automatable)
55
+ - **Docs-as-Code** - Humans and AI agents coordinate via versioned files
94
56
 
95
57
  **Key Benefits:**
96
58
  - Clear priorities and testable increments
97
59
  - Durable memory and decision history
98
- - Effortless multi-agent collaboration via message bus
60
+ - Multi-agent collaboration via message bus
99
61
  - Works with any tech stack or framework
100
62
 
101
- <details>
102
- <summary><strong>📁 Folder Structure</strong> (click to expand)</summary>
103
-
104
- After running `/agileflow:setup`:
105
-
106
- ```
107
- docs/
108
- 00-meta/ # Templates, glossary, conventions
109
- 01-brainstorming/ # Ideas and sketches
110
- 02-practices/ # Testing, git, CI, security practices
111
- prompts/agents/ # Agent profiles and contracts
112
- 03-decisions/ # ADRs (Architecture Decision Records)
113
- 04-architecture/ # Architecture documentation
114
- 05-epics/ # Epic definitions
115
- 06-stories/ # User stories (grouped by epic)
116
- 07-testing/ # Test cases and acceptance criteria
117
- 08-project/ # Roadmap, backlog, milestones, risks
118
- 09-agents/ # Agent status and message bus
119
- bus/log.jsonl # Agent communication log
120
- status.json # Current story statuses
121
- 10-research/ # Saved research notes
122
- context.md # One-page context brief for web AI tools
123
- ```
124
-
125
- </details>
126
-
127
- <details>
128
- <summary><strong>📚 Commands</strong> (41 total - click to expand)</summary>
129
-
130
- ### Core Workflow
131
- - `/agileflow:setup` - Bootstrap the entire system
132
- - `/agileflow:help` - Display system overview
133
- - `/agileflow:babysit` - Interactive mentor for end-to-end implementation
134
-
135
- ### Planning & Structure
136
- - `/agileflow:epic` - Create a new epic
137
- - `/agileflow:story` - Create a user story with acceptance criteria
138
- - `/agileflow:story-validate` - Validate story completeness before development
139
- - `/agileflow:sprint` - Data-driven sprint planning with velocity forecasting
140
- - `/agileflow:adr` - Create an Architecture Decision Record
141
- - `/agileflow:agent` - Onboard a new agent
142
-
143
- ### Task Management
144
- - `/agileflow:assign` - Assign/reassign a story
145
- - `/agileflow:status` - Update story status
146
- - `/agileflow:handoff` - Document handoff between agents
147
-
148
- ### Quality & CI
149
- - `/agileflow:pr` - Generate PR description
150
- - `/agileflow:ci` - Bootstrap CI workflow
151
- - `/agileflow:readme-sync` - Sync folder READMEs
152
- - `/agileflow:tests` - Automated testing infrastructure setup
153
- - `/agileflow:review` - AI-powered code review
154
- - `/agileflow:verify` - Run tests and update story test status (Session Harness)
155
- - `/agileflow:session-init` - Initialize session harness with test verification (Phase 2)
156
- - `/agileflow:resume` - Resume session with environment verification and context (Phase 2)
157
- - `/agileflow:baseline` - Mark current state as verified baseline (Phase 2)
158
- - `/agileflow:compress` - Compress status.json (fixes token limit issues)
159
-
160
- ### Automation & DevOps
161
- - `/agileflow:packages` - Manage dependencies (dashboard, updates, security audits)
162
- - `/agileflow:docs` - Synchronize docs with code changes
163
- - `/agileflow:impact` - Analyze change impact on codebase
164
- - `/agileflow:debt` - Track and prioritize technical debt
165
- - `/agileflow:deploy` - Automated deployment pipeline setup
166
- - `/agileflow:changelog` - Auto-generate changelog from commits
167
- - `/agileflow:auto` - Generate stories from PRDs/mockups/specs
168
- - `/agileflow:template` - Create and manage custom templates
169
- - `/agileflow:feedback` - Collect feedback for continuous improvement
170
- - `/agileflow:update` - Generate stakeholder reports
171
-
172
- ### Visualization & Analytics
173
- - `/agileflow:board` - Visual kanban board with WIP limits
174
- - `/agileflow:blockers` - Comprehensive blocker tracking with resolution suggestions
175
- - `/agileflow:velocity` - Velocity tracking and forecasting
176
- - `/agileflow:metrics` - Analytics dashboard (cycle time, lead time, throughput, flow efficiency)
177
- - `/agileflow:retro` - Automated retrospective generator with insights
178
- - `/agileflow:deps` - Dependency graph visualization with critical path detection
179
-
180
- ### Web AI Integration
181
- - `/agileflow:context` - Generate/export/manage context for web AI tools (ChatGPT, Perplexity, Gemini, Claude, etc.)
182
- - `/agileflow:research` - Save research notes
183
-
184
- </details>
185
-
186
- <details>
187
- <summary><strong>🤖 Subagents</strong> (26 specialized agents - click to expand)</summary>
188
-
189
- AgileFlow includes **26 specialized subagents** that operate in separate context windows for focused work. See [SUBAGENTS.md](SUBAGENTS.md) for complete documentation.
190
-
191
- ### Core Implementation Agents
192
-
193
- **`ui`** - UI/Presentation Layer Specialist
194
- - Front-end components, styling, theming, accessibility (WCAG 2.1 AA)
195
- - Invocation: "Use the ui subagent to implement this UI feature"
196
-
197
- **`api`** - Services/Data Layer Specialist
198
- - Backend APIs, business logic, data models, API tests
199
- - Invocation: "Use the api subagent to implement this API endpoint"
200
-
201
- **`ci`** - CI/CD & Quality Specialist
202
- - CI/CD pipelines, linting, type checking, test coverage
203
- - Invocation: "Use the ci subagent to set up the test pipeline"
204
-
205
- ### Orchestration & Planning Agents
206
-
207
- **`mentor`** - End-to-End Implementation Mentor
208
- - Guides feature implementation from idea to PR
209
- - Invocation: "Use the mentor subagent to guide me through this feature"
210
-
211
- **`epic-planner`** - Epic & Story Planning Specialist
212
- - Breaks down features into epics and stories with acceptance criteria
213
- - Invocation: "Use the epic-planner subagent to plan this feature"
214
-
215
- **`adr-writer`** - Architecture Decision Record Specialist
216
- - Documents technical decisions, trade-offs, alternatives
217
- - Invocation: "Use the adr-writer subagent to document this decision"
218
-
219
- **`research`** - Research & Knowledge Management Specialist
220
- - Conducts technical research, builds research prompts, saves notes
221
- - Invocation: "Use the research subagent to research authentication approaches"
222
-
223
- ### Additional Specialized Agents
224
- - `devops` - DevOps & Automation
225
- - `security` - Security & Compliance
226
- - `database` - Database & Data Layer
227
- - `testing` - Testing & QA Automation
228
- - `product` - Product Management & Prioritization
229
- - `performance` - Performance Optimization
230
- - `mobile` - Mobile Development
231
- - `integrations` - Third-Party Integrations
232
- - `refactor` - Code Refactoring & Technical Debt
233
- - `design` - Design Systems & UI/UX
234
- - `accessibility` - Accessibility Compliance (WCAG)
235
- - `analytics` - Analytics & Metrics Implementation
236
- - `datamigration` - Data Migration & ETL
237
- - `qa` - Quality Assurance & Test Planning
238
- - And more...
239
-
240
- **When to Use Subagents:**
241
- - Complex, multi-step implementation work
242
- - Specialized tasks requiring focused expertise
243
- - Work benefiting from separate context
244
- - Tasks needing to run commands or write code
245
-
246
- **When to Use Commands:**
247
- - Quick, single-purpose actions
248
- - Status updates and assignments
249
- - Generating templates or prompts
250
- - Simple file operations
251
-
252
- </details>
253
-
254
- <details>
255
- <summary><strong>🎯 Skills</strong> (23 auto-loaded skills - click to expand)</summary>
256
-
257
- Skills are **context-aware helpers** that activate automatically based on keywords (no manual invocation needed).
258
-
259
- ### How Skills Work
260
- - **Activation:** Automatic (keyword-based detection)
261
- - **Context:** Main conversation
262
- - **Purpose:** Quick enhancements and formatting
263
- - **Structure:** Follow Anthropic's minimal specification (v2.21.0+)
264
-
265
- ### Skills by Category
266
-
267
- #### AgileFlow Skills (8 skills)
268
- Auto-formatted outputs following AgileFlow templates:
269
- - `agileflow-story-writer` - Converts discussions to user stories
270
- - `agileflow-acceptance-criteria` - Generates Given/When/Then AC
271
- - `epic-planner` - Breaks features into epics/stories
272
- - `agileflow-sprint-planner` - Plans sprints with velocity
273
- - `agileflow-retro-facilitator` - Structures retrospectives
274
- - `agileflow-adr` - Captures architectural decisions
275
- - `agileflow-commit-messages` - Formats Conventional Commits
276
- - `agileflow-tech-debt` - Tracks technical debt
277
-
278
- #### Template Generators (15 skills)
279
- Generate code templates and documentation:
280
- - `story-skeleton` - Story template scaffolding
281
- - `acceptance-criteria-generator` - AC formatting
282
- - `commit-message-formatter` - Git commit messages
283
- - `adr-template` - Architecture decision records
284
- - `api-documentation-generator` - OpenAPI/Swagger docs
285
- - `changelog-entry` - Keep a Changelog format
286
- - `pr-description` - Pull request descriptions
287
- - `test-case-generator` - Test cases from AC
288
- - `type-definitions` - TypeScript interfaces
289
- - `sql-schema-generator` - SQL schemas with migrations
290
- - `error-handler-template` - Error handling patterns
291
- - `diagram-generator` - Mermaid/ASCII diagrams
292
- - `validation-schema-generator` - Joi/Zod/Yup schemas
293
- - `deployment-guide-generator` - Deployment runbooks
294
- - `migration-checklist` - Data migration checklists
295
-
296
- ### Example Activation
297
- ```
298
- User: "I need to create a user story for login functionality"
299
- [agileflow-story-writer skill activates automatically]
300
- Claude: Generates formatted story with AC, owner, priority, estimate
301
- ```
302
-
303
- </details>
304
-
305
- <details>
306
- <summary><strong>🎯 Hooks System</strong> (event-driven automation - click to expand)</summary>
307
-
308
- AgileFlow supports **event-driven automation** through Claude Code's official hooks system.
309
-
310
- ### What Are Hooks?
311
-
312
- Hooks are automatic triggers that execute commands in response to events:
313
- - **SessionStart** - Runs when Claude Code session starts
314
- - **UserPromptSubmit** - Runs after you submit a prompt
315
- - **Stop** - Runs when Claude stops responding
316
-
317
- ### Quick Setup
318
-
319
- 1. **Create .claude directory:**
320
- ```bash
321
- mkdir -p .claude
322
- ```
323
-
324
- 2. **Copy template:**
325
- ```bash
326
- cp templates/claude-settings.example.json .claude/settings.json
327
- ```
328
-
329
- 3. **Customize hooks** (edit `.claude/settings.json`):
330
- ```json
331
- {
332
- "hooks": {
333
- "SessionStart": [{
334
- "hooks": [{
335
- "type": "command",
336
- "command": "echo '🚀 AgileFlow loaded - Type /agileflow:help'"
337
- }]
338
- }]
339
- }
340
- }
341
- ```
342
-
343
- 4. **Restart Claude Code**
344
-
345
- ### Example Use Cases
346
-
347
- **Welcome message:**
348
- ```json
349
- {
350
- "SessionStart": [{
351
- "hooks": [{
352
- "type": "command",
353
- "command": "echo '👋 Welcome! Current sprint: $(cat docs/08-project/current-sprint.txt)'"
354
- }]
355
- }]
356
- }
357
- ```
358
-
359
- **Activity logging:**
360
- ```json
361
- {
362
- "UserPromptSubmit": [{
363
- "hooks": [{
364
- "type": "command",
365
- "command": "echo '[LOG] Prompt at $(date)' >> .claude/activity.log"
366
- }]
367
- }]
368
- }
369
- ```
63
+ ---
370
64
 
371
- ### Configuration Files
372
- - `.claude/settings.json` - Project-level config (committed to git)
373
- - `.claude/settings.local.json` - User-specific overrides (gitignored)
65
+ ## Core Components
374
66
 
375
- </details>
67
+ | Component | Count | Description |
68
+ |-----------|-------|-------------|
69
+ | [Commands](docs/04-architecture/commands.md) | 41 | Slash commands for agile workflows |
70
+ | [Agents/Experts](docs/04-architecture/subagents.md) | 26 | Specialized agents with self-improving knowledge bases |
71
+ | [Skills](docs/04-architecture/skills.md) | 23 | Auto-activated context helpers |
376
72
 
377
- <details>
378
- <summary><strong>🔧 Advanced Topics</strong> (click to expand)</summary>
73
+ ---
379
74
 
380
- ### Daily Workflow
75
+ ## Documentation
381
76
 
382
- 1. **Pick a story** - Use `mentor` or check `docs/09-agents/status.json`
383
- 2. **Implement to AC** - Follow acceptance criteria
384
- 3. **Write tests** - Reference `docs/07-testing/test-cases/<STORY_ID>.md`
385
- 4. **Update status** - Use `/agileflow:status`
386
- 5. **Create PR** - Use `/agileflow:pr`
387
- 6. **Mark done** - Update status after merge
77
+ Full documentation lives in [`docs/04-architecture/`](docs/04-architecture/):
388
78
 
389
- ### Multi-Agent Collaboration
79
+ ### Reference
80
+ - [Commands](docs/04-architecture/commands.md) - All 41 slash commands
81
+ - [Agents/Experts](docs/04-architecture/subagents.md) - 26 specialized agents with self-improving knowledge
82
+ - [Skills](docs/04-architecture/skills.md) - 23 auto-loaded skills
390
83
 
391
- AgileFlow uses a message bus (`docs/09-agents/bus/log.jsonl`) for coordination:
392
- - Agents update `docs/09-agents/status.json` with current work
393
- - Messages logged to bus for async communication
394
- - Use `/agileflow:handoff` to transfer work between agents
395
- - WIP limit: max 2 stories per agent
84
+ ### Architecture
85
+ - [AgileFlow CLI Overview](docs/04-architecture/agileflow-cli-overview.md) - System architecture
86
+ - [Agent Expert System](docs/04-architecture/agent-expert-system.md) - Self-improving agents
87
+ - [Multi-Expert Orchestration](docs/04-architecture/multi-expert-orchestration.md) - Parallel expert analysis
88
+ - [Multi-Session Coordination](docs/04-architecture/multi-session-coordination.md) - Parallel Claude Code sessions
396
89
 
397
- ### Git Worktrees for Context Preservation
90
+ ### Configuration
91
+ - [Configuration System](docs/04-architecture/configuration-system.md) - 8 configuration agents
92
+ - [Hooks System](docs/04-architecture/hooks-system.md) - Event-driven automation
93
+ - [Session Harness](docs/04-architecture/session-harness.md) - Test verification and sessions
94
+ - [PreCompact Context](docs/04-architecture/precompact-context.md) - Context preservation during compacts
398
95
 
399
- For advanced users handling urgent hotfixes during feature work:
96
+ ---
400
97
 
401
- **Benefits:**
402
- - Preserve AI context when switching tasks
403
- - Handle production bugs without losing feature flow
404
- - Compare implementations side-by-side
405
- - Test risky refactors in isolation
98
+ ## Examples
406
99
 
407
- **Quick Start:**
100
+ ### Create an Epic with Stories
408
101
  ```bash
409
- # Use helper script (created by /agileflow:setup)
410
- ./docs/00-meta/scripts/worktree-create.sh auth-hotfix
411
-
412
- # Open in new window
413
- code ../myapp-auth-hotfix
414
- /agileflow:babysit
102
+ /agileflow:epic EPIC=EP-0001 TITLE="User Authentication" OWNER=AG-API GOAL="Secure login"
415
103
  ```
416
104
 
417
- See `docs/00-meta/guides/worktrees.md` for comprehensive guide.
418
-
419
- ### Web AI Integration
420
-
421
- Share context with web AI tools (ChatGPT, Perplexity, Gemini, Claude, etc.):
422
-
423
- 1. Run `/agileflow:context` to generate/refresh context
424
- 2. Use `/agileflow:context MODE=export` for concise excerpt
425
- 3. Paste into web AI tool for research/ideation
426
- 4. Use `/agileflow:context MODE=research TOPIC="..."` for structured prompts
427
- 5. Save results with `/agileflow:research`
428
-
429
- ### Session Harness System (v2.24.0+)
430
-
431
- Ensures test verification and session continuity for long-running projects. Prevents agents from breaking functionality and maintains progress across context windows.
432
-
433
- **The Problem:**
434
- Without verification, agents can:
435
- - Break existing functionality without noticing
436
- - Claim features work when tests fail
437
- - Lose context between sessions
438
- - Mark incomplete work as finished
439
-
440
- **The Solution:**
441
- Session Harness System tracks test status, verifies baselines, and maintains session state.
442
-
443
- **Quick Start:**
105
+ ### Work on a Story
444
106
  ```bash
445
- # First time setup (interactive)
446
- /agileflow:session-init
447
-
448
- # Start each session (or auto-run via hook)
449
- /agileflow:resume
450
-
451
- # Run tests and update test status
452
- /agileflow:verify
453
-
454
- # Create verified checkpoint
455
- /agileflow:baseline "Sprint 12 complete"
107
+ /agileflow:assign STORY=US-0001 NEW_OWNER=AG-UI NEW_STATUS=in-progress
108
+ # ... implement ...
109
+ /agileflow:status STORY=US-0001 STATUS=in-review SUMMARY="Login form complete"
456
110
  ```
457
111
 
458
- **How It Works:**
459
- 1. **Test Tracking**: Every story has `test_status` field (passing/failing/not_run)
460
- 2. **Pre-Implementation**: Agents check test_status before starting work
461
- 3. **Post-Implementation**: Agents run `/agileflow:verify` before marking complete
462
- 4. **Session Resume**: Loads context and detects regressions
463
- 5. **Baselines**: Git tags mark known-good states for reset points
464
-
465
- **Benefits:**
466
- - **No Broken Baselines**: Agents can't mark stories complete with failing tests
467
- - **Fail Fast**: Catch regressions immediately, not at PR review
468
- - **Context Continuity**: Structured handoff between sessions
469
- - **Regression Detection**: Alerts when tests were passing, now failing
470
-
471
- **Agent Integration (v2.26.0):**
472
- All 18 dev agents now include verification protocol:
473
- - ui, api, ci, devops
474
- - security, database, testing
475
- - performance, mobile, integrations
476
- - refactor, design, accessibility
477
- - analytics, datamigration, monitoring
478
- - compliance, qa
479
-
480
- **Learn More:** See CLAUDE.md "Session Harness System" section for complete documentation.
481
-
482
- ### Status.json Compression
483
-
484
- Prevent "file too large" errors:
485
-
112
+ ### Use Multi-Expert Analysis
486
113
  ```bash
487
- # Compress status.json (removes verbose fields)
488
- /agileflow:compress
489
-
490
- # Typical result: 80-90% size reduction
114
+ /agileflow:multi-expert Is this authentication implementation secure?
491
115
  ```
492
116
 
493
- Full story content remains in `docs/06-stories/` markdown files (no data loss).
117
+ ### Work in Parallel Sessions
118
+ ```bash
119
+ /agileflow:session:new # Create isolated workspace
120
+ /agileflow:session:status # View all sessions
121
+ ```
494
122
 
495
- </details>
123
+ ---
496
124
 
497
- ## Examples
125
+ ## Project Structure
498
126
 
499
- ### Creating an Epic with Stories
500
- ```
501
- /agileflow:epic EPIC=EP-0001 TITLE="User Authentication" OWNER=AG-API GOAL="Secure user login and registration" STORIES="US-0001|Login form|AG-UI,US-0002|Auth API|AG-API"
502
- ```
127
+ After running `agileflow setup`:
503
128
 
504
- ### Working on a Story
505
129
  ```
506
- /agileflow:assign STORY=US-0001 NEW_OWNER=AG-UI NEW_STATUS=in-progress NOTE="Starting implementation"
507
- # ... do the work ...
508
- /agileflow:status STORY=US-0001 STATUS=in-review SUMMARY="Login form complete with tests" PR=https://github.com/...
509
- ```
510
-
511
- ### Recording a Decision
512
- ```
513
- /agileflow:adr NUMBER=0001 TITLE="Use JWT for authentication" CONTEXT="Need stateless auth for API" DECISION="JWT with 15min access + refresh tokens" CONSEQUENCES="Simpler scaling but requires token refresh flow"
130
+ docs/
131
+ 00-meta/ # Templates, conventions
132
+ 01-brainstorming/ # Ideas and sketches
133
+ 02-practices/ # Testing, git, CI practices
134
+ 03-decisions/ # ADRs
135
+ 04-architecture/ # Architecture documentation
136
+ 05-epics/ # Epic definitions
137
+ 06-stories/ # User stories
138
+ 07-testing/ # Test cases
139
+ 08-project/ # Roadmap, backlog
140
+ 09-agents/ # Agent status, message bus
141
+ 10-research/ # Research notes
514
142
  ```
515
143
 
516
- ## Templates
517
-
518
- All templates are located in `templates/` and `docs/00-meta/templates/`:
144
+ ---
519
145
 
520
- - `epic-template.md` - Epic structure
521
- - `story-template.md` - User story format
522
- - `adr-template.md` - Architecture decision record
523
- - `agent-profile-template.md` - Agent profile and contract
524
- - `comms-note-template.md` - Handoff documentation
525
- - `research-template.md` - Research note structure
526
- - `README-template.md` - Folder README template
146
+ ## Online Documentation
527
147
 
528
- ## Contributing
148
+ Visit [projectquestorg.com](https://projectquestorg.com) for the full documentation site.
529
149
 
530
- This plugin is designed to be framework-agnostic. Customize templates and commands to fit your team's workflow.
150
+ ---
531
151
 
532
152
  ## License
533
153
 
@@ -535,4 +155,4 @@ MIT
535
155
 
536
156
  ## Support
537
157
 
538
- For issues or questions, please visit the [GitHub repository](https://github.com/projectquestorg/AgileFlow).
158
+ For issues or questions, visit the [GitHub repository](https://github.com/projectquestorg/AgileFlow).
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agileflow",
3
- "version": "2.51.0",
3
+ "version": "2.56.0",
4
4
  "description": "AI-driven agile development system for Claude Code, Cursor, Windsurf, and more",
5
5
  "keywords": [
6
6
  "agile",
@@ -41,8 +41,14 @@
41
41
  "agileflow:setup": "node tools/cli/agileflow-cli.js setup",
42
42
  "agileflow:status": "node tools/cli/agileflow-cli.js status",
43
43
  "agileflow:update": "node tools/cli/agileflow-cli.js update",
44
- "lint": "echo 'No linting configured yet'",
45
- "test": "echo 'No tests configured yet'"
44
+ "lint": "eslint .",
45
+ "lint:strict": "eslint . --max-warnings 0",
46
+ "lint:fix": "eslint . --fix",
47
+ "format": "prettier --write .",
48
+ "format:check": "prettier --check .",
49
+ "test": "jest",
50
+ "test:watch": "jest --watch",
51
+ "test:coverage": "jest --coverage"
46
52
  },
47
53
  "dependencies": {
48
54
  "chalk": "^4.1.2",
@@ -58,5 +64,14 @@
58
64
  },
59
65
  "publishConfig": {
60
66
  "access": "public"
67
+ },
68
+ "devDependencies": {
69
+ "@eslint/js": "^9.39.2",
70
+ "eslint": "^9.39.2",
71
+ "eslint-config-prettier": "^10.1.8",
72
+ "eslint-plugin-prettier": "^5.5.4",
73
+ "globals": "^16.5.0",
74
+ "jest": "^30.2.0",
75
+ "prettier": "^3.7.4"
61
76
  }
62
77
  }