Handbook
SDLC — {{PROJECT_NAME}}
**Copy note:** Links below assume this file lives at **`sdlc/README.md`** (repo root). They are wrong if you open the template from `blueprints/sdlc/templates/sdlc/` — run `init-sdlc-workspace.sh` or
Template
Template — Copy this file into your project and fill in the sections. Do not edit the blueprint original.
SDLC — {{PROJECT_NAME}}
Copy note: Links below assume this file lives at sdlc/README.md (repo root). They are wrong if you open the template from blueprints/sdlc/templates/sdlc/ — run init-sdlc-workspace.sh or adjust paths mentally.
This folder is mutable. Use it for anything project-specific about how we apply the SDLC: pointers, notes, decisions, or links—not for editing the frozen blueprint.
Engineering tracking (git-centric identity, work units, ceremonies) is documented as three Markdown files here — a foundation, a methodologies chapter (Scrum, Kanban, phased, XP), and challenges kept separate. They are not part of the frozen blueprints/sdlc/ text. The SDLC handbook has a dedicated Methodologies & tracking chapter (hierarchy + lenses) and links from the handbook home. If you use docs/INDEX.md, add an Engineering tracking subsection (e.g. #engineering-tracking). Bootstrap the same file set from SDLc-WORKSPACE.md.
| What | Where |
|---|---|
| Frozen SDLC baseline (do not change unless policy says so) | blueprints/sdlc/README · POLICY.md |
| Frozen product-functional IA (if adopted) | blueprints/product/README · STRUCTURE.md |
| Human handbook (SDLC, HTML) | docs/index.html · MAINTENANCE.md |
| Human handbook (product functional, HTML) (if adopted) | docs/index.html |
| Process text | SDLC.md · DOCUMENTATION-STRUCTURE.md |
| Optional templates (SDLC) | templates/ |
| Product functional templates (if adopted) | templates/ |
| Living product functional docs | docs/product/ |
| Project profile & stack | docs/PROJECT.md |
| Requirements, WBS, milestones, risks | docs/requirements/ |
| Roadmap (this repo) | docs/ROADMAP.md |
| Documentation index | docs/INDEX.md |
| Engineering tracking | Tracking foundation (single spine) · Methodologies (lenses on the tracking foundation) · Tracking challenges (separate from the foundation) |
| CI/CD & quality gates | docs/development/CI-CD.md |
| Test plans | docs/testing/README.md |
Add files here (e.g. NOTES.md, CHECKLIST.md) when you need project-only SDLC guidance without modifying the blueprint.
This folder is the working surface; blueprints/sdlc/ is the canonical reusable SDLC template; blueprints/product/ (if used) is the canonical product-functional IA; docs/product/ holds project prose.
Canonical source
Edit https://github.com/autowww/blueprints/blob/main/sdlc/templates/sdlc/README.template.md first; regenerate with docs/build-handbook.py.