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.
- package/README.md +28 -6
- 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
|
-
###
|
|
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
|
|
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
|
|
409
|
-
│ ├── commands/ # Slash
|
|
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
|
|