Brief First Execution
Start non-trivial work with one live task brief.
Goal
Reduce drift by creating a compact source of truth for:
- scope;
- non-goals;
- affected areas;
- risks;
- verification;
- done criteria.
When To Use
Use for:
- multi-file implementation;
- behavior changes;
- migrations, audits, or refactors;
- long runs where context could drift;
- work with real operational or delivery risk.
Skip for:
- tiny one-file edits with obvious blast radius;
- trivial questions that do not create lasting change.
Workflow
- Name the task
- write a short title that matches the real delivery target.
- Define scope
- describe what is in;
- keep it concrete and delivery-shaped.
- Define non-goals
- state what this task will not do;
- use this to stop opportunistic scope creep.
- List affected areas
- identify modules, docs, data flows, or systems likely to change.
- List risks
- focus on failure modes that matter for this task.
- Define verification early
- list the narrowest useful checks first;
- add broader checks only where the blast radius warrants them.
- Define done criteria
- describe what must be true before closing the task.
- Keep the brief live
- update the brief when scope changes materially;
- do not leave the brief frozen while the work mutates underneath it.
Rules
- One task, one brief.
- Scope and non-goals should both be explicit.
- Verification belongs in the brief before heavy implementation starts.
- If the task changes enough, revise the brief rather than pretending it did not.
Final Report
Return the brief itself and call out any unresolved scope or verification questions.