create-sdd-project 0.2.4 → 0.3.3

package/README.md

@@ -36,8 +36,8 @@ Scans your project, detects your stack and architecture, and installs SDD files
 Open in your AI coding tool and run:
 
 ```
-init sprint 0
-start task B0.1
+add feature "your first feature"
+start task F001
 ```
 
 The workflow skill guides you through each step with checkpoints based on your autonomy level.
@@ -55,7 +55,7 @@ SDD DevFlow combines three proven practices:
 ### Why use SDD DevFlow?
 
 - **AI agents work better with structure.** Without guardrails, AI coding assistants produce inconsistent results. SDD provides the methodology, standards, and workflow that make AI output predictable and high-quality.
-- **Institutional memory across sessions.** Sprint trackers, bug logs, and decision records survive context compaction and session boundaries.
+- **Institutional memory across sessions.** Product tracker, bug logs, and decision records survive context compaction and session boundaries.
 - **Scales from solo to team.** Start at L1 (full control) while learning, scale to L4 (full auto) for repetitive tasks.
 - **Works with your stack.** Not opinionated about frameworks — detects and adapts to Express, Fastify, NestJS, Next.js, Nuxt, Vue, Angular, and many more.
 
@@ -79,7 +79,7 @@ SDD DevFlow combines three proven practices:
 
 | Skill | Trigger | What it does |
 |-------|---------|-------------|
-| `development-workflow` | `start task B0.1`, `next task`, `init sprint N` | Orchestrates the complete 7-step workflow |
+| `development-workflow` | `start task F001`, `next task`, `add feature` | Orchestrates the complete 7-step workflow |
 | `bug-workflow` | `report bug`, `fix bug`, `hotfix needed` | Bug triage, investigation, and resolution |
 | `project-memory` | `set up project memory`, `log a bug fix` | Maintains institutional knowledge |
 
@@ -87,7 +87,7 @@ SDD DevFlow combines three proven practices:
 
 ```
 0. SPEC      → spec-creator drafts specs        → Spec Approval
-1. SETUP     → Branch, ticket, sprint tracker    → Ticket Approval
+1. SETUP     → Branch, ticket, product tracker    → Ticket Approval
 2. PLAN      → Planner creates implementation plan → Plan Approval
 3. IMPLEMENT → Developer agent, TDD
 4. FINALIZE  → Tests/lint/build, validator       → Commit Approval
@@ -104,7 +104,7 @@ SDD DevFlow combines three proven practices:
 
 | Level | Name | Human Checkpoints | Best For |
 |-------|------|-------------------|----------|
-| L1 | Full Control | All 5 | First sprint, learning SDD |
+| L1 | Full Control | All 5 | First feature, learning SDD |
 | L2 | Trusted | Plan + Merge | Normal development **(default)** |
 | L3 | Autopilot | Merge only | Well-defined, repetitive tasks |
 | L4 | Full Auto | None (CI/CD gates only) | Bulk simple tasks |
@@ -115,7 +115,7 @@ Quality gates (tests, lint, build, validators) **always run** regardless of leve
 
 Tracks institutional knowledge across sessions in `docs/project_notes/`:
 
-- **sprint-X-tracker.md** — Sprint progress + Active Session (context recovery after compaction)
+- **product-tracker.md** — Feature backlog + Active Session (context recovery after compaction)
 - **bugs.md** — Bug log with solutions and prevention notes
 - **decisions.md** — Architectural Decision Records (ADRs)
 - **key_facts.md** — Project configuration, ports, URLs, branching strategy
@@ -123,7 +123,7 @@ Tracks institutional knowledge across sessions in `docs/project_notes/`:
 ### Automated Hooks (Claude Code)
 
 - **Quick Scan** — After developer agents finish, a fast grep-based scan (~2s, no API calls) checks for debug code, secrets, and TODOs
-- **Compaction Recovery** — After context compaction, injects a reminder to read the sprint tracker for context recovery
+- **Compaction Recovery** — After context compaction, injects a reminder to read the product tracker for context recovery
 
 ### Multi-Tool Support
 
@@ -189,7 +189,7 @@ project/
 │
 └── docs/
     ├── project_notes/                   # Project memory
-    │   ├── sprint-0-tracker.md
+    │   ├── product-tracker.md
     │   ├── key_facts.md
     │   ├── bugs.md
     │   └── decisions.md
@@ -237,7 +237,7 @@ Then look for `<!-- CONFIG: ... -->` comments in the files to customize.
 ## Roadmap
 
 - **Agent Teams**: Parallel execution of independent tasks (waiting for Claude Code Agent Teams to stabilize)
-- **PM Agent + L5 Autonomous**: AI-driven sprint orchestration with human review at sprint boundaries
+- **PM Agent + L5 Autonomous**: AI-driven feature orchestration with human review at milestone boundaries
 - **Retrofit Testing**: Automated test generation for existing projects with low coverage
 
 ## License

package/lib/config.js

@@ -78,7 +78,7 @@ const AI_TOOLS = [
 ];
 
 const AUTONOMY_LEVELS = [
-  { level: 1, name: 'Full Control', desc: 'Human approves every checkpoint (first sprint, learning SDD)' },
+  { level: 1, name: 'Full Control', desc: 'Human approves every checkpoint (first feature, learning SDD)' },
   { level: 2, name: 'Trusted', desc: 'Human reviews plans + merges only (normal development)', default: true },
   { level: 3, name: 'Autopilot', desc: 'Human only approves merges (well-defined, repetitive tasks)' },
   { level: 4, name: 'Full Auto', desc: 'No human checkpoints, CI/CD gates only (bulk simple tasks)' },

package/lib/generator.js

@@ -41,11 +41,7 @@ function generate(config) {
   step(`Setting branching: ${config.branching}`);
   updateBranching(dest, config);
 
-  // 6. Set sprint dates
-  step('Setting sprint dates to today');
-  updateSprintDates(dest);
-
-  // 7. Remove agents/specs based on project type
+  // 6. Remove agents/specs based on project type
   if (config.projectType === 'backend') {
     step('Removing frontend agents (backend only)');
     removeFrontendFiles(dest, config);
@@ -54,6 +50,21 @@ function generate(config) {
     removeBackendFiles(dest, config);
   }
 
+  // 7. Adapt agent/skill content for non-default backend stacks
+  if (config.projectType !== 'frontend') {
+    const bp = config.backendPreset || BACKEND_STACKS[0];
+    if (bp.orm && bp.orm !== 'Prisma') {
+      step(`Adapting agents for ${bp.orm}`);
+      adaptAgentsForStack(dest, bp, config);
+    }
+  }
+
+  // 7b. Clean documentation-standards and agent content based on project type
+  adaptDocStandards(dest, config);
+  if (config.projectType !== 'fullstack') {
+    adaptAgentContent(dest, config);
+  }
+
   // 8. Remove AI tool config if single tool selected
   if (config.aiTools === 'claude') {
     step('Removing Gemini config (Claude only)');
@@ -76,7 +87,7 @@ function generate(config) {
   console.log(`\nDone! Next steps:`);
   console.log(`  cd ${path.relative(process.cwd(), dest)}`);
   console.log(`  git init && git add -A && git commit -m "chore: initialize SDD DevFlow project"`);
-  console.log(`  # Open in your AI coding tool and run: init sprint 0\n`);
+  console.log(`  # Open in your AI coding tool and run: add feature "your first feature"\n`);
 }
 
 // --- Helpers ---
@@ -230,19 +241,6 @@ function updateBranching(dest, config) {
   // Nothing else to update — branching is read from key_facts.md at runtime
 }
 
-function updateSprintDates(dest) {
-  const file = path.join(dest, 'docs', 'project_notes', 'sprint-0-tracker.md');
-  const today = new Date().toISOString().split('T')[0];
-  // Calculate 2-week sprint end
-  const endDate = new Date();
-  endDate.setDate(endDate.getDate() + 14);
-  const end = endDate.toISOString().split('T')[0];
-
-  replaceInFile(file, [
-    [/\[YYYY-MM-DD\] to \[YYYY-MM-DD\]/, `${today} to ${end}`],
-  ]);
-}
-
 function removeFrontendFiles(dest, config) {
   // Remove frontend agents
   for (const agent of FRONTEND_AGENTS) {
@@ -262,11 +260,7 @@ function removeFrontendFiles(dest, config) {
     ['├── frontend/    ← Frontend (has its own package.json)\n', ''],
   ]);
 
-  // Remove frontend tasks from sprint tracker
-  const trackerFile = path.join(dest, 'docs', 'project_notes', 'sprint-0-tracker.md');
-  replaceInFile(trackerFile, [
-    [/\n### Frontend\n\n\|.*\n\|.*\n\|.*\n/, '\n'],
-  ]);
+  // Product tracker already defaults to backend — no change needed
 }
 
 function removeBackendFiles(dest, config) {
@@ -288,10 +282,10 @@ function removeBackendFiles(dest, config) {
     ['├── backend/     ← Backend (has its own package.json)\n', ''],
   ]);
 
-  // Remove backend tasks from sprint tracker
-  const trackerFile = path.join(dest, 'docs', 'project_notes', 'sprint-0-tracker.md');
+  // Update product tracker default feature type to frontend
+  const trackerFile = path.join(dest, 'docs', 'project_notes', 'product-tracker.md');
   replaceInFile(trackerFile, [
-    [/\n### Backend\n\n\|.*\n\|.*\n\|.*\n/, '\n'],
+    ['| backend | pending', '| frontend | pending'],
   ]);
 }
 
@@ -310,4 +304,127 @@ function collectNotes(config) {
   return notes;
 }
 
+function adaptAgentsForStack(dest, bPreset, config) {
+  const ormReplacements = [
+    ['Prisma ORM, and PostgreSQL', `${bPreset.orm}${bPreset.db ? `, and ${bPreset.db}` : ''}`],
+    ['Repository implementations (Prisma)', `Repository implementations (${bPreset.orm})`],
+  ];
+
+  const toolDirs = [];
+  if (config.aiTools !== 'gemini') toolDirs.push('.claude');
+  if (config.aiTools !== 'claude') toolDirs.push('.gemini');
+
+  for (const dir of toolDirs) {
+    replaceInFile(path.join(dest, dir, 'agents', 'backend-developer.md'), ormReplacements);
+    replaceInFile(path.join(dest, dir, 'agents', 'backend-planner.md'), ormReplacements);
+  }
+}
+
+function adaptDocStandards(dest, config) {
+  const docStdPath = path.join(dest, 'ai-specs', 'specs', 'documentation-standards.mdc');
+  if (!fs.existsSync(docStdPath)) return;
+
+  const replacements = [];
+  if (config.projectType === 'backend') {
+    replacements.push([/\| `ai-specs\/specs\/frontend-standards\.mdc` \|[^\n]*\n/, '']);
+    replacements.push([/\| `docs\/specs\/ui-components\.md` \|[^\n]*\n/, '']);
+    replacements.push([/   - UI component changes → `docs\/specs\/ui-components\.md`\n/, '']);
+  } else if (config.projectType === 'frontend') {
+    replacements.push([/\| `ai-specs\/specs\/backend-standards\.mdc` \|[^\n]*\n/, '']);
+    replacements.push([/\| `docs\/specs\/api-spec\.yaml` \|[^\n]*\n/, '']);
+  }
+
+  if (replacements.length > 0) {
+    replaceInFile(docStdPath, replacements);
+  }
+}
+
+function adaptAgentContent(dest, config) {
+  const toolDirs = [];
+  if (config.aiTools !== 'gemini') toolDirs.push('.claude');
+  if (config.aiTools !== 'claude') toolDirs.push('.gemini');
+
+  if (config.projectType === 'backend') {
+    for (const dir of toolDirs) {
+      // spec-creator: remove Frontend Specifications section and UI output format
+      replaceInFile(path.join(dest, dir, 'agents', 'spec-creator.md'), [
+        [/### Frontend Specifications\n(?:- [^\n]*\n)+\n/, ''],
+        [/### For UI Changes\n```markdown\n(?:[^\n]*\n)*?```\n\n/, ''],
+        ['Data Model Changes, UI Changes, Edge Cases', 'Data Model Changes, Edge Cases'],
+      ]);
+      // production-code-validator: remove ui-components line
+      replaceInFile(path.join(dest, dir, 'agents', 'production-code-validator.md'), [
+        [/- Components exported\/used that are NOT listed in `docs\/specs\/ui-components\.md`\n/, ''],
+      ]);
+      // code-review-specialist: backend-only refs
+      replaceInFile(path.join(dest, dir, 'agents', 'code-review-specialist.md'), [
+        ['(`backend-standards.mdc` / `frontend-standards.mdc`)', '(`backend-standards.mdc`)'],
+        ['(`api-spec.yaml`, `ui-components.md`)', '(`api-spec.yaml`)'],
+      ]);
+      // qa-engineer: remove frontend refs
+      replaceInFile(path.join(dest, dir, 'agents', 'qa-engineer.md'), [
+        ['(`api-spec.yaml`, `ui-components.md`)', '(`api-spec.yaml`)'],
+        [/- Frontend: `cd frontend && npm test`\n/, ''],
+        [/- \*\*Frontend\*\*: Write tests for error states[^\n]*\n/, ''],
+      ]);
+    }
+  } else if (config.projectType === 'frontend') {
+    for (const dir of toolDirs) {
+      replaceInFile(path.join(dest, dir, 'agents', 'spec-creator.md'), [
+        [/### Backend Specifications\n(?:- [^\n]*\n)+\n/, ''],
+        [/### For API Changes\n```yaml\n(?:[^\n]*\n)*?```\n\n/, ''],
+      ]);
+      replaceInFile(path.join(dest, dir, 'agents', 'code-review-specialist.md'), [
+        ['(`backend-standards.mdc` / `frontend-standards.mdc`)', '(`frontend-standards.mdc`)'],
+        ['(`api-spec.yaml`, `ui-components.md`)', '(`ui-components.md`)'],
+      ]);
+      replaceInFile(path.join(dest, dir, 'agents', 'qa-engineer.md'), [
+        ['(`api-spec.yaml`, `ui-components.md`)', '(`ui-components.md`)'],
+        [/- Backend: `cd backend && npm test`\n/, ''],
+        [/- \*\*Backend\*\*: Write tests for error paths[^\n]*\n/, ''],
+      ]);
+    }
+  }
+
+  // Skills and templates: same cleanup
+  if (config.projectType === 'backend') {
+    for (const dir of toolDirs) {
+      replaceInFile(path.join(dest, dir, 'agents', 'spec-creator.md'), [
+        [/\(api-spec\.yaml, ui-components\.md\)/, '(api-spec.yaml)'],
+      ]);
+      replaceInFile(path.join(dest, dir, 'agents', 'production-code-validator.md'), [
+        [/,? components not in ui-components\.md/, ''],
+      ]);
+      replaceInFile(path.join(dest, dir, 'skills', 'development-workflow', 'SKILL.md'), [
+        [/,? `ui-components\.md`\)/, ')'],
+        [/- UI components → `docs\/specs\/ui-components\.md` \(MANDATORY\)\n/, ''],
+      ]);
+      replaceInFile(path.join(dest, dir, 'skills', 'development-workflow', 'references', 'ticket-template.md'), [
+        [/### UI Changes \(if applicable\)\n\n\[Components to add\/modify\. Reference `docs\/specs\/ui-components\.md`\.\]\n\n/, ''],
+        [' / `ui-components.md`', ''],
+      ]);
+      replaceInFile(path.join(dest, dir, 'skills', 'development-workflow', 'references', 'pr-template.md'), [
+        [' / ui-components.md', ''],
+      ]);
+    }
+  } else if (config.projectType === 'frontend') {
+    for (const dir of toolDirs) {
+      replaceInFile(path.join(dest, dir, 'agents', 'spec-creator.md'), [
+        [/\(api-spec\.yaml, ui-components\.md\)/, '(ui-components.md)'],
+      ]);
+      replaceInFile(path.join(dest, dir, 'skills', 'development-workflow', 'SKILL.md'), [
+        [/`api-spec\.yaml`,? /, ''],
+        [/- API endpoints → `docs\/specs\/api-spec\.yaml` \(MANDATORY\)\n/, ''],
+      ]);
+      replaceInFile(path.join(dest, dir, 'skills', 'development-workflow', 'references', 'ticket-template.md'), [
+        [/### API Changes \(if applicable\)\n\n\[Endpoints to add\/modify\. Reference[^\]]*\]\n\n/, ''],
+        ['`api-spec.yaml` / ', ''],
+      ]);
+      replaceInFile(path.join(dest, dir, 'skills', 'development-workflow', 'references', 'pr-template.md'), [
+        ['api-spec.yaml / ', ''],
+      ]);
+    }
+  }
+}
+
 module.exports = { generate };