create-sdd-project 0.8.0 → 0.8.2

package/bin/cli.js

@@ -38,9 +38,9 @@ function runDoctorCmd() {
 
   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.');
+  // Validate: must be in a project with SDD installed
+  if (!fs.existsSync(path.join(cwd, 'package.json')) && !fs.existsSync(path.join(cwd, 'ai-specs'))) {
+    console.error('Error: No package.json or ai-specs/ found in current directory.');
     console.error('The --doctor flag must be run from inside an existing project.');
     process.exit(1);
   }
@@ -142,13 +142,6 @@ async function runUpgrade() {
 
   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 --upgrade flag must be run from inside an existing project.');
-    process.exit(1);
-  }
-
   // Validate: SDD must be installed
   if (!fs.existsSync(path.join(cwd, 'ai-specs'))) {
     console.error('Error: ai-specs/ directory not found.');
@@ -234,13 +227,6 @@ async function runEject() {
 
   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 --eject flag must be run from inside an existing project.');
-    process.exit(1);
-  }
-
   // Validate: SDD must be installed
   if (!fs.existsSync(path.join(cwd, 'ai-specs'))) {
     console.error('Error: ai-specs/ directory not found.');
@@ -292,11 +278,6 @@ async function runDiff() {
 
   const cwd = process.cwd();
 
-  if (!fs.existsSync(path.join(cwd, 'package.json'))) {
-    console.error('Error: No package.json found in current directory.');
-    process.exit(1);
-  }
-
   if (isEject) {
     // Same validation as --eject
     if (!fs.existsSync(path.join(cwd, 'ai-specs'))) {
@@ -319,6 +300,11 @@ async function runDiff() {
 
   if (isInit) {
     // Same validation as --init
+    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.');
+      process.exit(1);
+    }
     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. Use --upgrade --diff instead.');

package/lib/generator.js

@@ -19,6 +19,16 @@ function generate(config) {
   step('Copying template files');
   fs.cpSync(templateDir, dest, { recursive: true });
 
+  // 1b. Rename gitignore → .gitignore (npm strips .gitignore during publish)
+  const gitignoreSrc = path.join(dest, 'gitignore');
+  if (fs.existsSync(gitignoreSrc)) {
+    fs.renameSync(gitignoreSrc, path.join(dest, '.gitignore'));
+  }
+
+  // 1c. Generate package.json
+  step('Generating package.json');
+  generatePackageJson(dest, config);
+
   // 2. Configure key_facts.md
   step(`Configuring project: ${config.projectName}`);
   updateKeyFacts(dest, config);
@@ -396,4 +406,23 @@ function adaptCiWorkflow(dest, config) {
   // Default (PostgreSQL) — template already has correct services
 }
 
+function generatePackageJson(dest, config) {
+  const pkg = {
+    name: config.projectName,
+    version: '0.0.1',
+    private: true,
+  };
+  if (config.description) {
+    pkg.description = config.description;
+  }
+  pkg.scripts = {
+    test: 'echo "Error: no test specified" && exit 1',
+  };
+  fs.writeFileSync(
+    path.join(dest, 'package.json'),
+    JSON.stringify(pkg, null, 2) + '\n',
+    'utf8'
+  );
+}
+
 module.exports = { generate };

package/lib/upgrade-generator.js

@@ -467,6 +467,33 @@ function generateUpgrade(config) {
 
   step('Adapted files for project type and stack');
 
+  // --- g2) Create package.json if missing (projects created with v0.8.0 bug) ---
+  const pkgJsonPath = path.join(dest, 'package.json');
+  if (!fs.existsSync(pkgJsonPath)) {
+    const pkg = {
+      name: config.projectName,
+      version: '0.0.1',
+      private: true,
+      scripts: {
+        test: 'echo "Error: no test specified" && exit 1',
+      },
+    };
+    fs.writeFileSync(pkgJsonPath, JSON.stringify(pkg, null, 2) + '\n', 'utf8');
+    step('Created missing package.json');
+    replaced++;
+  }
+
+  // --- g3) Create .gitignore if missing (projects created with v0.8.0 bug) ---
+  const gitignorePath = path.join(dest, '.gitignore');
+  if (!fs.existsSync(gitignorePath)) {
+    const gitignoreSrc = path.join(templateDir, 'gitignore');
+    if (fs.existsSync(gitignoreSrc)) {
+      fs.copyFileSync(gitignoreSrc, gitignorePath);
+    }
+    step('Created missing .gitignore');
+    replaced++;
+  }
+
   // --- g) Write version marker ---
   const newVersion = getPackageVersion();
   fs.writeFileSync(path.join(dest, '.sdd-version'), newVersion + '\n', 'utf8');

package/package.json

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

package/template/.claude/agents/qa-engineer.md

@@ -39,7 +39,11 @@ Verify the implementation's robustness and strict adherence to `docs/specs/`.
 - **Backend**: Write tests for error paths, validation boundaries, concurrent access
 - **Frontend**: Write tests for error states, loading interruptions, accessibility
 
-### 5. Report
+### 5. Bug Documentation
+- If bugs are found: record each one in `docs/project_notes/bugs.md` with root cause, solution, and prevention notes
+- This ensures institutional memory — future sessions can avoid the same issues
+
+### 6. Report
 - If tests fail (regressions or new bugs): report them clearly with reproduction steps
 - If ALL tests pass: certify as "QA Verified"
 

package/template/.claude/settings.local.json

@@ -0,0 +1,55 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(npm test:*)",
+      "Bash(npm run lint:*)",
+      "Bash(npm run build:*)",
+      "Bash(git status:*)",
+      "Bash(git diff:*)",
+      "Bash(git log:*)",
+      "Bash(git branch:*)",
+      "Bash(git checkout -b:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(git push:*)",
+      "Bash(npx prisma:*)",
+      "Read",
+      "Glob",
+      "Grep"
+    ],
+    "deny": []
+  },
+  "hooks": {
+    "Notification": [
+      {
+        "matcher": "permission_prompt",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "osascript -e 'display notification \"Permission needed\" with title \"Claude Code\" with subtitle \"Waiting for approval\"'"
+          }
+        ]
+      },
+      {
+        "matcher": "idle_prompt",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "osascript -e 'display notification \"Task finished, waiting for input\" with title \"Claude Code\"'"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "osascript -e 'display notification \"Response complete\" with title \"Claude Code\"'"
+          }
+        ]
+      }
+    ]
+  }
+}

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

@@ -87,7 +87,7 @@ See `references/branching-strategy.md` for details.
 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 product tracker → Active Session: feature, step `1/6 (Setup)`, branch, complexity
+5. Update product tracker → Active Session: feature, step `1/6 (Setup)`, branch, complexity. Update Features table: status `in-progress`, step `1/6`
 
 **→ CHECKPOINT: Ticket Approval** (Std/Cplx only — Simple skips to Step 3)
 
@@ -98,7 +98,7 @@ See `references/branching-strategy.md` for details.
 1. Use Task tool with planner agent (`backend-planner` for backend features, `frontend-planner` for frontend features)
 2. **Fullstack features:** Run `backend-planner` first, then `frontend-planner`. Each writes its own section in the Implementation Plan
 3. Agent writes Implementation Plan into ticket's `## Implementation Plan`
-4. Update tracker: step `2/6 (Plan)`
+4. Update tracker: step `2/6 (Plan)` (Active Session + Features table)
 
 **→ CHECKPOINT: Plan Approval**
 
@@ -122,7 +122,7 @@ See `references/branching-strategy.md` for details.
 
 **Commits:** Commit freely during implementation (one per logical unit is fine). Final history cleanup happens via squash merge in Step 5.
 
-Update tracker: step `3/6 (Implement)`, context summary.
+Update tracker: step `3/6 (Implement)`, context summary (Active Session + Features table).
 
 ---
 
@@ -137,7 +137,7 @@ Update tracker: step `3/6 (Implement)`, context summary.
 
 **Commit format:** `<type>(<scope>): <description>` + `Co-Authored-By: Claude <noreply@anthropic.com>`
 
-Update tracker: step `4/6 (Finalize)`
+Update tracker: step `4/6 (Finalize)` (Active Session + Features table)
 
 ---
 
@@ -148,11 +148,12 @@ Update tracker: step `4/6 (Finalize)`
 1. Push branch, create PR (use `references/pr-template.md`)
 2. **Std/Cplx:** Run `code-review-specialist` via Task tool — **do NOT skip**
 3. **Std/Cplx:** Also run `qa-engineer` via Task tool
-4. **Merge strategy:** Features/bugfixes → **squash merge** (clean single commit on target branch); Releases/hotfixes → merge commit
+4. **Fix loop:** If review or QA finds issues → fix them → commit fixes → re-run quality gates (`npm test` / lint / build). Repeat until clean.
+5. **Merge strategy:** Features/bugfixes → **squash merge** (clean single commit on target branch); Releases/hotfixes → merge commit
 
 **→ CHECKPOINT: Merge Approval**
 
-Update tracker: step `5/6 (Review)`
+Update tracker: step `5/6 (Review)`, update Features table status
 
 ---
 
@@ -160,9 +161,8 @@ Update tracker: step `5/6 (Review)`
 
 1. **Update ticket with final state:** correct test count in acceptance criteria, mark all checkboxes, update Completion Log with all commits and key events
 2. Delete feature branch (local + remote)
-3. Update product tracker: feature → done, add to Completion Log, update progress
-4. Record bugs in `bugs.md`, decisions in `decisions.md`
-5. Clear Active Session → "No active work"
+3. Update product tracker: Features table status → `done`, add to Completion Log, clear Active Session → "No active work"
+4. Record any bugs found during the feature in `bugs.md`, decisions in `decisions.md`
 
 ---
 
@@ -195,6 +195,6 @@ Update tracker: step `5/6 (Review)`
 - **Type safety** — fully typed, no `any`
 - **English only** — all technical artifacts
 - **Memory first** — check `project_notes/` before changes
-- **Product tracker** — keep Active Session updated at every step
+- **Product tracker** — keep Active Session AND Features table 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/.gemini/agents/qa-engineer.md

@@ -15,7 +15,8 @@ You assume the happy path works (checked by Developer). Hunt for edge cases, sec
 2. Identify missing test cases and spec deviations
 3. Run full test suite for regressions
 4. Create new edge-case tests (e.g., `*.edge-cases.test.ts`)
-5. Report findings (QA Verified or Issues Found)
+5. If bugs are found: record each one in `docs/project_notes/bugs.md` with root cause, solution, and prevention notes
+6. Report findings (QA Verified or Issues Found)
 
 ## Rules
 

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

@@ -87,7 +87,7 @@ See `references/branching-strategy.md` for details.
 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 product tracker → Active Session: feature, step `1/6 (Setup)`, branch, complexity
+5. Update product tracker → Active Session: feature, step `1/6 (Setup)`, branch, complexity. Update Features table: status `in-progress`, step `1/6`
 
 **→ CHECKPOINT: Ticket Approval** (Std/Cplx only — Simple skips to Step 3)
 
@@ -98,7 +98,7 @@ See `references/branching-strategy.md` for details.
 1. Follow the planner agent instructions (`backend-planner` for backend features, `frontend-planner` for frontend features) in `.gemini/agents/`
 2. **Fullstack features:** Run `backend-planner` first, then `frontend-planner`. Each writes its own section in the Implementation Plan
 3. Write Implementation Plan into ticket's `## Implementation Plan`
-4. Update tracker: step `2/6 (Plan)`
+4. Update tracker: step `2/6 (Plan)` (Active Session + Features table)
 
 **→ CHECKPOINT: Plan Approval**
 
@@ -122,7 +122,7 @@ See `references/branching-strategy.md` for details.
 
 **Commits:** Commit freely during implementation (one per logical unit is fine). Final history cleanup happens via squash merge in Step 5.
 
-Update tracker: step `3/6 (Implement)`, context summary.
+Update tracker: step `3/6 (Implement)`, context summary (Active Session + Features table).
 
 ---
 
@@ -137,7 +137,7 @@ Update tracker: step `3/6 (Implement)`, context summary.
 
 **Commit format:** `<type>(<scope>): <description>`
 
-Update tracker: step `4/6 (Finalize)`
+Update tracker: step `4/6 (Finalize)` (Active Session + Features table)
 
 ---
 
@@ -148,11 +148,12 @@ Update tracker: step `4/6 (Finalize)`
 1. Push branch, create PR (use `references/pr-template.md`)
 2. **Std/Cplx:** Follow `code-review-specialist` instructions in `.gemini/agents/` — **do NOT skip**
 3. **Std/Cplx:** Also follow `qa-engineer` instructions in `.gemini/agents/`
-4. **Merge strategy:** Features/bugfixes → **squash merge** (clean single commit on target branch); Releases/hotfixes → merge commit
+4. **Fix loop:** If review or QA finds issues → fix them → commit fixes → re-run quality gates (`npm test` / lint / build). Repeat until clean.
+5. **Merge strategy:** Features/bugfixes → **squash merge** (clean single commit on target branch); Releases/hotfixes → merge commit
 
 **→ CHECKPOINT: Merge Approval**
 
-Update tracker: step `5/6 (Review)`
+Update tracker: step `5/6 (Review)`, update Features table status
 
 ---
 
@@ -160,9 +161,8 @@ Update tracker: step `5/6 (Review)`
 
 1. **Update ticket with final state:** correct test count in acceptance criteria, mark all checkboxes, update Completion Log with all commits and key events
 2. Delete feature branch (local + remote)
-3. Update product tracker: feature → done, add to Completion Log, update progress
-4. Record bugs in `bugs.md`, decisions in `decisions.md`
-5. Clear Active Session → "No active work"
+3. Update product tracker: Features table status → `done`, add to Completion Log, clear Active Session → "No active work"
+4. Record any bugs found during the feature in `bugs.md`, decisions in `decisions.md`
 
 ---
 
@@ -197,6 +197,6 @@ Agent instructions are in `.gemini/agents/`. Read the relevant agent file when e
 - **Type safety** — fully typed, no `any`
 - **English only** — all technical artifacts
 - **Memory first** — check `project_notes/` before changes
-- **Product tracker** — keep Active Session updated at every step
+- **Product tracker** — keep Active Session AND Features table 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/gitignore

@@ -0,0 +1,48 @@
+# Dependencies
+node_modules/
+
+# Build output
+dist/
+.next/
+out/
+build/
+
+# Environment — NEVER commit
+.env
+.env.local
+.env.*.local
+.env.development
+.env.staging
+.env.production
+.npmrc
+
+# OS
+.DS_Store
+Thumbs.db
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Testing
+coverage/
+
+# Prisma
+backend/generated/
+
+# Logs
+*.log
+npm-debug.log*
+
+# Cache
+.turbo/
+.cache/
+
+# Secrets and keys
+*.pem
+*.key
+
+# Claude Code (local settings are personal — hooks, permissions, notifications)
+.claude/settings.local.json