agileflow 2.36.2 → 2.37.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (85) hide show
  1. package/README.md +64 -64
  2. package/package.json +1 -1
  3. package/src/core/agents/accessibility.md +14 -14
  4. package/src/core/agents/adr-writer.md +5 -5
  5. package/src/core/agents/analytics.md +14 -14
  6. package/src/core/agents/api.md +22 -22
  7. package/src/core/agents/ci.md +20 -20
  8. package/src/core/agents/compliance.md +14 -14
  9. package/src/core/agents/configuration/archival.md +1 -1
  10. package/src/core/agents/configuration/ci.md +3 -3
  11. package/src/core/agents/configuration/hooks.md +1 -1
  12. package/src/core/agents/configuration/status-line.md +420 -0
  13. package/src/core/agents/database.md +18 -18
  14. package/src/core/agents/datamigration.md +14 -14
  15. package/src/core/agents/design.md +14 -14
  16. package/src/core/agents/devops.md +38 -38
  17. package/src/core/agents/documentation.md +4 -4
  18. package/src/core/agents/epic-planner.md +7 -7
  19. package/src/core/agents/integrations.md +17 -17
  20. package/src/core/agents/mentor.md +33 -33
  21. package/src/core/agents/mobile.md +15 -15
  22. package/src/core/agents/monitoring.md +14 -14
  23. package/src/core/agents/performance.md +16 -16
  24. package/src/core/agents/product.md +6 -6
  25. package/src/core/agents/qa.md +14 -14
  26. package/src/core/agents/readme-updater.md +2 -2
  27. package/src/core/agents/refactor.md +16 -16
  28. package/src/core/agents/security.md +20 -20
  29. package/src/core/agents/testing.md +16 -16
  30. package/src/core/agents/ui.md +23 -23
  31. package/src/core/commands/adr.md +5 -4
  32. package/src/core/commands/agent.md +1 -0
  33. package/src/core/commands/auto.md +1 -1
  34. package/src/core/commands/babysit.md +141 -70
  35. package/src/core/commands/baseline.md +34 -16
  36. package/src/core/commands/blockers.md +7 -7
  37. package/src/core/commands/board.md +1 -1
  38. package/src/core/commands/changelog.md +15 -9
  39. package/src/core/commands/compress.md +23 -5
  40. package/src/core/commands/configure.md +44 -9
  41. package/src/core/commands/context.md +6 -6
  42. package/src/core/commands/debt.md +1 -1
  43. package/src/core/commands/deps.md +10 -10
  44. package/src/core/commands/diagnose.md +11 -1
  45. package/src/core/commands/docs.md +2 -1
  46. package/src/core/commands/handoff.md +1 -0
  47. package/src/core/commands/help.md +9 -0
  48. package/src/core/commands/impact.md +2 -1
  49. package/src/core/commands/metrics.md +12 -12
  50. package/src/core/commands/multi-expert.md +1 -1
  51. package/src/core/commands/packages.md +12 -12
  52. package/src/core/commands/pr.md +1 -0
  53. package/src/core/commands/readme-sync.md +59 -87
  54. package/src/core/commands/retro.md +12 -12
  55. package/src/core/commands/review.md +2 -1
  56. package/src/core/commands/session/end.md +8 -8
  57. package/src/core/commands/session/history.md +13 -13
  58. package/src/core/commands/session/init.md +16 -16
  59. package/src/core/commands/session/resume.md +17 -17
  60. package/src/core/commands/session/status.md +14 -14
  61. package/src/core/commands/sprint.md +5 -5
  62. package/src/core/commands/story-validate.md +4 -3
  63. package/src/core/commands/story.md +1 -0
  64. package/src/core/commands/template.md +3 -3
  65. package/src/core/commands/tests.md +15 -0
  66. package/src/core/commands/update.md +1 -1
  67. package/src/core/commands/velocity.md +2 -2
  68. package/src/core/commands/verify.md +27 -9
  69. package/src/core/skills/agileflow-tech-debt/SKILL.md +2 -2
  70. package/src/core/templates/README-template.md +1 -1
  71. package/src/core/templates/agent-profile-template.md +1 -1
  72. package/src/core/templates/agileflow-statusline.sh +161 -0
  73. package/src/core/templates/claude-settings.advanced.example.json +2 -2
  74. package/src/core/templates/claude-settings.example.json +1 -1
  75. package/src/core/templates/resume-session.sh +2 -2
  76. package/src/core/templates/worktrees-guide.md +11 -11
  77. package/tools/cli/commands/config.js +1 -1
  78. package/tools/cli/commands/doctor.js +1 -1
  79. package/tools/cli/commands/status.js +1 -1
  80. package/tools/cli/commands/uninstall.js +1 -1
  81. package/tools/cli/installers/ide/claude-code.js +1 -1
  82. package/tools/cli/installers/ide/cursor.js +2 -2
  83. package/tools/cli/lib/content-injector.js +1 -1
  84. package/tools/cli/lib/docs-setup.js +22 -32
  85. package/tools/postinstall.js +1 -1
@@ -86,7 +86,7 @@ module.exports = {
86
86
  */
87
87
  function getIdeConfigPath(projectDir, ide) {
88
88
  const paths = {
89
- 'claude-code': '.claude/commands/AgileFlow',
89
+ 'claude-code': '.claude/commands/agileflow',
90
90
  'cursor': '.cursor/rules/agileflow',
91
91
  'windsurf': '.windsurf/workflows/agileflow',
92
92
  };
@@ -31,7 +31,7 @@ class ClaudeCodeSetup extends BaseIdeSetup {
31
31
  // Clean up old installation first
32
32
  await this.cleanup(projectDir);
33
33
 
34
- // Create .claude/commands/AgileFlow directory
34
+ // Create .claude/commands/agileflow directory
35
35
  const claudeDir = path.join(projectDir, this.configDir);
36
36
  const commandsDir = path.join(claudeDir, this.commandsDir);
37
37
  const agileflowCommandsDir = path.join(commandsDir, 'AgileFlow');
@@ -32,7 +32,7 @@ class CursorSetup extends BaseIdeSetup {
32
32
  // Clean up old installation first
33
33
  await this.cleanup(projectDir);
34
34
 
35
- // Create .cursor/commands/AgileFlow directory
35
+ // Create .cursor/commands/agileflow directory
36
36
  const cursorDir = path.join(projectDir, this.configDir);
37
37
  const commandsDir = path.join(cursorDir, this.commandsDir);
38
38
  const agileflowCommandsDir = path.join(commandsDir, 'AgileFlow');
@@ -110,7 +110,7 @@ class CursorSetup extends BaseIdeSetup {
110
110
  console.log(chalk.dim(` Removed old AgileFlow rules from ${this.displayName}`));
111
111
  }
112
112
 
113
- // Remove .cursor/commands/AgileFlow (for re-installation)
113
+ // Remove .cursor/commands/agileflow (for re-installation)
114
114
  const commandsPath = path.join(projectDir, this.configDir, this.commandsDir, 'AgileFlow');
115
115
  if (await this.exists(commandsPath)) {
116
116
  await fs.remove(commandsPath);
@@ -115,7 +115,7 @@ function generateCommandList(commandsDir) {
115
115
 
116
116
  commands.forEach(cmd => {
117
117
  const argHint = cmd.argumentHint ? ` ${cmd.argumentHint}` : '';
118
- output += `- \`/AgileFlow:${cmd.name}${argHint}\` - ${cmd.description}\n`;
118
+ output += `- \`/agileflow:${cmd.name}${argHint}\` - ${cmd.description}\n`;
119
119
  });
120
120
 
121
121
  return output;
@@ -13,6 +13,21 @@ const chalk = require('chalk');
13
13
  const packageJsonPath = path.join(__dirname, '..', '..', '..', 'package.json');
14
14
  const packageJson = require(packageJsonPath);
15
15
 
16
+ // Load package README.md for docs/README.md
17
+ const packageReadmePath = path.join(__dirname, '..', '..', '..', 'README.md');
18
+ let packageReadme = '';
19
+ try {
20
+ packageReadme = fs.readFileSync(packageReadmePath, 'utf8');
21
+ // Fix relative image paths to use npm CDN
22
+ packageReadme = packageReadme.replace(
23
+ /src="assets\//g,
24
+ 'src="https://cdn.jsdelivr.net/npm/agileflow/assets/'
25
+ );
26
+ } catch (e) {
27
+ // Fallback if README not found
28
+ packageReadme = '# AgileFlow\n\nSee https://github.com/projectquestorg/AgileFlow for documentation.';
29
+ }
30
+
16
31
  /**
17
32
  * Directory structure to create
18
33
  * @param {string} docsFolder - Name of the docs folder (default: "docs")
@@ -43,32 +58,7 @@ function getDirectoryStructure(docsFolder = 'docs') {
43
58
  */
44
59
  function getReadmeTemplates(docsFolder = 'docs') {
45
60
  return {
46
- [`${docsFolder}/README.md`]: `# AgileFlow Documentation
47
-
48
- This directory contains all AgileFlow documentation and project management files.
49
-
50
- ## Directory Structure
51
-
52
- - **00-meta/**: System metadata, templates, and guides
53
- - **01-brainstorming/**: Ideas and sketches for features
54
- - **02-practices/**: Project practices, conventions, and standards
55
- - **03-decisions/**: Architecture Decision Records (ADRs)
56
- - **04-architecture/**: System architecture documentation
57
- - **05-epics/**: Epic definitions and planning
58
- - **06-stories/**: User stories and implementation details
59
- - **07-testing/**: Test cases and acceptance criteria
60
- - **08-project/**: Project management (roadmap, backlog, milestones)
61
- - **09-agents/**: Agent status tracking and communication
62
- - **10-research/**: Research notes and findings
63
-
64
- ## Getting Started
65
-
66
- Use AgileFlow slash commands to work with these directories:
67
- - \`/AgileFlow:epic\` - Create a new epic
68
- - \`/AgileFlow:story\` - Create a user story
69
- - \`/AgileFlow:status\` - Update story status
70
- - \`/AgileFlow:help\` - See all available commands
71
- `,
61
+ [`${docsFolder}/README.md`]: packageReadme,
72
62
 
73
63
  [`${docsFolder}/00-meta/README.md`]: `# Meta Documentation
74
64
 
@@ -118,7 +108,7 @@ Technical decisions, trade-offs, and alternatives considered.
118
108
 
119
109
  ## Format
120
110
 
121
- Use \`/AgileFlow:adr\` to create new decision records.
111
+ Use \`/agileflow:adr\` to create new decision records.
122
112
 
123
113
  Each ADR should include:
124
114
  - **Context**: What problem are we solving?
@@ -148,7 +138,7 @@ Large features broken down into user stories.
148
138
 
149
139
  ## Format
150
140
 
151
- Use \`/AgileFlow:epic\` to create new epics.
141
+ Use \`/agileflow:epic\` to create new epics.
152
142
 
153
143
  Each epic includes:
154
144
  - Epic ID (EP-XXXX)
@@ -163,7 +153,7 @@ Implementation tasks with acceptance criteria and technical details.
163
153
 
164
154
  ## Format
165
155
 
166
- Use \`/AgileFlow:story\` to create new stories.
156
+ Use \`/agileflow:story\` to create new stories.
167
157
 
168
158
  Each story includes:
169
159
  - Story ID (US-XXXX)
@@ -183,7 +173,7 @@ Test cases, acceptance criteria, and testing strategies.
183
173
  - **acceptance/**: Acceptance test definitions
184
174
  - **test-cases/**: Detailed test case documentation
185
175
 
186
- Use \`/AgileFlow:tests\` to set up testing infrastructure.
176
+ Use \`/agileflow:tests\` to set up testing infrastructure.
187
177
  `,
188
178
 
189
179
  [`${docsFolder}/08-project/README.md`]: `# Project Management
@@ -208,7 +198,7 @@ Real-time status of stories being worked on by agents.
208
198
  - **status-archive.json**: Archived completed stories
209
199
  - **bus/log.jsonl**: Agent communication log
210
200
 
211
- Use \`/AgileFlow:status\` to update story status.
201
+ Use \`/agileflow:status\` to update story status.
212
202
  `,
213
203
 
214
204
  [`${docsFolder}/10-research/README.md`]: `# Research Notes
@@ -217,7 +207,7 @@ Research findings, investigations, and technical explorations.
217
207
 
218
208
  ## Format
219
209
 
220
- Use \`/AgileFlow:research\` to create new research notes.
210
+ Use \`/agileflow:research\` to create new research notes.
221
211
 
222
212
  | Date | Topic | Path | Summary |
223
213
  |------|-------|------|---------|
@@ -91,7 +91,7 @@ function shouldSkipInstall() {
91
91
  // Get the installation directory (user's project root)
92
92
  const installDir = process.cwd();
93
93
 
94
- // Skip if .agileflow or .claude/commands/AgileFlow folder already exists
94
+ // Skip if .agileflow or .claude/commands/agileflow folder already exists
95
95
  const agileflowPath = path.join(installDir, '.agileflow');
96
96
  const claudeAgileflowPath = path.join(installDir, '.claude', 'commands', 'AgileFlow');
97
97