create-sdd-project 0.2.4 → 0.3.3

package/lib/init-generator.js

@@ -35,12 +35,15 @@ function generateInit(config) {
   step('Creating ai-specs/specs/ (4 standards files)');
   ensureDir(path.join(dest, 'ai-specs', 'specs'));
 
-  // base-standards and documentation-standards: copy as-is
-  copyFileIfNotExists(
-    path.join(templateDir, 'ai-specs', 'specs', 'base-standards.mdc'),
-    path.join(dest, 'ai-specs', 'specs', 'base-standards.mdc'),
-    skipped
-  );
+  // base-standards: adapt validation references based on detected stack
+  const baseStdPath = path.join(dest, 'ai-specs', 'specs', 'base-standards.mdc');
+  if (!fs.existsSync(baseStdPath)) {
+    const baseTemplate = fs.readFileSync(path.join(templateDir, 'ai-specs', 'specs', 'base-standards.mdc'), 'utf8');
+    const adaptedBase = adaptBaseStandards(baseTemplate, scan, config);
+    fs.writeFileSync(baseStdPath, adaptedBase, 'utf8');
+  } else {
+    skipped.push('ai-specs/specs/base-standards.mdc');
+  }
   copyFileIfNotExists(
     path.join(templateDir, 'ai-specs', 'specs', 'documentation-standards.mdc'),
     path.join(dest, 'ai-specs', 'specs', 'documentation-standards.mdc'),
@@ -72,7 +75,7 @@ function generateInit(config) {
   }
 
   // 3. Copy and configure docs/
-  step('Creating docs/project_notes/ (sprint tracker, memory)');
+  step('Creating docs/project_notes/ (product tracker, memory)');
   ensureDir(path.join(dest, 'docs', 'project_notes'));
   ensureDir(path.join(dest, 'docs', 'specs'));
   ensureDir(path.join(dest, 'docs', 'tickets'));
@@ -99,14 +102,14 @@ function generateInit(config) {
     skipped
   );
 
-  // sprint-0-tracker.md — configure dates and add retrofit tasks
-  const trackerPath = path.join(dest, 'docs', 'project_notes', 'sprint-0-tracker.md');
+  // product-tracker.md — configure and add retrofit tasks
+  const trackerPath = path.join(dest, 'docs', 'project_notes', 'product-tracker.md');
   if (!fs.existsSync(trackerPath)) {
-    const template = fs.readFileSync(path.join(templateDir, 'docs', 'project_notes', 'sprint-0-tracker.md'), 'utf8');
-    const configured = configureSprintTracker(template, scan);
+    const template = fs.readFileSync(path.join(templateDir, 'docs', 'project_notes', 'product-tracker.md'), 'utf8');
+    const configured = configureProductTracker(template, scan);
     fs.writeFileSync(trackerPath, configured, 'utf8');
   } else {
-    skipped.push('docs/project_notes/sprint-0-tracker.md');
+    skipped.push('docs/project_notes/product-tracker.md');
   }
 
   // docs/specs/
@@ -174,6 +177,9 @@ function generateInit(config) {
     removeAgentFiles(dest, BACKEND_AGENTS, config);
   }
 
+  // 7b. Adapt agent/skill content to match detected stack
+  adaptCopiedFiles(dest, scan, config);
+
   // 8. Append to .gitignore
   appendGitignore(dest, skipped);
 
@@ -195,7 +201,7 @@ function generateInit(config) {
 
   // Show review notes
   console.log('');
-  console.log('  ⚠ REVIEW BEFORE YOUR FIRST SPRINT:');
+  console.log('  ⚠ REVIEW BEFORE YOUR FIRST FEATURE:');
   if (config.projectType !== 'frontend') {
     console.log('    - ai-specs/specs/backend-standards.mdc  — Architecture section adapted from scan');
   }
@@ -214,7 +220,7 @@ function generateInit(config) {
     } else {
       console.log(`  📝 Test coverage appears low (${fileCount} test files found).`);
     }
-    console.log('     Consider starting Sprint 0 with retrofit testing tasks.');
+    console.log('     Consider adding retrofit testing as your first feature.');
   }
 
   // Prisma schema note
@@ -226,7 +232,7 @@ function generateInit(config) {
   // Done
   console.log(`\nDone! Next steps:`);
   console.log(`  git add -A && git commit -m "chore: add SDD DevFlow to existing 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 ---
@@ -288,8 +294,288 @@ function safeDelete(filePath) {
   try { fs.unlinkSync(filePath); } catch { /* ignore */ }
 }
 
+// --- Adapt Copied Agent/Skill Files ---
+
+function replaceInCopiedFile(dest, relativePath, replacements) {
+  const filePath = path.join(dest, relativePath);
+  if (!fs.existsSync(filePath)) return;
+  let content = fs.readFileSync(filePath, 'utf8');
+  for (const [from, to] of replacements) {
+    content = content.replaceAll(from, to);
+  }
+  fs.writeFileSync(filePath, content, 'utf8');
+}
+
+function regexReplaceInFile(filePath, replacements) {
+  if (!fs.existsSync(filePath)) return;
+  let content = fs.readFileSync(filePath, 'utf8');
+  for (const [from, to] of replacements) {
+    if (from instanceof RegExp) {
+      content = content.replace(from, to);
+    } else {
+      content = content.replaceAll(from, to);
+    }
+  }
+  fs.writeFileSync(filePath, content, 'utf8');
+}
+
+function adaptCopiedFiles(dest, scan, config) {
+  const orm = scan.backend.orm || 'your ORM';
+  const db = scan.backend.db || 'your database';
+
+  // Common Zod → generic validation replacements (all agents + skills)
+  // Order: most specific first, catch-all last
+  const zodReplacements = [
+    ['Zod data schemas', 'validation schemas'],
+    ['Zod schemas', 'validation schemas'],
+  ];
+
+  // ORM/DB replacements for backend agents
+  const ormReplacements = scan.backend.orm && scan.backend.orm !== 'Prisma'
+    ? [
+      ['Prisma ORM, and PostgreSQL', `${orm}${db !== 'your database' ? `, and ${db}` : ''}`],
+      ['Repository implementations (Prisma)', `Repository implementations (${orm})`],
+    ]
+    : [];
+
+  // Apply to all AI tool directories
+  const toolDirs = [];
+  if (config.aiTools !== 'gemini') toolDirs.push('.claude');
+  if (config.aiTools !== 'claude') toolDirs.push('.gemini');
+
+  for (const dir of toolDirs) {
+    // Backend agents: Zod + ORM replacements
+    if (scan.backend.validation !== 'Zod') {
+      const backendAgentReplacements = [...zodReplacements, ...ormReplacements];
+      replaceInCopiedFile(dest, `${dir}/agents/backend-developer.md`, backendAgentReplacements);
+      replaceInCopiedFile(dest, `${dir}/agents/backend-planner.md`, backendAgentReplacements);
+    } else if (ormReplacements.length > 0) {
+      // Zod detected but different ORM — only ORM replacements
+      replaceInCopiedFile(dest, `${dir}/agents/backend-developer.md`, ormReplacements);
+      replaceInCopiedFile(dest, `${dir}/agents/backend-planner.md`, ormReplacements);
+    }
+
+    // Multi-purpose agents: Zod replacements only
+    if (scan.backend.validation !== 'Zod') {
+      replaceInCopiedFile(dest, `${dir}/agents/spec-creator.md`, zodReplacements);
+      replaceInCopiedFile(dest, `${dir}/agents/production-code-validator.md`, zodReplacements);
+      replaceInCopiedFile(dest, `${dir}/agents/database-architect.md`, zodReplacements);
+    }
+
+    // Skills: Zod replacements
+    if (scan.backend.validation !== 'Zod') {
+      replaceInCopiedFile(dest, `${dir}/skills/development-workflow/SKILL.md`, zodReplacements);
+      replaceInCopiedFile(dest, `${dir}/skills/development-workflow/references/ticket-template.md`, zodReplacements);
+    }
+  }
+
+  // Architecture adaptation: DDD-specific content in backend agents
+  const arch = scan.srcStructure ? scan.srcStructure.pattern : 'ddd';
+  if (arch !== 'ddd') {
+    for (const dir of toolDirs) {
+      // backend-planner: adapt header, exploration paths, implementation order, rules
+      regexReplaceInFile(path.join(dest, dir, 'agents', 'backend-planner.md'), [
+        // Header: remove DDD reference, use generic
+        ['specializing in Domain-Driven Design (DDD) layered architecture with deep knowledge of',
+          'specializing in layered architecture with deep knowledge of'],
+        // Exploration paths: replace DDD-specific with generic
+        [/4\. Read `shared\/src\/schemas\/` \(if exists\) for current .* data schemas\n/, ''],
+        [/5\. Explore `backend\/src\/domain\/` for existing entities and errors\n/,
+          '5. Explore the codebase for existing patterns, layer structure, and reusable code\n'],
+        [/6\. Explore `backend\/src\/application\/services\/` for existing services\n/, ''],
+        [/7\. Explore `backend\/src\/application\/validators\/` for existing validators\n/, ''],
+        [/8\. Explore `backend\/src\/infrastructure\/` for existing repositories\n/, ''],
+        // Implementation Order
+        ['following DDD layer order: Domain > Application > Infrastructure > Presentation > Tests',
+          'following the layer order defined in backend-standards.mdc'],
+        // Rules
+        ['Follow DDD layer separation: Domain > Application > Infrastructure > Presentation',
+          'Follow the layer separation defined in backend-standards.mdc'],
+      ]);
+      // backend-developer: adapt frontmatter, header, exploration, implementation order, rules
+      regexReplaceInFile(path.join(dest, dir, 'agents', 'backend-developer.md'), [
+        ['follows DDD layered architecture',
+          'follows layered architecture'],
+        ['specializing in Domain-Driven Design (DDD) with',
+          'specializing in layered architecture with'],
+        [/4\. Read `shared\/src\/schemas\/` \(if exists\) for current .* data schemas\n/, ''],
+        // Implementation Order section: replace DDD layers with generic guidance
+        ['Follow the DDD layer order from the plan:',
+          'Follow the layer order from the plan (see backend-standards.mdc for project layers):'],
+        [/1\. \*\*Domain Layer\*\*: Entities, value objects, repository interfaces, domain errors\n/,
+          '1. **Data Layer**: Models, database operations, data access\n'],
+        [/2\. \*\*Application Layer\*\*: Services, validators, DTOs\n/,
+          '2. **Business Logic Layer**: Controllers, services, external integrations\n'],
+        [/3\. \*\*Infrastructure Layer\*\*: Repository implementations \([^)]*\), external integrations\n/,
+          '3. **Presentation Layer**: Routes, handlers, middleware\n'],
+        [/4\. \*\*Presentation Layer\*\*: Controllers, routes, middleware\n/,
+          '4. **Integration Layer**: Wiring, configuration, server registration\n'],
+        // Rules
+        ['**ALWAYS** follow DDD layer separation',
+          '**ALWAYS** follow the layer separation defined in backend-standards.mdc'],
+        ['**ALWAYS** handle errors with custom domain error classes',
+          '**ALWAYS** handle errors following the patterns in backend-standards.mdc'],
+        // Documentation
+        [/- \*\*MANDATORY\*\*: If modifying a DB schema → update .* schemas in `shared\/src\/schemas\/` BEFORE continuing\n/, ''],
+      ]);
+    }
+  }
+
+  // Agent content: remove frontend/backend-specific references for single-stack projects
+  if (config.projectType === 'backend') {
+    for (const dir of toolDirs) {
+      // spec-creator: remove Frontend Specifications section and UI output format
+      regexReplaceInFile(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 from Spec Drift
+      regexReplaceInFile(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 standards ref, remove ui-components
+      regexReplaceInFile(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 ui-components from specs, remove frontend test command
+      regexReplaceInFile(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) {
+      // spec-creator: remove Backend Specifications section
+      regexReplaceInFile(path.join(dest, dir, 'agents', 'spec-creator.md'), [
+        [/### Backend Specifications\n(?:- [^\n]*\n)+\n/, ''],
+        [/### For API Changes\n```yaml\n(?:[^\n]*\n)*?```\n\n/, ''],
+      ]);
+      // code-review-specialist: frontend-only standards ref
+      regexReplaceInFile(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`)'],
+      ]);
+      // qa-engineer: remove api-spec from specs, remove backend test command
+      regexReplaceInFile(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: remove frontend/backend-specific references
+  if (config.projectType === 'backend') {
+    for (const dir of toolDirs) {
+      // Gemini agents have different text patterns
+      regexReplaceInFile(path.join(dest, dir, 'agents', 'spec-creator.md'), [
+        [/\(api-spec\.yaml, ui-components\.md\)/, '(api-spec.yaml)'],
+        ['Data Model Changes, UI Changes, Edge Cases', 'Data Model Changes, Edge Cases'],
+      ]);
+      regexReplaceInFile(path.join(dest, dir, 'agents', 'production-code-validator.md'), [
+        [/,? components not in ui-components\.md/, ''],
+      ]);
+      // SKILL.md: remove ui-components references
+      regexReplaceInFile(path.join(dest, dir, 'skills', 'development-workflow', 'SKILL.md'), [
+        [/,? `ui-components\.md`\)/, ')'],
+        [/- UI components → `docs\/specs\/ui-components\.md` \(MANDATORY\)\n/, ''],
+      ]);
+      // ticket-template: remove UI Changes section, ui-components from checklists
+      regexReplaceInFile(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`', ''],
+      ]);
+      // pr-template: remove ui-components from checklist
+      regexReplaceInFile(path.join(dest, dir, 'skills', 'development-workflow', 'references', 'pr-template.md'), [
+        [' / ui-components.md', ''],
+      ]);
+    }
+  } else if (config.projectType === 'frontend') {
+    for (const dir of toolDirs) {
+      regexReplaceInFile(path.join(dest, dir, 'agents', 'spec-creator.md'), [
+        [/\(api-spec\.yaml, ui-components\.md\)/, '(ui-components.md)'],
+      ]);
+      regexReplaceInFile(path.join(dest, dir, 'skills', 'development-workflow', 'SKILL.md'), [
+        [/`api-spec\.yaml`,? /, ''],
+        [/- API endpoints → `docs\/specs\/api-spec\.yaml` \(MANDATORY\)\n/, ''],
+      ]);
+      regexReplaceInFile(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` / ', ''],
+      ]);
+      regexReplaceInFile(path.join(dest, dir, 'skills', 'development-workflow', 'references', 'pr-template.md'), [
+        ['api-spec.yaml / ', ''],
+      ]);
+    }
+  }
+
+  // documentation-standards.mdc: remove irrelevant rows based on project type
+  const docStdPath = path.join(dest, 'ai-specs', 'specs', 'documentation-standards.mdc');
+  if (fs.existsSync(docStdPath)) {
+    let content = fs.readFileSync(docStdPath, 'utf8');
+    if (config.projectType === 'backend') {
+      content = content.replace(/\| `ai-specs\/specs\/frontend-standards\.mdc` \|[^\n]*\n/, '');
+      content = content.replace(/\| `docs\/specs\/ui-components\.md` \|[^\n]*\n/, '');
+      content = content.replace(/   - UI component changes → `docs\/specs\/ui-components\.md`\n/, '');
+    } else if (config.projectType === 'frontend') {
+      content = content.replace(/\| `ai-specs\/specs\/backend-standards\.mdc` \|[^\n]*\n/, '');
+      content = content.replace(/\| `docs\/specs\/api-spec\.yaml` \|[^\n]*\n/, '');
+    }
+    fs.writeFileSync(docStdPath, content, 'utf8');
+  }
+}
+
 // --- Standards Adaptation ---
 
+function adaptBaseStandards(template, scan, config) {
+  let content = template;
+
+  // Adapt validation recommendation based on detected library
+  const val = scan.backend.validation;
+  if (val && val !== 'Zod') {
+    content = content.replace(
+      'Use runtime validation (Zod recommended).',
+      `Use runtime validation (${val}).`
+    );
+  } else if (!val) {
+    content = content.replace(
+      'Use runtime validation (Zod recommended).',
+      'Use runtime validation at system boundaries.'
+    );
+  }
+
+  // Adapt Shared Types Strategy section based on project structure
+  const hasSharedTypes = scan.frontend.detected && scan.backend.detected;
+  if (!hasSharedTypes) {
+    // Backend-only or frontend-only: remove entire Shared Types section
+    content = content.replace(
+      /## 5\. Shared Types Strategy\n\n<!-- CONFIG:.*?-->\n\n[\s\S]*?(?=\n## 6\.)/,
+      '## 5. Shared Types Strategy\n\n_Not applicable — single-stack project._\n\n'
+    );
+  } else if (val !== 'Zod') {
+    // Fullstack but not using Zod (or no validation detected): generalize the section
+    content = content.replace(
+      /## 5\. Shared Types Strategy\n\n<!-- CONFIG:.*?-->\n\nFor projects with backend \+ frontend, use a shared workspace for Zod schemas:\n\n```\n[\s\S]*?```\n\n\*\*Rules:\*\*\n[\s\S]*?(?=\n## 6\.)/,
+      `## 5. Shared Types Strategy\n\n<!-- CONFIG: Remove this section if your project has no shared types -->\n\nFor projects with backend + frontend, use a shared workspace for types:\n\n\`\`\`\nproject/\n├── shared/              ← @project/shared (npm workspace)\n│   └── src/types/       ← Shared TypeScript types\n├── backend/             ← imports @project/shared\n└── frontend/            ← imports @project/shared\n\`\`\`\n\n**Rules:**\n- Define shared types in the shared workspace\n- Both apps import from shared — never duplicate type definitions\n- Update shared types FIRST — both apps get changes automatically\n- Wire with npm workspaces + \`tsconfig.json\` paths\n\n`
+    );
+  }
+  // If Zod detected + fullstack: keep as-is (template default is correct)
+
+  // Remove frontend/backend references for single-stack projects
+  if (config.projectType === 'backend') {
+    content = content.replace(/  - \*\*Frontend\*\*: Update `docs\/specs\/ui-components\.md` first\.\n/, '');
+    content = content.replace('`backend-standards.mdc` / `frontend-standards.mdc`', '`backend-standards.mdc`');
+  } else if (config.projectType === 'frontend') {
+    content = content.replace(/  - \*\*Backend\*\*: Update `docs\/specs\/api-spec\.yaml` first\.\n/, '');
+    content = content.replace('`backend-standards.mdc` / `frontend-standards.mdc`', '`frontend-standards.mdc`');
+  }
+
+  return content;
+}
+
 function adaptBackendStandards(template, scan) {
   let content = template;
 
@@ -367,6 +653,11 @@ function adaptBackendStandards(template, scan) {
       /## Database Patterns\n\n[\s\S]*?(?=\n## )/,
       `## Database Patterns\n\n<!-- TODO: Add database access patterns for your project. -->\n`
     );
+  } else if (scan.backend.orm === 'Mongoose') {
+    content = content.replace(
+      /## Database Patterns\n\n[\s\S]*?(?=\n## )/,
+      `## Database Patterns\n\n### Mongoose Best Practices\n- Define schemas in dedicated model files\n- Use TypeScript interfaces alongside Mongoose schemas for type safety\n- Use \`.lean()\` for read-only queries (returns plain objects, better performance)\n- Use \`.select()\` to limit returned fields on large documents\n- Add indexes for frequently queried fields (\`{ index: true }\` or compound \`schema.index()\`)\n- Use \`.populate()\` sparingly — avoid deep nesting, prefer manual joins for complex queries\n- Use middleware (pre/post hooks) for cross-cutting concerns (timestamps, audit logs)\n- Use transactions (\`session\`) for multi-document operations that must be atomic\n- Always handle \`CastError\` (invalid ObjectId) at the controller/middleware level\n\n### Schema Pattern\n\`\`\`typescript\nimport mongoose, { Schema, Document } from 'mongoose';\n\nexport interface IUser extends Document {\n  email: string;\n  name: string;\n  role: 'user' | 'admin';\n}\n\nconst UserSchema = new Schema<IUser>({\n  email: { type: String, required: true, unique: true, index: true },\n  name: { type: String, required: true },\n  role: { type: String, enum: ['user', 'admin'], default: 'user' },\n}, { timestamps: true });\n\nexport const User = mongoose.model<IUser>('User', UserSchema);\n\`\`\`\n\n`
+    );
   } else if (scan.backend.orm !== 'Prisma') {
     content = content.replace(
       /## Database Patterns\n\n[\s\S]*?(?=\n## )/,
@@ -646,40 +937,29 @@ function configureKeyFacts(template, config, scan) {
   return content;
 }
 
-// --- Sprint Tracker Configuration ---
+// --- Product Tracker Configuration ---
 
-function configureSprintTracker(template, scan) {
+function configureProductTracker(template, scan) {
   let content = template;
 
-  // Set dates
-  const today = new Date().toISOString().split('T')[0];
-  const endDate = new Date();
-  endDate.setDate(endDate.getDate() + 14);
-  const end = endDate.toISOString().split('T')[0];
-  content = content.replace(/\[YYYY-MM-DD\] to \[YYYY-MM-DD\]/, `${today} to ${end}`);
+  // Determine default feature type based on detected stack
+  const featureType = !scan.backend.detected && scan.frontend.detected
+    ? 'frontend'
+    : scan.backend.detected && scan.frontend.detected
+      ? 'fullstack'
+      : 'backend';
 
-  // Remove irrelevant task tables based on detected stack
-  if (!scan.frontend.detected) {
-    content = content.replace(
-      /\n### Frontend\n\n\| # \| Task \| Status \| Notes \|\n\|---\|------\|--------\|-------\|\n\| F0\.1 \| \[Task description\] \| ⬚ \| \|\n/,
-      ''
-    );
-  }
-  if (!scan.backend.detected) {
-    content = content.replace(
-      /\n### Backend\n\n\| # \| Task \| Status \| Notes \|\n\|---\|------\|--------\|-------\|\n\| B0\.1 \| \[Task description\] \| ⬚ \| \|\n/,
-      ''
-    );
+  // Update default feature type in the placeholder row
+  if (featureType !== 'backend') {
+    content = content.replace('| backend | pending', `| ${featureType} | pending`);
   }
 
-  // Add retrofit testing tasks if coverage is low
+  // Add retrofit testing as first feature if coverage is low
   if (scan.tests.estimatedCoverage === 'none' || scan.tests.estimatedCoverage === 'low') {
-    const retrofitSection = `\n### Retrofit Testing (recommended)\n\n| # | Task | Status | Notes |\n|---|------|--------|-------|\n| R0.1 | Audit existing test coverage | ⬚ | |\n| R0.2 | Add missing unit tests for critical paths | ⬚ | |\n| R0.3 | Set up CI test pipeline | ⬚ | |\n`;
-
-    // Insert before Status Legend
+    // Use regex to match the F001 placeholder row resiliently (handles column changes)
     content = content.replace(
-      '**Status Legend:**',
-      `${retrofitSection}\n**Status Legend:**`
+      /\| F001 \|[^\n]*\n/,
+      `| F001 | Retrofit: audit and improve test coverage | ${featureType} | pending | — | Recommended — low test coverage detected |\n| F002 | [Feature description] | ${featureType} | pending | — | |\n`
     );
   }
 

package/lib/init-wizard.js

@@ -220,7 +220,7 @@ async function runInitWizard(scanResult) {
 
     console.log('\n  Files to be created:');
     console.log('    ai-specs/specs/          (4 files — standards adapted to your stack)');
-    console.log('    docs/project_notes/      (4 files — sprint tracker, memory)');
+    console.log('    docs/project_notes/      (4 files — product tracker, memory)');
     console.log('    docs/specs/              (API spec, UI components)');
     console.log('    docs/tickets/            (.gitkeep)');
     if (config.aiTools !== 'gemini') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-sdd-project",
-  "version": "0.2.4",
+  "version": "0.3.3",
   "description": "Create a new SDD DevFlow project with AI-assisted development workflow",
   "bin": {
     "create-sdd-project": "bin/cli.js"

package/template/.claude/agents/backend-developer.md

@@ -57,4 +57,4 @@ Follow the DDD layer order from the plan:
 - **ALWAYS** run `npm test` after each TDD cycle to verify
 - **NEVER** skip tests for "simple" code
 - **NEVER** modify code outside the scope of the current ticket
-- **ALWAYS** verify implementation matches the approved spec. If a deviation is needed, document it in the sprint tracker's Active Session and ask for approval
+- **ALWAYS** verify implementation matches the approved spec. If a deviation is needed, document it in the product tracker's Active Session and ask for approval

package/template/.claude/agents/frontend-developer.md

@@ -65,4 +65,4 @@ Follow the logical order from the plan:
 - **ALWAYS** run `npm test` after each TDD cycle to verify
 - **NEVER** skip tests for "simple" components
 - **NEVER** modify code outside the scope of the current ticket
-- **ALWAYS** verify implementation matches the approved spec. If a deviation is needed, document it in the sprint tracker's Active Session and ask for approval
+- **ALWAYS** verify implementation matches the approved spec. If a deviation is needed, document it in the product tracker's Active Session and ask for approval

package/template/.claude/settings.json

@@ -19,7 +19,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "echo '{\"additionalContext\": \"Context was compacted. BEFORE doing anything else: read the sprint tracker Active Session section (docs/project_notes/sprint-*-tracker.md) for context recovery. Follow the Session Recovery protocol in CLAUDE.md.\"}'",
+            "command": "echo '{\"additionalContext\": \"Context was compacted. BEFORE doing anything else: read the product tracker Active Session section (docs/project_notes/product-tracker.md) for context recovery. Follow the Session Recovery protocol in CLAUDE.md.\"}'",
             "statusMessage": "Injecting recovery context..."
           }
         ]

package/template/.claude/skills/bug-workflow/SKILL.md

@@ -23,7 +23,7 @@ description: "Handles bug discovery, triage, investigation, and resolution. Invo
 |----------|----------|------|
 | Critical | Immediate (<1h) | **C: Hotfix** — Confirm → Branch from main → Minimal fix → Test → Deploy → Document → Post-mortem |
 | High | Same day | **B: Standard** — Triage → Branch → Investigate → Fix (TDD) → Validate → Document → PR |
-| Medium | Within sprint | **A: Quick** — Triage → Investigate → Fix → Test → Document → Commit |
+| Medium | Within cycle | **A: Quick** — Triage → Investigate → Fix → Test → Document → Commit |
 | Low | Backlog | **A: Quick** or escalate to backlog |
 
 **Escalate to `development-workflow`** when: >1 day work, architectural changes needed, or significant refactoring required.
@@ -99,7 +99,7 @@ Run `production-code-validator`. Ensure no debug code, proper error handling.
 
 | File | When |
 |------|------|
-| `sprint-X-tracker.md` | Bug being worked on (Active Session) |
+| `product-tracker.md` | Bug being worked on (Active Session) |
 | `bugs.md` | Always |
 | `decisions.md` | If architectural decision made |
 

package/template/.claude/skills/development-workflow/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: development-workflow
-description: "Orchestrates the complete development workflow for each task. Invoke with: 'start task B0.1', 'show sprint progress', 'next task', or 'init sprint N'."
+description: "Orchestrates the complete development workflow for each feature. Invoke with: 'start task F001', 'show progress', 'next task', or 'add feature'."
 ---
 
 # Development Workflow Skill
@@ -8,7 +8,7 @@ description: "Orchestrates the complete development workflow for each task. Invo
 ## Quick Reference
 
 0. **Spec** — `spec-creator` drafts/updates specs → SPEC APPROVAL (Std/Cplx)
-1. **Setup** — Branch, ticket, sprint tracker → TICKET APPROVAL (Std/Cplx)
+1. **Setup** — Branch, ticket, product tracker → TICKET APPROVAL (Std/Cplx)
 2. **Plan** — Planner agent writes implementation plan → PLAN APPROVAL (Std/Cplx)
 3. **Implement** — Developer agent, TDD, real-time spec sync
 4. **Finalize** — Tests/lint/build, `production-code-validator` → COMMIT APPROVAL
@@ -19,19 +19,19 @@ description: "Orchestrates the complete development workflow for each task. Invo
 
 ## Commands
 
-- `start task B0.1` — Begin working on a specific task
-- `next task` — Start the next pending task in current sprint
-- `show sprint progress` — View sprint completion status
-- `init sprint N` — Initialize a new sprint tracker
+- `start task F001` — Begin working on a specific feature
+- `next task` — Start the next pending feature from product tracker
+- `show progress` — View feature completion status
+- `add feature "description"` — Add a new feature to the product tracker
 
 ---
 
 ## On Skill Start
 
-1. Read the sprint tracker (`docs/project_notes/sprint-X-tracker.md`) → **Active Session** section for context recovery
+1. Read the product tracker (`docs/project_notes/product-tracker.md`) → **Active Session** section for context recovery
 2. Read `CLAUDE.md` section 2 → **Autonomy Level**
 3. Read `docs/project_notes/key_facts.md` → **Branching Strategy**
-4. If resuming an active task → continue from the step recorded in the tracker's Active Session
+4. If resuming an active feature → continue from the step recorded in the tracker's Active Session
 
 ---
 
@@ -47,7 +47,7 @@ Read the **Autonomy Level** from `CLAUDE.md` section 2.
 | Commit Approval (Step 4) | Required | Auto | Auto | Auto |
 | Merge Approval (Step 5) | Required | Required | Required | Auto |
 
-- **Auto** = proceed without asking; log in sprint tracker → "Auto-Approved Decisions" table
+- **Auto** = proceed without asking; log in product tracker → "Auto-Approved Decisions" table
 - **Required** = ask user explicitly; do NOT continue without approval
 - **Quality gates always run** regardless of level (tests, lint, build, validators)
 
@@ -83,11 +83,11 @@ Ask user to classify complexity before starting. See `references/complexity-guid
 
 See `references/branching-strategy.md` for details.
 
-1. Verify sprint tracker exists, no active task, dependencies met
-2. Create feature branch: `feature/sprint<N>-<task-id>-<short-description>`
+1. Verify product tracker exists, no active feature, dependencies met
+2. Create feature branch: `feature/<feature-id>-<short-description>`
 3. **Std/Cplx:** Generate ticket from `references/ticket-template.md` → fill `## Spec` section
 4. **Complex:** Also review `decisions.md` for related ADRs
-5. Update sprint tracker → Active Session: task, step `1/6 (Setup)`, branch, complexity
+5. Update product tracker → Active Session: feature, step `1/6 (Setup)`, branch, complexity
 
 **→ CHECKPOINT: Ticket Approval** (Std/Cplx only — Simple skips to Step 3)
 
@@ -95,7 +95,7 @@ See `references/branching-strategy.md` for details.
 
 ## Step 2: Plan (Standard/Complex only)
 
-1. Use Task tool with planner agent (`backend-planner` for B*.*, `frontend-planner` for F*.*)
+1. Use Task tool with planner agent (`backend-planner` for backend features, `frontend-planner` for frontend features)
 2. Agent writes Implementation Plan into ticket's `## Implementation Plan`
 3. Update tracker: step `2/6 (Plan)`
 
@@ -115,7 +115,7 @@ See `references/branching-strategy.md` for details.
 - UI components → `docs/specs/ui-components.md` (MANDATORY)
 - Env variables → `.env.example` | ADRs → `decisions.md`
 
-**Spec deviation** → document in sprint tracker Active Session and ask for approval.
+**Spec deviation** → document in product tracker Active Session and ask for approval.
 
 Update tracker: step `3/6 (Implement)`, context summary.
 
@@ -154,7 +154,7 @@ Update tracker: step `5/6 (Review)`
 ## Step 6: Complete
 
 1. Delete feature branch (local + remote)
-2. Update sprint tracker: task → Completed, add to Completion Log, update progress %
+2. Update product tracker: feature → done, add to Completion Log, update progress
 3. Record bugs in `bugs.md`, decisions in `decisions.md`
 4. Clear Active Session → "No active work"
 
@@ -177,18 +177,18 @@ Update tracker: step `5/6 (Review)`
 - `references/ticket-template.md` — Ticket format
 - `references/pr-template.md` — PR template
 - `references/branching-strategy.md` — Branching guide
-- `references/sprint-init-template.md` — New sprint initialization
+- `references/add-feature-template.md` — Add feature to tracker
 - `references/complexity-guide.md` — Complexity classification
 - `references/workflow-example.md` — Full worked example
 - `references/failure-handling.md` — Recovery & rollbacks
 
 ## Constraints
 
-- **One task at a time** — never start a new task before completing current
+- **One feature at a time** — never start a new feature before completing current
 - **TDD mandatory** — all code needs tests
 - **Type safety** — fully typed, no `any`
 - **English only** — all technical artifacts
 - **Memory first** — check `project_notes/` before changes
-- **Sprint tracker** — keep Active Session updated at every step
+- **Product tracker** — keep Active Session updated at every step
 - **Correct agents** — Backend → `backend-planner` + `backend-developer`, Frontend → `frontend-planner` + `frontend-developer`
 - **Correct base branch** — check `key_facts.md` before creating branches

package/template/.claude/skills/development-workflow/references/add-feature-template.md

@@ -0,0 +1,16 @@
+# Add Feature Template
+
+Use this template when running `add feature "description"`.
+
+## How to Add a Feature
+
+1. Read the product tracker (`docs/project_notes/product-tracker.md`)
+2. Determine the next feature ID (F001, F002, ...)
+3. Add a row to the Features table
+4. Use `start task F001` to begin working on it
+
+## Feature ID Convention
+
+- **Format:** F001, F002, F003... (sequential)
+- **Type:** backend, frontend, fullstack, infra
+- **Branch:** `feature/<id>-<short-desc>` (e.g., `feature/F001-external-api`)

package/template/.claude/skills/development-workflow/references/branching-strategy.md

@@ -11,7 +11,7 @@ main ────●────●────●────●────●
           \  /      \  /
            \/        \/
         feature/   feature/
-        B1.1       B1.2
+        F001       F002
                          tag: v0.1.0
 ```