create-sdd-project 0.3.0 → 0.3.3

package/lib/generator.js

@@ -50,7 +50,22 @@ function generate(config) {
     removeBackendFiles(dest, config);
   }
 
-  // 7. Remove AI tool config if single tool selected
+  // 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)');
     fs.rmSync(path.join(dest, '.gemini'), { recursive: true, force: true });
@@ -289,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 };

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'),
@@ -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);
 
@@ -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## )/,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-sdd-project",
-  "version": "0.3.0",
+  "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/AGENTS.md

@@ -11,7 +11,7 @@
 project/
 ├── backend/     ← Backend (has its own package.json)
 ├── frontend/    ← Frontend (has its own package.json)
-├── shared/      ← Shared Zod schemas (optional — see base-standards.mdc § Shared Types)
+├── shared/      ← Shared type schemas (optional — see base-standards.mdc § Shared Types)
 └── docs/        ← Documentation (no package.json)
 ```