Handbook
Blueprint policy — do not change casually
This directory **`blueprints/product/`** is the **frozen** product-functional documentation package: information architecture and templates meant to be **reused and compared** across projects.
Blueprint policy — do not change casually
This directory blueprints/product/ is the frozen product-functional documentation package: information architecture and templates meant to be reused and compared across projects.
Rules
- Do not edit files here as part of normal product work (feature specs under
docs/product/, WBS updates, etc.). - Change only when explicitly requested — e.g. adopting a new blueprint version, fixing an upstream template bug, or a deliberate policy decision to revise the baseline.
- Day-to-day product documentation belongs in
docs/product/(this repo’s mutable tree) and elsewhere underdocs/as needed. - If you change
STRUCTURE.mdor related blueprint files, ensure the generated handbook is refreshed: runpython3 generator/build-handbook.py productfromblueprints/or rely on CI (output underblueprints/website/). Seeblueprints/product/docs/MAINTENANCE.md.
Relationship to docs/product/
blueprints/product/— canonical, generic text (immutable by convention).docs/product/— where this project writes vision, journeys, and feature behavior without touching the blueprint.
Copying this repo: you may copy blueprints/product/ wholesale to another repository; use docs/product/ (or equivalent) only in repos that track project-specific functional documentation.
Canonical source
Edit https://github.com/autowww/blueprints/blob/main/product/POLICY.md first; regenerate with docs/build-handbook.py.