create-sdd-project 0.1.1 → 0.2.0

package/README.md

@@ -94,34 +94,59 @@ Tracks institutional knowledge across sessions in `docs/project_notes/`:
 
 ## Quick Start
 
-### 1. Copy the template
+### Option A: New Project (recommended)
 
 ```bash
-cp -r template/ /path/to/your-project/
+npx create-sdd-project my-app
 ```
 
-### 2. Configure for your project
+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
 
-Look for `<!-- CONFIG: ... -->` comments in these files:
+Non-interactive mode with defaults:
+```bash
+npx create-sdd-project my-app --yes
+```
 
-| File | What to configure |
-|------|-------------------|
-| `CLAUDE.md` / `GEMINI.md` | Autonomy level (1-4) |
-| `ai-specs/specs/backend-standards.mdc` | Backend tech stack |
-| `ai-specs/specs/frontend-standards.mdc` | Frontend tech stack |
-| `docs/project_notes/key_facts.md` | Project name, ports, URLs, branching strategy |
-| `docs/specs/api-spec.yaml` | Server URLs |
-| `AGENTS.md` | Monorepo layout |
+### Option B: Existing Project
 
-### 3. Initialize and start
+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
 ```
 
 The workflow skill will guide you through each step with checkpoints based on your autonomy level.
 
+### Manual Setup (alternative)
+
+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
 
 ```
@@ -145,6 +170,12 @@ project/
 │
 ├── .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
+│   ├── commands/                        # Slash command shortcuts
 │   ├── settings.json                    # Gemini configuration
 │   └── styles/default.md               # Response style
 │
@@ -197,7 +228,7 @@ These 6 principles apply to ALL tasks, ALL agents, ALL complexity levels:
 
 - **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
-- **Setup Script + npx**: Interactive installer (`npx create-sdd-project`) for automated setup
+- **Retrofit Testing**: Automated test generation for existing projects with low coverage
 
 ## License
 

package/bin/cli.js

@@ -2,14 +2,24 @@
 'use strict';
 
 const fs = require('fs');
-const { runWizard, buildDefaultConfig } = require('../lib/wizard');
-const { generate } = require('../lib/generator');
+const path = require('path');
 
 const args = process.argv.slice(2);
 const projectName = args.find((a) => !a.startsWith('-'));
 const useDefaults = args.includes('--yes') || args.includes('-y');
+const isInit = args.includes('--init');
 
 async function main() {
+  if (isInit) {
+    return runInit();
+  }
+  return runCreate();
+}
+
+async function runCreate() {
+  const { runWizard, buildDefaultConfig } = require('../lib/wizard');
+  const { generate } = require('../lib/generator');
+
   let config;
 
   if (useDefaults) {
@@ -38,6 +48,48 @@ async function main() {
   generate(config);
 }
 
+async function runInit() {
+  const { scan } = require('../lib/scanner');
+  const { runInitWizard, buildInitDefaultConfig } = require('../lib/init-wizard');
+  const { generateInit } = require('../lib/init-generator');
+
+  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 --init flag must be run from inside an existing project.');
+    console.error('\nTo create a new project, run: create-sdd-project <project-name>');
+    process.exit(1);
+  }
+
+  // Validate: SDD not already installed
+  if (fs.existsSync(path.join(cwd, 'ai-specs'))) {
+    console.error('Error: ai-specs/ directory already exists.');
+    console.error('SDD DevFlow appears to already be installed in this project.');
+    process.exit(1);
+  }
+
+  // Validate: no project name with --init
+  if (projectName) {
+    console.error('Error: Cannot specify a project name with --init.');
+    console.error('Usage: create-sdd-project --init');
+    process.exit(1);
+  }
+
+  // Scan the project
+  const scanResult = scan(cwd);
+
+  let config;
+  if (useDefaults) {
+    config = buildInitDefaultConfig(scanResult);
+  } else {
+    config = await runInitWizard(scanResult);
+  }
+
+  generateInit(config);
+}
+
 main().catch((err) => {
   console.error('\nError:', err.message);
   process.exit(1);