create-sdd-project 0.5.0 → 0.6.1

package/README.md

@@ -138,6 +138,47 @@ npx create-sdd-project@latest --upgrade
 
 For non-interactive upgrades (CI/scripts): `npx create-sdd-project@latest --upgrade --yes`
 
+### Doctor (Diagnose Installation)
+
+Check that your SDD installation is healthy:
+
+```bash
+cd your-project
+npx create-sdd-project --doctor
+```
+
+```
+🩺 SDD DevFlow Doctor
+
+  ✓ SDD installed (v0.5.0)
+  ✓ Version up to date (0.5.0)
+  ✓ AI tools: Claude Code + Gemini
+  ✓ Top-level configs present (AGENTS.md, CLAUDE.md, GEMINI.md)
+  ✓ Agents: 8/8 present
+  ✓ Project type coherence: OK (fullstack)
+  ✓ Cross-tool consistency: Claude and Gemini in sync
+  ✓ Standards: 4/4 present
+  ✓ Hooks: quick-scan.sh executable, jq installed, settings.json valid
+  ✓ Project memory: 4/4 files present
+
+  Overall: HEALTHY
+```
+
+**What it checks:** SDD files present, version, agents for your project type, no stray frontend agents in backend projects (and vice versa), Claude and Gemini agents in sync, standards files, hooks and dependencies (`jq`), settings.json integrity, project memory files.
+
+Exit code 1 if errors found — useful for CI pipelines.
+
+### CI/CD (Auto-Generated)
+
+Every project gets a GitHub Actions CI workflow at `.github/workflows/ci.yml`, adapted to your stack:
+
+- **PostgreSQL** projects get a `postgres:16` service with health checks
+- **MongoDB** projects get a `mongo:7` service with health checks
+- **Frontend-only** projects get a lightweight workflow without DB services
+- **GitFlow** projects trigger on both `main` and `develop` branches
+
+Customize the generated workflow as your project grows.
+
 ### After Setup
 
 Open your project in Claude Code or Gemini and start building:
@@ -283,6 +324,9 @@ project/
 ├── GEMINI.md                            # Gemini config (autonomy)
 ├── .env.example                         # Environment variables template
 │
+├── .github/
+│   └── workflows/ci.yml                 # CI pipeline (adapted to your stack)
+│
 ├── .claude/
 │   ├── agents/                          # 9 specialized agents
 │   ├── skills/

package/bin/cli.js

@@ -9,9 +9,13 @@ const projectName = args.find((a) => !a.startsWith('-'));
 const useDefaults = args.includes('--yes') || args.includes('-y');
 const isInit = args.includes('--init');
 const isUpgrade = args.includes('--upgrade');
+const isDoctor = args.includes('--doctor');
 const isForce = args.includes('--force');
 
 async function main() {
+  if (isDoctor) {
+    return runDoctorCmd();
+  }
   if (isUpgrade) {
     return runUpgrade();
   }
@@ -21,6 +25,23 @@ async function main() {
   return runCreate();
 }
 
+function runDoctorCmd() {
+  const { runDoctor, printResults } = require('../lib/doctor');
+
+  const cwd = process.cwd();
+
+  // Validate: must be in an existing project
+  if (!fs.existsSync(path.join(cwd, 'package.json'))) {
+    console.error('Error: No package.json found in current directory.');
+    console.error('The --doctor flag must be run from inside an existing project.');
+    process.exit(1);
+  }
+
+  const results = runDoctor(cwd);
+  const exitCode = printResults(results);
+  process.exit(exitCode);
+}
+
 async function runCreate() {
   const { runWizard, buildDefaultConfig } = require('../lib/wizard');
   const { generate } = require('../lib/generator');

package/lib/doctor.js

@@ -0,0 +1,492 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+const {
+  FRONTEND_AGENTS,
+  BACKEND_AGENTS,
+  TEMPLATE_AGENTS,
+} = require('./config');
+const {
+  readInstalledVersion,
+  getPackageVersion,
+  detectAiTools,
+  detectProjectType,
+} = require('./upgrade-generator');
+
+const PASS = 'pass';
+const WARN = 'warn';
+const FAIL = 'fail';
+
+const EXPECTED_MEMORY_FILES = [
+  'product-tracker.md',
+  'bugs.md',
+  'decisions.md',
+  'key_facts.md',
+];
+
+/**
+ * Run all doctor checks and return results.
+ */
+function runDoctor(cwd) {
+  const results = [];
+
+  // 1. SDD Installed
+  results.push(checkInstalled(cwd));
+
+  // 2. Version
+  results.push(checkVersion(cwd));
+
+  // Detect config for subsequent checks
+  const aiTools = detectAiTools(cwd);
+  const projectType = detectProjectType(cwd);
+
+  // 3. AI Tool Config
+  results.push(checkAiToolConfig(cwd, aiTools));
+
+  // 4. Top-level Configs
+  results.push(checkTopLevelConfigs(cwd, aiTools));
+
+  // 5. Agents Complete
+  results.push(checkAgentsComplete(cwd, aiTools, projectType));
+
+  // 6. Project Type Coherence
+  results.push(checkProjectTypeCoherence(cwd, aiTools, projectType));
+
+  // 7. Cross-tool Consistency
+  results.push(checkCrossToolConsistency(cwd, aiTools));
+
+  // 8. Standards Present
+  results.push(checkStandards(cwd, projectType));
+
+  // 9. Hooks & Dependencies
+  results.push(checkHooksAndDeps(cwd, aiTools));
+
+  // 10. Project Memory
+  results.push(checkProjectMemory(cwd));
+
+  return results;
+}
+
+/**
+ * Print doctor results and return exit code.
+ */
+function printResults(results) {
+  console.log('\n🩺 SDD DevFlow Doctor\n');
+
+  for (const r of results) {
+    const icon = r.status === PASS ? '✓' : r.status === WARN ? '⚠' : '✗';
+    console.log(`  ${icon} ${r.message}`);
+    if (r.details && r.details.length > 0) {
+      for (const d of r.details) {
+        console.log(`    ${d}`);
+      }
+    }
+  }
+
+  const fails = results.filter((r) => r.status === FAIL).length;
+  const warns = results.filter((r) => r.status === WARN).length;
+
+  let overall;
+  if (fails > 0) {
+    overall = 'UNHEALTHY';
+  } else if (warns > 0) {
+    overall = 'NEEDS ATTENTION';
+  } else {
+    overall = 'HEALTHY';
+  }
+
+  const parts = [];
+  if (fails > 0) parts.push(`${fails} error${fails > 1 ? 's' : ''}`);
+  if (warns > 0) parts.push(`${warns} warning${warns > 1 ? 's' : ''}`);
+
+  console.log(`\n  Overall: ${overall}${parts.length > 0 ? ` (${parts.join(', ')})` : ''}\n`);
+
+  return fails > 0 ? 1 : 0;
+}
+
+// --- Individual checks ---
+
+function checkInstalled(cwd) {
+  const missing = [];
+  if (!fs.existsSync(path.join(cwd, 'ai-specs'))) missing.push('ai-specs/');
+  if (!fs.existsSync(path.join(cwd, '.sdd-version'))) missing.push('.sdd-version');
+  if (!fs.existsSync(path.join(cwd, 'AGENTS.md'))) missing.push('AGENTS.md');
+
+  if (missing.length > 0) {
+    return {
+      status: FAIL,
+      message: 'SDD not installed — missing: ' + missing.join(', '),
+      details: ['Run: npx create-sdd-project --init'],
+    };
+  }
+
+  const version = readInstalledVersion(cwd);
+  return {
+    status: PASS,
+    message: `SDD installed (v${version})`,
+    details: [],
+  };
+}
+
+function checkVersion(cwd) {
+  const installed = readInstalledVersion(cwd);
+  const pkg = getPackageVersion();
+
+  if (installed === 'unknown') {
+    return {
+      status: WARN,
+      message: 'Version unknown — .sdd-version file missing or empty',
+      details: [],
+    };
+  }
+
+  if (installed !== pkg) {
+    return {
+      status: WARN,
+      message: `Version mismatch: installed ${installed}, package ${pkg}`,
+      details: ['Run: npx create-sdd-project --upgrade'],
+    };
+  }
+
+  return {
+    status: PASS,
+    message: `Version up to date (${installed})`,
+    details: [],
+  };
+}
+
+function checkAiToolConfig(cwd, aiTools) {
+  const issues = [];
+
+  const checkToolDir = (dir, name) => {
+    const base = path.join(cwd, dir);
+    if (!fs.existsSync(base)) {
+      issues.push(`${dir}/ directory missing`);
+      return;
+    }
+    if (!fs.existsSync(path.join(base, 'agents'))) issues.push(`${dir}/agents/ missing`);
+    if (!fs.existsSync(path.join(base, 'skills'))) issues.push(`${dir}/skills/ missing`);
+  };
+
+  if (aiTools !== 'gemini') checkToolDir('.claude', 'Claude Code');
+  if (aiTools !== 'claude') checkToolDir('.gemini', 'Gemini');
+
+  if (issues.length > 0) {
+    return {
+      status: FAIL,
+      message: 'AI tool config incomplete',
+      details: issues,
+    };
+  }
+
+  const label = aiTools === 'both' ? 'Claude Code + Gemini' : aiTools === 'claude' ? 'Claude Code' : 'Gemini';
+  return {
+    status: PASS,
+    message: `AI tools: ${label}`,
+    details: [],
+  };
+}
+
+function checkTopLevelConfigs(cwd, aiTools) {
+  const missing = [];
+
+  if (aiTools !== 'gemini' && !fs.existsSync(path.join(cwd, 'CLAUDE.md'))) {
+    missing.push('CLAUDE.md');
+  }
+  if (aiTools !== 'claude' && !fs.existsSync(path.join(cwd, 'GEMINI.md'))) {
+    missing.push('GEMINI.md');
+  }
+
+  if (missing.length > 0) {
+    return {
+      status: FAIL,
+      message: 'Missing top-level configs: ' + missing.join(', '),
+      details: ['Run: npx create-sdd-project --upgrade --force'],
+    };
+  }
+
+  return {
+    status: PASS,
+    message: 'Top-level configs present (AGENTS.md' +
+      (aiTools !== 'gemini' ? ', CLAUDE.md' : '') +
+      (aiTools !== 'claude' ? ', GEMINI.md' : '') + ')',
+    details: [],
+  };
+}
+
+function checkAgentsComplete(cwd, aiTools, projectType) {
+  let expectedAgents;
+  if (projectType === 'backend') {
+    expectedAgents = TEMPLATE_AGENTS.filter((a) => !FRONTEND_AGENTS.includes(a));
+  } else if (projectType === 'frontend') {
+    expectedAgents = TEMPLATE_AGENTS.filter((a) => !BACKEND_AGENTS.includes(a));
+  } else {
+    expectedAgents = [...TEMPLATE_AGENTS];
+  }
+
+  const toolDir = aiTools !== 'gemini' ? '.claude' : '.gemini';
+  const agentsDir = path.join(cwd, toolDir, 'agents');
+  if (!fs.existsSync(agentsDir)) {
+    return {
+      status: FAIL,
+      message: 'Agents directory missing',
+      details: [],
+    };
+  }
+
+  const present = fs.readdirSync(agentsDir).filter((f) => f.endsWith('.md'));
+  const missing = expectedAgents.filter((a) => !present.includes(a));
+  const expectedCount = expectedAgents.length;
+  const templatePresent = expectedAgents.filter((a) => present.includes(a)).length;
+
+  if (missing.length > 0) {
+    return {
+      status: WARN,
+      message: `Agents: ${templatePresent}/${expectedCount} template agents present — missing ${missing.length}`,
+      details: missing.map((a) => `Missing: ${a}`),
+    };
+  }
+
+  const customCount = present.length - templatePresent;
+  const customNote = customCount > 0 ? ` + ${customCount} custom` : '';
+  return {
+    status: PASS,
+    message: `Agents: ${templatePresent}/${expectedCount} present${customNote}`,
+    details: [],
+  };
+}
+
+function checkProjectTypeCoherence(cwd, aiTools, projectType) {
+  const issues = [];
+  const toolDir = aiTools !== 'gemini' ? '.claude' : '.gemini';
+  const agentsDir = path.join(cwd, toolDir, 'agents');
+
+  if (!fs.existsSync(agentsDir)) {
+    return { status: PASS, message: 'Project type coherence: OK (no agents dir)', details: [] };
+  }
+
+  const agents = fs.readdirSync(agentsDir).filter((f) => f.endsWith('.md'));
+
+  if (projectType === 'backend') {
+    const unexpected = agents.filter((a) => FRONTEND_AGENTS.includes(a));
+    if (unexpected.length > 0) {
+      issues.push(...unexpected.map((a) => `Frontend agent in backend project: ${a}`));
+    }
+    if (fs.existsSync(path.join(cwd, 'ai-specs', 'specs', 'frontend-standards.mdc'))) {
+      issues.push('frontend-standards.mdc present in backend-only project');
+    }
+  } else if (projectType === 'frontend') {
+    const unexpected = agents.filter((a) => BACKEND_AGENTS.includes(a));
+    if (unexpected.length > 0) {
+      issues.push(...unexpected.map((a) => `Backend agent in frontend project: ${a}`));
+    }
+    if (fs.existsSync(path.join(cwd, 'ai-specs', 'specs', 'backend-standards.mdc'))) {
+      issues.push('backend-standards.mdc present in frontend-only project');
+    }
+  }
+
+  if (issues.length > 0) {
+    return {
+      status: WARN,
+      message: `Project type coherence: ${issues.length} issue${issues.length > 1 ? 's' : ''}`,
+      details: issues,
+    };
+  }
+
+  return {
+    status: PASS,
+    message: `Project type coherence: OK (${projectType})`,
+    details: [],
+  };
+}
+
+function checkCrossToolConsistency(cwd, aiTools) {
+  if (aiTools !== 'both') {
+    return {
+      status: PASS,
+      message: 'Cross-tool consistency: N/A (single tool)',
+      details: [],
+    };
+  }
+
+  const issues = [];
+
+  // Compare agents
+  const claudeAgentsDir = path.join(cwd, '.claude', 'agents');
+  const geminiAgentsDir = path.join(cwd, '.gemini', 'agents');
+
+  if (fs.existsSync(claudeAgentsDir) && fs.existsSync(geminiAgentsDir)) {
+    const claudeAgents = new Set(fs.readdirSync(claudeAgentsDir).filter((f) => f.endsWith('.md')));
+    const geminiAgents = new Set(fs.readdirSync(geminiAgentsDir).filter((f) => f.endsWith('.md')));
+
+    for (const a of claudeAgents) {
+      if (!geminiAgents.has(a)) issues.push(`Agent in .claude but not .gemini: ${a}`);
+    }
+    for (const a of geminiAgents) {
+      if (!claudeAgents.has(a)) issues.push(`Agent in .gemini but not .claude: ${a}`);
+    }
+  }
+
+  // Compare skills (directory names)
+  const claudeSkillsDir = path.join(cwd, '.claude', 'skills');
+  const geminiSkillsDir = path.join(cwd, '.gemini', 'skills');
+
+  if (fs.existsSync(claudeSkillsDir) && fs.existsSync(geminiSkillsDir)) {
+    const claudeSkills = new Set(fs.readdirSync(claudeSkillsDir).filter((f) =>
+      fs.statSync(path.join(claudeSkillsDir, f)).isDirectory()
+    ));
+    const geminiSkills = new Set(fs.readdirSync(geminiSkillsDir).filter((f) =>
+      fs.statSync(path.join(geminiSkillsDir, f)).isDirectory()
+    ));
+
+    for (const s of claudeSkills) {
+      if (!geminiSkills.has(s)) issues.push(`Skill in .claude but not .gemini: ${s}`);
+    }
+    for (const s of geminiSkills) {
+      if (!claudeSkills.has(s)) issues.push(`Skill in .gemini but not .claude: ${s}`);
+    }
+  }
+
+  if (issues.length > 0) {
+    return {
+      status: WARN,
+      message: `Cross-tool consistency: ${issues.length} mismatch${issues.length > 1 ? 'es' : ''}`,
+      details: issues,
+    };
+  }
+
+  return {
+    status: PASS,
+    message: 'Cross-tool consistency: Claude and Gemini in sync',
+    details: [],
+  };
+}
+
+function checkStandards(cwd, projectType) {
+  const specsDir = path.join(cwd, 'ai-specs', 'specs');
+  if (!fs.existsSync(specsDir)) {
+    return {
+      status: FAIL,
+      message: 'Standards directory missing (ai-specs/specs/)',
+      details: [],
+    };
+  }
+
+  const expected = ['base-standards.mdc', 'documentation-standards.mdc'];
+  if (projectType !== 'frontend') expected.push('backend-standards.mdc');
+  if (projectType !== 'backend') expected.push('frontend-standards.mdc');
+
+  const missing = expected.filter((f) => !fs.existsSync(path.join(specsDir, f)));
+
+  if (missing.length > 0) {
+    return {
+      status: FAIL,
+      message: `Standards: ${expected.length - missing.length}/${expected.length} present`,
+      details: missing.map((f) => `Missing: ${f}`),
+    };
+  }
+
+  return {
+    status: PASS,
+    message: `Standards: ${expected.length}/${expected.length} present`,
+    details: [],
+  };
+}
+
+function checkHooksAndDeps(cwd, aiTools) {
+  if (aiTools === 'gemini') {
+    return {
+      status: PASS,
+      message: 'Hooks: N/A (Gemini only)',
+      details: [],
+    };
+  }
+
+  const issues = [];
+
+  // Check quick-scan.sh
+  const hookPath = path.join(cwd, '.claude', 'hooks', 'quick-scan.sh');
+  if (!fs.existsSync(hookPath)) {
+    issues.push('quick-scan.sh missing');
+  } else {
+    try {
+      const stats = fs.statSync(hookPath);
+      if (!(stats.mode & 0o111)) {
+        issues.push('quick-scan.sh is not executable (run: chmod +x .claude/hooks/quick-scan.sh)');
+      }
+    } catch { /* ignore */ }
+  }
+
+  // Check jq
+  try {
+    execSync('which jq', { stdio: 'pipe' });
+  } catch {
+    issues.push('jq not installed — quick-scan hook needs it (brew install jq / apt install jq)');
+  }
+
+  // Check settings.json
+  const settingsPath = path.join(cwd, '.claude', 'settings.json');
+  if (!fs.existsSync(settingsPath)) {
+    issues.push('settings.json missing');
+  } else {
+    try {
+      const settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
+      if (!settings.hooks) {
+        issues.push('settings.json: no hooks configured');
+      }
+    } catch (e) {
+      issues.push(`settings.json: invalid JSON — ${e.message}`);
+    }
+  }
+
+  if (issues.length > 0) {
+    const hasFail = issues.some((i) => i.includes('missing') || i.includes('invalid JSON'));
+    return {
+      status: hasFail ? FAIL : WARN,
+      message: `Hooks: ${issues.length} issue${issues.length > 1 ? 's' : ''}`,
+      details: issues,
+    };
+  }
+
+  return {
+    status: PASS,
+    message: 'Hooks: quick-scan.sh executable, jq installed, settings.json valid',
+    details: [],
+  };
+}
+
+function checkProjectMemory(cwd) {
+  const notesDir = path.join(cwd, 'docs', 'project_notes');
+  if (!fs.existsSync(notesDir)) {
+    return {
+      status: WARN,
+      message: 'Project memory: docs/project_notes/ missing',
+      details: [],
+    };
+  }
+
+  const missing = EXPECTED_MEMORY_FILES.filter(
+    (f) => !fs.existsSync(path.join(notesDir, f))
+  );
+
+  if (missing.length > 0) {
+    return {
+      status: WARN,
+      message: `Project memory: ${EXPECTED_MEMORY_FILES.length - missing.length}/${EXPECTED_MEMORY_FILES.length} files`,
+      details: missing.map((f) => `Missing: ${f}`),
+    };
+  }
+
+  return {
+    status: PASS,
+    message: `Project memory: ${EXPECTED_MEMORY_FILES.length}/${EXPECTED_MEMORY_FILES.length} files present`,
+    details: [],
+  };
+}
+
+module.exports = {
+  runDoctor,
+  printResults,
+};

package/lib/generator.js

@@ -66,6 +66,10 @@ function generate(config) {
     adaptAgentContent(dest, config);
   }
 
+  // 7c. Adapt CI workflow for project type and stack
+  step('Configuring CI workflow');
+  adaptCiWorkflow(dest, config);
+
   // 8. Remove AI tool config if single tool selected
   if (config.aiTools === 'claude') {
     step('Removing Gemini config (Claude only)');
@@ -350,4 +354,46 @@ function adaptAgentContent(dest, config) {
   adaptAgentContentForProjectType(dest, config, replaceInFile);
 }
 
+function adaptCiWorkflow(dest, config) {
+  const ciPath = path.join(dest, '.github', 'workflows', 'ci.yml');
+  if (!fs.existsSync(ciPath)) return;
+
+  const bPreset = config.backendPreset || BACKEND_STACKS[0];
+
+  // Adapt branches for gitflow
+  if (config.branching === 'gitflow') {
+    replaceInFile(ciPath, [
+      ['branches: [main]', 'branches: [main, develop]'],
+    ]);
+  }
+
+  // Adapt DB services based on stack
+  if (config.projectType === 'frontend') {
+    // Frontend-only: remove services and DATABASE_URL
+    replaceInFile(ciPath, [
+      [/\n    # -- Database service.*?--health-retries=5\n/s, ''],
+      [/\n      DATABASE_URL:.*\n/, '\n'],
+    ]);
+  } else if (bPreset.db === 'MongoDB') {
+    // MongoDB: replace postgres service with mongo
+    replaceInFile(ciPath, [
+      [/    # -- Database service.*?--health-retries=5\n/s,
+        `    # -- Database service (remove if not needed) --\n` +
+        `    services:\n` +
+        `      mongodb:\n` +
+        `        image: mongo:7\n` +
+        `        ports:\n` +
+        `          - 27017:27017\n` +
+        `        options: >-\n` +
+        `          --health-cmd="mongosh --eval 'db.runCommand({ping:1})'"\n` +
+        `          --health-interval=10s\n` +
+        `          --health-timeout=5s\n` +
+        `          --health-retries=5\n`],
+      ['DATABASE_URL: postgresql://test:test@localhost:5432/testdb',
+        'MONGODB_URI: mongodb://localhost:27017/testdb'],
+    ]);
+  }
+  // Default (PostgreSQL) — template already has correct services
+}
+
 module.exports = { generate };

package/lib/init-generator.js

@@ -184,7 +184,20 @@ function generateInit(config) {
   // 8. Append to .gitignore
   appendGitignore(dest, skipped);
 
-  // 9. Copy and adapt .env.example if not present
+  // 9. Copy CI workflow if not present
+  const githubDir = path.join(dest, '.github', 'workflows');
+  const ciPath = path.join(githubDir, 'ci.yml');
+  if (!fs.existsSync(ciPath)) {
+    step('Creating .github/workflows/ci.yml');
+    ensureDir(githubDir);
+    let ciContent = fs.readFileSync(path.join(templateDir, '.github', 'workflows', 'ci.yml'), 'utf8');
+    ciContent = adaptCiWorkflowContent(ciContent, config, scan);
+    fs.writeFileSync(ciPath, ciContent, 'utf8');
+  } else {
+    skipped.push('.github/workflows/ci.yml');
+  }
+
+  // 10. Copy and adapt .env.example if not present
   const envExamplePath = path.join(dest, '.env.example');
   if (!fs.existsSync(envExamplePath)) {
     let envContent = fs.readFileSync(path.join(templateDir, '.env.example'), 'utf8');
@@ -950,6 +963,47 @@ function updateAutonomy(dest, config) {
   }
 }
 
+// --- CI Workflow Adaptation ---
+
+function adaptCiWorkflowContent(template, config, scan) {
+  let content = template;
+
+  // Adapt branches for gitflow
+  if (config.branching === 'gitflow') {
+    content = content.replaceAll('branches: [main]', 'branches: [main, develop]');
+  }
+
+  // Adapt DB services based on detected stack
+  if (!scan.backend.detected) {
+    // Frontend-only: remove services block and DATABASE_URL
+    content = content.replace(/\n    # -- Database service.*?--health-retries=5\n/s, '');
+    content = content.replace(/\n      DATABASE_URL:.*\n/, '\n');
+  } else if (scan.backend.db === 'MongoDB') {
+    // MongoDB: replace postgres service with mongo
+    content = content.replace(
+      /    # -- Database service.*?--health-retries=5\n/s,
+      `    # -- Database service (remove if not needed) --\n` +
+      `    services:\n` +
+      `      mongodb:\n` +
+      `        image: mongo:7\n` +
+      `        ports:\n` +
+      `          - 27017:27017\n` +
+      `        options: >-\n` +
+      `          --health-cmd="mongosh --eval 'db.runCommand({ping:1})'"\n` +
+      `          --health-interval=10s\n` +
+      `          --health-timeout=5s\n` +
+      `          --health-retries=5\n`
+    );
+    content = content.replace(
+      'DATABASE_URL: postgresql://test:test@localhost:5432/testdb',
+      'MONGODB_URI: mongodb://localhost:27017/testdb'
+    );
+  }
+  // Default (PostgreSQL) — template already has correct services
+
+  return content;
+}
+
 // --- .env.example Adaptation ---
 
 function adaptEnvExample(template, config, scan) {
@@ -1008,6 +1062,7 @@ module.exports = {
   adaptAgentsMd,
   adaptCopiedFiles,
   adaptEnvExample,
+  adaptCiWorkflowContent,
   updateAutonomy,
   regexReplaceInFile,
 };

package/lib/upgrade-generator.js

@@ -16,6 +16,7 @@ const {
   adaptAgentsMd,
   adaptCopiedFiles,
   adaptEnvExample,
+  adaptCiWorkflowContent,
   updateAutonomy,
   regexReplaceInFile,
 } = require('./init-generator');
@@ -408,6 +409,17 @@ function generateUpgrade(config) {
 
   step('Replaced AGENTS.md, CLAUDE.md/GEMINI.md, .env.example');
 
+  // --- e2) CI workflow — only add if not present (user may have customized) ---
+  const ciPath = path.join(dest, '.github', 'workflows', 'ci.yml');
+  if (!fs.existsSync(ciPath)) {
+    fs.mkdirSync(path.join(dest, '.github', 'workflows'), { recursive: true });
+    let ciContent = fs.readFileSync(path.join(templateDir, '.github', 'workflows', 'ci.yml'), 'utf8');
+    ciContent = adaptCiWorkflowContent(ciContent, config, scan);
+    fs.writeFileSync(ciPath, ciContent, 'utf8');
+    step('Added .github/workflows/ci.yml');
+    replaced++;
+  }
+
   // --- f) Adapt for project type ---
   // Remove agents for single-stack projects
   if (projectType === 'backend') {

package/package.json

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

package/template/.github/workflows/ci.yml

@@ -0,0 +1,56 @@
+# ===========================================
+# CI Pipeline — Generated by SDD DevFlow
+# ===========================================
+# Runs on pushes and PRs to main branch.
+# Customize steps as your project grows.
+
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  ci:
+    runs-on: ubuntu-latest
+
+    # -- Database service (remove if not needed) --
+    services:
+      postgres:
+        image: postgres:16
+        env:
+          POSTGRES_USER: test
+          POSTGRES_PASSWORD: test
+          POSTGRES_DB: testdb
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd="pg_isready"
+          --health-interval=10s
+          --health-timeout=5s
+          --health-retries=5
+
+    env:
+      NODE_ENV: test
+      DATABASE_URL: postgresql://test:test@localhost:5432/testdb
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - run: npm ci
+
+      - name: Lint
+        run: npm run lint --if-present
+
+      - name: Test
+        run: npm test --if-present
+
+      - name: Build
+        run: npm run build --if-present