Skip to main content

Spec-driven development

All Aucert engineering work follows a spec-driven workflow. The formality scales with task size.

Task sizes

SizeTimePlanning approach
Small< 1hPlan in conversation (Plan mode), then execute
Medium1-4hWrite .tasks/backlog/ file → agent generates spec in .tasks/drafts/
LargeMulti-dayDetailed backlog file → comprehensive spec → both founders review

Task file locations

DirectoryPurpose
.tasks/backlog/Raw intent files awaiting spec generation
.tasks/drafts/Generated specs awaiting review
.tasks/active/Approved specs ready for execution
.tasks/archive/Completed tasks

Context loading

Task files specify which context to load:

context_load:
l1: [ARCHITECTURE.md, CONVENTIONS.md]
l2: [backend/.context/BACKEND.md]
l3: [backend/.../domain/generation/spec/GENERATION.md]

What's next