create-sdd-project 0.9.8 → 0.9.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +28 -6
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -294,19 +294,27 @@ SDD DevFlow combines three proven practices:
294
294
  | `qa-engineer` | Edge cases, spec verification | 5 |
295
295
  | `database-architect` | Schema design, optimization | Any |
296
296
 
297
- ### 3 Skills (Slash Commands)
297
+ ### 4 Skills (Slash Commands)
298
298
 
299
299
  | Skill | Trigger | What it does |
300
300
  |-------|---------|-------------|
301
301
  | `development-workflow` | `start task F001`, `next task`, `add feature` | Orchestrates the complete 7-step workflow |
302
302
  | `bug-workflow` | `report bug`, `fix bug`, `hotfix needed` | Bug triage, investigation, and resolution |
303
303
  | `project-memory` | `set up project memory`, `log a bug fix` | Maintains institutional knowledge |
304
+ | `health-check` | `health check`, `project health` | Quick scan: tests, build, specs sync, secrets, docs freshness |
305
+
306
+ ### 2 Custom Commands
307
+
308
+ | Command | What it does |
309
+ |---------|-------------|
310
+ | `/review-plan` | Sends Implementation Plan to external AI models (Codex CLI, Gemini CLI) for independent critique |
311
+ | `/context-prompt` | Generates a context recovery prompt after `/compact` with Workflow Recovery to prevent checkpoint skipping |
304
312
 
305
313
  ### Plan Quality
306
314
 
307
315
  Every Standard/Complex feature plan goes through a **built-in self-review** (Step 2.4) where the agent re-reads its own plan and checks for errors, vague steps, wrong assumptions, and over-engineering before requesting approval.
308
316
 
309
- For additional confidence, the optional `/review-plan` command sends the plan to an external AI model (Codex CLI, Gemini CLI, or Claude Code) for independent critique — catching blind spots that same-model review misses.
317
+ For additional confidence, the optional `/review-plan` command sends the plan to external AI models (Codex CLI and/or Gemini CLI in parallel) for independent critique — catching blind spots that same-model review misses.
310
318
 
311
319
  ### Workflow (Steps 0–6)
312
320
 
@@ -336,6 +344,16 @@ For additional confidence, the optional `/review-plan` command sends the plan to
336
344
 
337
345
  Quality gates (tests, lint, build, validators) **always run** regardless of level.
338
346
 
347
+ ### Merge Checklist (B+D Mechanism)
348
+
349
+ Every ticket includes a `## Merge Checklist Evidence` table that the agent must fill before requesting merge approval. This mechanism:
350
+
351
+ - **Survives context compaction** — the ticket is always re-read via product tracker, so the empty evidence table acts as a persistent reminder
352
+ - **Forces sequential execution** — agent must read `references/merge-checklist.md`, execute 9 actions (0–8), and record evidence
353
+ - **Works at all tiers** — Simple tasks get a lite ticket with the same evidence table
354
+
355
+ Validated across 16+ features with 87% first-attempt pass rate (failures led to iterative improvements in v0.8.7–v0.9.8).
356
+
339
357
  ### Project Memory
340
358
 
341
359
  Tracks institutional knowledge across sessions in `docs/project_notes/`:
@@ -399,14 +417,18 @@ project/
399
417
  │ │ ├── development-workflow/ # Main task workflow (Steps 0-6)
400
418
  │ │ │ └── references/ # Templates, guides, examples
401
419
  │ │ ├── bug-workflow/ # Bug triage and resolution
420
+ │ │ ├── health-check/ # Project health diagnostics
402
421
  │ │ └── project-memory/ # Memory system setup
422
+ │ ├── commands/ # Custom slash commands
423
+ │ │ ├── review-plan.md # Cross-model plan review
424
+ │ │ └── context-prompt.md # Post-compact context recovery
403
425
  │ ├── hooks/quick-scan.sh # Post-developer quality scan
404
426
  │ └── settings.json # Shared hooks (git-tracked)
405
427
 
406
428
  ├── .gemini/
407
429
  │ ├── agents/ # 9 agents (Gemini format)
408
- │ ├── skills/ # Same 3 skills
409
- │ ├── commands/ # Slash command shortcuts
430
+ │ ├── skills/ # Same 4 skills
431
+ │ ├── commands/ # Slash commands (workflow + review + context)
410
432
  │ └── settings.json # Gemini configuration
411
433
 
412
434
  ├── ai-specs/specs/
@@ -462,11 +484,11 @@ cp -r node_modules/create-sdd-project/template/ /path/to/your-project/
462
484
 
463
485
  ## Roadmap
464
486
 
487
+ - **PM Agent + L5 Autonomous**: AI-driven feature orchestration — sequential feature loop with automatic checkpoint approval and session state persistence
488
+ - **`/review-project` command**: Comprehensive project review using multiple AI models in parallel (Claude + Gemini + Codex) with consolidated action plan
465
489
  - **Monorepo improvements**: Better support for pnpm workspaces and Turbo
466
- - **SDD Upgrade/Migration**: Version bumps for projects already using SDD
467
490
  - **Retrofit Testing**: Automated test generation for existing projects with low coverage
468
491
  - **Agent Teams**: Parallel execution of independent tasks
469
- - **PM Agent + L5 Autonomous**: AI-driven feature orchestration with human review at milestone boundaries
470
492
 
471
493
  ## Contributing
472
494
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "create-sdd-project",
3
- "version": "0.9.8",
3
+ "version": "0.9.9",
4
4
  "description": "Create a new SDD DevFlow project with AI-assisted development workflow",
5
5
  "bin": {
6
6
  "create-sdd-project": "bin/cli.js"