create-sdd-project 0.2.2 → 0.3.0

package/README.md

@@ -1,18 +1,67 @@
 # SDD DevFlow
 
-**Spec-Driven Development workflow template for AI-assisted coding.**
+[![npm version](https://img.shields.io/npm/v/create-sdd-project)](https://www.npmjs.com/package/create-sdd-project)
+[![license](https://img.shields.io/npm/l/create-sdd-project)](LICENSE)
+[![node](https://img.shields.io/node/v/create-sdd-project)](package.json)
 
-A development methodology designed for Claude Code and Gemini that combines specialized AI agents, workflow orchestration with human checkpoints, and institutional memory. Built for creating robust, maintainable, and scalable TypeScript projects.
+**Spec-Driven Development workflow for AI-assisted coding.**
+
+A complete development methodology for Claude Code and Gemini that combines specialized AI agents, workflow orchestration with human checkpoints, and institutional memory. Works with new and existing TypeScript/JavaScript projects.
+
+## Quick Start
+
+### New Project
+
+```bash
+npx create-sdd-project my-app
+```
+
+The interactive wizard asks about your stack, AI tools, and autonomy level. For defaults (fullstack Express+Next.js):
+
+```bash
+npx create-sdd-project my-app --yes
+```
+
+### Existing Project
+
+```bash
+cd your-existing-project
+npx create-sdd-project --init
+```
+
+Scans your project, detects your stack and architecture, and installs SDD files adapted to your project. Never modifies existing code or overwrites existing files.
+
+### After Setup
+
+Open in your AI coding tool and run:
+
+```
+add feature "your first feature"
+start task F001
+```
+
+The workflow skill guides you through each step with checkpoints based on your autonomy level.
+
+---
 
 ## What is SDD?
 
 SDD DevFlow combines three proven practices:
 
 1. **Spec-Driven Development** — Write specifications before code. Specs are the contract between planning and implementation.
-2. **Test-Driven Development** — Red-Green-Refactor cycle for every feature. Tests define expected behavior before implementation.
-3. **Human-in-the-Loop** — Strategic checkpoints (spec, ticket, plan, commit, merge) with configurable autonomy levels that reduce human intervention as trust increases.
+2. **Test-Driven Development** — Red-Green-Refactor cycle for every feature.
+3. **Human-in-the-Loop** — Strategic checkpoints with configurable autonomy levels that reduce human intervention as trust increases.
+
+### 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.** 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.
+
+---
 
-## What's Inside
+## What's Included
 
 ### 9 Specialized Agents
 
@@ -26,126 +75,86 @@ SDD DevFlow combines three proven practices:
 | `qa-engineer` | Edge cases, spec verification | 5 |
 | `database-architect` | Schema design, optimization | Any |
 
+### 3 Skills (Slash Commands)
+
+| Skill | Trigger | What it does |
+|-------|---------|-------------|
+| `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 |
+
 ### Workflow (Steps 0–6)
 
 ```
-0. SPEC      → spec-creator drafts specs        → Spec Approval (Std/Cplx)
-1. SETUP     → Branch, ticket, sprint tracker    → Ticket Approval (Std/Cplx)
-2. PLAN      → Planner creates implementation plan → Plan Approval (Std/Cplx)
+0. SPEC      → spec-creator drafts specs        → Spec 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
 5. REVIEW    → PR, code review, QA              → Merge Approval
 6. COMPLETE  → Clean up, update tracker
 ```
 
-**Step flow by complexity:**
-- **Simple**: 1 → 3 → 4 → 5 → 6
-- **Standard**: 0 → 1 → 2 → 3 → 4 → 5 (+QA) → 6
-- **Complex**: 0 → 1 (+ADR) → 2 → 3 → 4 → 5 (+QA) → 6
-
-### 3 Complexity Tiers
-
-| Tier | Spec | Ticket | Plan | QA |
-|------|:----:|:------:|:----:|:--:|
-| Simple | Skip | Skip | Skip | Skip |
-| Standard | Yes | Yes | Yes | Yes |
-| Complex | Yes | Yes + ADR | Yes | Yes |
+**By complexity:**
+- **Simple** (bug fixes, small tweaks): 1 → 3 → 4 → 5 → 6
+- **Standard** (features): 0 → 1 → 2 → 3 → 4 → 5 (+QA) → 6
+- **Complex** (architectural changes): 0 → 1 (+ADR) → 2 → 3 → 4 → 5 (+QA) → 6
 
 ### 4 Autonomy Levels
 
-Control how many human approval checkpoints are active:
-
 | 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 |
 
 Quality gates (tests, lint, build, validators) **always run** regardless of level.
 
-### Branching Strategy
-
-Configurable per-project in `key_facts.md`:
-
-- **GitHub Flow** (default): `main` + `feature/*` + `hotfix/*`. Best for MVPs.
-- **GitFlow** (scaled): `main` + `develop` + `feature/*` + `release/*` + `hotfix/*`. For larger projects.
-
 ### Project Memory
 
 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
 
 ### 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. Critical issues block; warnings pass through.
-- **Compaction Recovery** — After context compaction, injects a reminder to read the sprint tracker for context recovery.
-- **Notifications** — Personal notification hooks (macOS/Linux) in `.claude/settings.local.json`.
+- **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 product tracker for context recovery
 
 ### Multi-Tool Support
 
-- **Claude Code**: Full support with agents, skills, hooks, and settings (`.claude/`)
-- **Gemini**: Adapted agent format (`.gemini/`), same methodology via `ai-specs/specs/`
-- **Other tools**: `AGENTS.md` provides universal instructions readable by 21+ AI coding tools
+| Tool | Support Level |
+|------|--------------|
+| **Claude Code** | Full — agents, skills, hooks, settings (`.claude/`) |
+| **Gemini** | Full — agents, skills, commands, settings (`.gemini/`) |
+| **Other AI tools** | `AGENTS.md` provides universal instructions (Cursor, Copilot, Windsurf, etc.) |
 
-## Quick Start
+---
 
-### Option A: New Project (recommended)
+## `--init` Stack Detection
 
-```bash
-npx create-sdd-project my-app
-```
-
-The interactive wizard guides you through:
-
-1. **Project basics** — name, description, business context
-2. **Tech stack** — backend (Express+Prisma+PG, Express+MongoDB, or custom), frontend (Next.js+Tailwind or custom), or both
-3. **Configuration** — AI tools (Claude/Gemini/both), autonomy level (L1-L4), branching strategy
-
-Non-interactive mode with defaults:
-```bash
-npx create-sdd-project my-app --yes
-```
-
-### Option B: Existing Project
-
-Add SDD DevFlow to a project that already has code:
-
-```bash
-cd your-existing-project
-npx create-sdd-project --init
-```
-
-The `--init` flag:
-- **Scans** your project: detects stack (Express, Next.js, Prisma, etc.), architecture (MVC, DDD, feature-based), tests, and existing docs
-- **Adapts** standards files to match your real architecture (not generic DDD defaults)
-- **Imports** existing OpenAPI/Swagger specs and references Prisma schemas
-- **Audits** test coverage and suggests retrofit testing tasks if coverage is low
-- **Never** modifies your existing code or overwrites existing files
-
-### After setup
-
-```
-# Open in your AI coding tool and run:
-init sprint 0
-start task B0.1
-```
+When running `--init` on an existing project, the scanner automatically detects:
 
-The workflow skill will guide you through each step with checkpoints based on your autonomy level.
+| Category | Detected |
+|----------|----------|
+| **Backend frameworks** | Express, Fastify, Koa, NestJS, Hapi, AdonisJS |
+| **ORMs** | Prisma, Mongoose, TypeORM, Sequelize, Drizzle, Knex, MikroORM, Objection.js |
+| **Databases** | PostgreSQL, MySQL, SQLite, MongoDB, SQL Server, CockroachDB (from Prisma schema, `.env`, or dependencies) |
+| **Frontend frameworks** | Next.js, Nuxt, Remix, Astro, SolidJS, React, Vue, Angular, Svelte |
+| **Styling** | Tailwind CSS, styled-components, Emotion, Sass |
+| **Component libraries** | Radix UI, Headless UI, Material UI, Chakra UI, Ant Design |
+| **State management** | Zustand, Redux, Jotai, TanStack Query, Recoil, Pinia, MobX |
+| **Testing** | Jest, Vitest, Mocha (unit) + Playwright, Cypress (e2e) |
+| **Architecture** | MVC, DDD, feature-based, handler-based, flat |
+| **Project type** | Monorepo (workspaces, Lerna, Turbo, pnpm) or single-package |
 
-### Manual Setup (alternative)
+Standards files are adapted to match your actual architecture — not generic defaults.
 
-If you prefer manual configuration, copy the template directly:
-
-```bash
-cp -r template/ /path/to/your-project/
-```
-
-Then look for `<!-- CONFIG: ... -->` comments in the files to customize.
+---
 
 ## Template Structure
 
@@ -155,7 +164,6 @@ project/
 ├── CLAUDE.md                            # Claude Code config (autonomy, recovery)
 ├── GEMINI.md                            # Gemini config (autonomy)
 ├── .env.example                         # Environment variables template
-├── .gitignore                           # Git ignore with secrets protection
 │
 ├── .claude/
 │   ├── agents/                          # 9 specialized agents
@@ -165,45 +173,37 @@ project/
 │   │   ├── bug-workflow/                # Bug triage and resolution
 │   │   └── project-memory/              # Memory system setup
 │   ├── hooks/quick-scan.sh              # Post-developer quality scan
-│   ├── settings.json                    # Shared hooks (git-tracked)
-│   └── settings.local.json              # Personal hooks (gitignored)
+│   └── settings.json                    # Shared hooks (git-tracked)
 │
 ├── .gemini/
 │   ├── agents/                          # 9 agents (Gemini format)
-│   ├── skills/
-│   │   ├── development-workflow/        # Main task workflow (Steps 0-6)
-│   │   │   └── references/              # Templates, guides, examples
-│   │   ├── bug-workflow/                # Bug triage and resolution
-│   │   └── project-memory/              # Memory system setup
+│   ├── skills/                          # Same 3 skills
 │   ├── commands/                        # Slash command shortcuts
-│   ├── settings.json                    # Gemini configuration
-│   └── styles/default.md               # Response style
+│   └── settings.json                    # Gemini configuration
 │
 ├── ai-specs/specs/
 │   ├── base-standards.mdc              # Constitution + methodology
-│   ├── backend-standards.mdc           # Backend patterns (DDD, Express, Prisma)
-│   ├── frontend-standards.mdc          # Frontend patterns (Next.js, Tailwind, Radix)
-│   └── documentation-standards.mdc     # Documentation update rules
+│   ├── backend-standards.mdc           # Backend patterns
+│   ├── frontend-standards.mdc          # Frontend patterns
+│   └── documentation-standards.mdc     # Documentation rules
 │
 └── docs/
     ├── project_notes/                   # Project memory
-    │   ├── sprint-0-tracker.md          # Sprint tracker template
-    │   ├── key_facts.md                 # Project configuration
-    │   ├── bugs.md                      # Bug log
-    │   └── decisions.md                 # ADRs
-    ├── specs/
-    │   ├── api-spec.yaml                # OpenAPI spec (backend)
-    │   └── ui-components.md             # Component spec (frontend)
-    └── tickets/                         # Task tickets (generated by workflow)
+    │   ├── product-tracker.md
+    │   ├── key_facts.md
+    │   ├── bugs.md
+    │   └── decisions.md
+    ├── specs/                           # API and UI specs
+    └── tickets/                         # Task tickets (workflow-generated)
 ```
 
 ## Default Tech Stack
 
-The template defaults to (configurable via `<!-- CONFIG -->` comments):
+Configurable via the wizard or `<!-- CONFIG -->` comments in template files:
 
 - **Backend**: Node.js + Express + Prisma + PostgreSQL
 - **Frontend**: Next.js (App Router) + Tailwind CSS + Radix UI + Zustand
-- **Shared Types**: Zod schemas in `shared/` workspace → `z.infer<>` for TypeScript types
+- **Shared Types**: Zod schemas with `z.infer<>` for TypeScript types
 - **Testing**: Jest (unit) + Playwright (e2e)
 - **Methodology**: TDD + DDD + Spec-Driven Development
 
@@ -224,10 +224,20 @@ These 6 principles apply to ALL tasks, ALL agents, ALL complexity levels:
 - Node.js 18+
 - `jq` (for quick-scan hook): `brew install jq` (macOS) or `apt install jq` (Linux)
 
+## Manual Setup (Alternative)
+
+If you prefer manual configuration over the CLI wizard:
+
+```bash
+cp -r template/ /path/to/your-project/
+```
+
+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,8 +78,8 @@ const AI_TOOLS = [
 ];
 
 const AUTONOMY_LEVELS = [
-  { level: 1, name: 'Full Control', desc: 'Human approves every checkpoint (first sprint, learning SDD)' },
-  { level: 2, name: 'Trusted', desc: 'Human reviews plans + merges only (default, normal development)', default: true },
+  { 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,7 +50,7 @@ function generate(config) {
     removeBackendFiles(dest, config);
   }
 
-  // 8. Remove AI tool config if single tool selected
+  // 7. 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 });
@@ -76,7 +72,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 +226,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 +245,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 +267,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'],
   ]);
 }
 

package/lib/init-generator.js

@@ -72,7 +72,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 +99,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/
@@ -195,7 +195,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 +214,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 +226,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 ---
@@ -305,9 +305,10 @@ function adaptBackendStandards(template, scan) {
     '<!-- TODO: Review and adjust the sections below to match your project\'s conventions. -->\n<!-- This file was generated from project analysis by create-sdd-project --init. -->'
   );
 
-  // Update globs in frontmatter
+  // Update globs in frontmatter — only include tsx/jsx if frontend detected
   const srcRoot = findSrcRootName(scan);
-  const globPattern = srcRoot ? `${srcRoot}/**/*.{ts,js,tsx,jsx}` : '**/*.{ts,js,tsx,jsx}';
+  const exts = scan.frontend.detected ? 'ts,js,tsx,jsx' : 'ts,js';
+  const globPattern = srcRoot ? `${srcRoot}/**/*.{${exts}}` : `**/*.{${exts}}`;
   content = content.replace(
     /globs: \[.*?\]/,
     `globs: ["${globPattern}"]`
@@ -373,6 +374,21 @@ function adaptBackendStandards(template, scan) {
     );
   }
 
+  // Adapt Validation section based on detected validation library
+  if (scan.backend.validation && scan.backend.validation !== 'Zod') {
+    // Has a validator, but not Zod — replace with detected library name
+    content = content.replace(
+      /## Validation\n\n[\s\S]*?(?=\n## Database Patterns)/,
+      `## Validation\n\n- Validate all inputs at the application layer using ${scan.backend.validation}\n- Validate before executing business logic\n- Return descriptive validation errors\n\n<!-- TODO: Add ${scan.backend.validation} validation patterns for your project. -->\n\n`
+    );
+  } else if (!scan.backend.validation) {
+    // No validation library detected — generic guidance
+    content = content.replace(
+      /## Validation\n\n[\s\S]*?(?=\n## Database Patterns)/,
+      `## Validation\n\n- Validate all inputs at the application layer\n- Validate before executing business logic\n- Return descriptive validation errors\n\n<!-- TODO: Add validation patterns for your project (e.g., Zod, Joi, class-validator). -->\n\n`
+    );
+  }
+
   // Replace Prisma-specific references in Security and Performance sections
   if (scan.backend.orm !== 'Prisma') {
     content = content.replace(
@@ -499,6 +515,12 @@ function adaptAgentsMd(template, config, scan) {
       'Frontend patterns (Next.js, Tailwind, Radix)',
       `Frontend patterns (${parts.join(', ')})`
     );
+  } else {
+    // Remove frontend-standards reference for backend-only projects
+    content = content.replace(
+      /- \[Frontend Standards\].*\n/,
+      ''
+    );
   }
 
   return content;
@@ -624,40 +646,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

@@ -33,6 +33,7 @@ function formatScanSummary(scanResult) {
   const patternLabels = {
     mvc: 'MVC',
     ddd: 'DDD (Domain-Driven Design)',
+    layered: 'Layered (controllers + handlers + managers)',
     'feature-based': 'Feature-based',
     'handler-based': 'Handler-based',
     flat: 'Flat structure',
@@ -219,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/lib/scanner.js

@@ -121,6 +121,22 @@ function detectBackend(dir, pkg) {
   // Port detection
   result.port = detectPort(dir, pkg);
 
+  // Validation library detection
+  const validators = [
+    { dep: 'zod', label: 'Zod' },
+    { dep: 'joi', label: 'Joi' },
+    { dep: 'class-validator', label: 'class-validator' },
+    { dep: 'yup', label: 'Yup' },
+    { dep: 'ajv', label: 'Ajv' },
+  ];
+  result.validation = null;
+  for (const v of validators) {
+    if (deps[v.dep]) {
+      result.validation = v.label;
+      break;
+    }
+  }
+
   // If no framework but has a server-like structure, still mark as detected
   if (!result.detected && (result.orm || result.db)) {
     result.detected = true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-sdd-project",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "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..."
           }
         ]