Skip to content

Design records

The design trail behind DocGen — the specs, plans, and audits produced while building it (via the brainstorming → writing-plans workflow). These are project records, not product documentation: they capture why a feature was built the way it was, frozen at the time of writing. For how the shipped system works today, see the four modes.

Folder What
specs/ Design specs — the validated design for a feature, written before implementation.
plans/ Implementation plans — bite-sized, task-by-task build plans derived from a spec.
audits/ Point-in-time audits — completeness / quality reviews of a solution or feature.

These predate the docs reorg and are kept verbatim as historical records. Where a spec references a shipped mechanism, the current explanation lives under explanation/ or reference/.