Handbook
Templates
Copy into `docs/` (or your doc root) and customize. **Not** part of the process itself—shortcuts for new projects.
Templates
Copy into docs/ (or your doc root) and customize. Not part of the process itself—shortcuts for new projects.
Project sdlc/ workspace
Canonical files for a mutable sdlc/ folder at repo root (see Initializing the project `sdlc/` workspace and ../scripts/README.md).
| Path | Use |
|---|---|
| SDLC — {{PROJECT_NAME}} | Render to sdlc/README.md with {{PROJECT_NAME}} replaced (script does this). |
| Tracking foundation (single spine) | Copy into sdlc/ — engineering tracking foundation. |
| Methodologies (lenses on the tracking foundation) | Copy into sdlc/ — methodology lenses. |
| Tracking challenges (separate from the foundation) | Copy into sdlc/ — limits and caveats. |
Docs (docs/)
| File | Use |
|---|---|
| Roadmap — {project name} | Optional milestone/epic table; pair with a WBS or backlog elsewhere. |
| Test plan — [scope] | Optional scope-level test plan (levels, environments, traceability, exit criteria). |
Forge SDLC workspace
Seed files for a mutable forge/ workspace and ember-logs/ at repo root. See Setup & adoption for adoption guide.
| Path | Use |
|---|---|
| Forge workspace | Forge workspace README with directory structure and script references. |
| forge/forge.config.template.yaml | Project Forge configuration (team, Versonas, Assay Gate, paths). |
| Charge (template) | Daily Charge seed file. |
| Ember Log Entry (template) | Ember Log daily file seed. |
| Journal Entry (template) | Day journal seed. |
| Assay Gate (template) | Assay Gate evidence checklist. |
| forge/cursor-rules/ | Ready-to-use Cursor rules: forge-daily.mdc, forge-planning.mdc, forge-setup.mdc, forge-versona.mdc, forge-product-manager.mdc. |
| forge/cursor-skills/ | Optional Cursor Skills to copy into .cursor/skills/ (e.g. run-product-versona-challenge). |
| — | Align forge.config.yaml with .cursor/rules/: ../methodologies/forge/setup/check-forge-cursor-alignment.sh |
Spec-driven (SDD) — ceremony & process I/O
| Path | Use |
|---|---|
| SDD templates (Spec-driven development) | Blank specs for inputs/outputs/preconditions (agents, product, engineering). |
| CEREMONY INTENT (template) | Map C1–C6 or team rituals to SDD tables. |
| PROCESS SLOT (template) | Gates, release slices, toolchain steps. |
Normative schema and worked examples: Spec-driven development — SDD I/O package · handbook HTML: generated under blueprints/website/ by generator/build-handbook.py (e.g. sdlc--methodologies-spec-driven-sdd-io-schema.html).
Canonical source
Edit https://github.com/autowww/blueprints/blob/main/sdlc/templates/README.md first; regenerate with docs/build-handbook.py.