Docs that render clean

Copied into a project, driven by the skills in skills/docs and skills/debugging. Never edited in place.

The templates

ADR.mdArchitecture decision record
POSTMORTEM.mdBlameless incident report
PRD.mdProduct requirements document

One shared format

— Header as a table.
— One --- divider between every section.
— Emoji H2 headers, matching the README house style.
— [bracketed] placeholders with an italic guidance line under each heading.
— An HTML comment at the top with the fill-in rules — invisible when rendered.

Where they live in a project

docs/
├── prd/NNNN-slug.md
├── adr/NNNN-slug.md          # numbered, immutable once accepted
└── incidents/YYYY-MM-DD-slug.md   # blameless — systems, never people