Specification

Specification

The precise, readable specification of the methodology — the structures and protocols that humans and agents share.

Standard

Documentation standard

Normative standard for how Deep Work Plans document their structure, tasks, and progress: README rules, status markers, the ten-section task anatomy, and the Final Review.

Workflow

DWP specification

Normative Deep Work Plan specification: plan structure, the ten-section task anatomy, gate selection by touched surface, the five-operation execution loop, the output workspace, and versioning.
Lite plans

Lite plans: compact, fully executable task records inline in README.md, their creation and format selection, and promotion to a Full plan.

Protocol

Agent protocol

Normative behavioral contract for AI coding agents: onboarding, planning, execution, safety, and execution profiles — interactive versus unattended operation.

Archetypes

Archetypes

Normative description of DWP repository archetypes: the individual repository, orchestrator hub, and agent workspace, and how onboarding differs for each.

Addons

Add-ons

DWP addons: four opt-in extensions (devcontainer, Dailybot, dependency-upgrade, design-system), the required AI Diff Reviewer local review with its optional CI surface, addon contract, and kit concepts.

Conformance

Conformance

The normative definition of a DWP-conformant, AI-first repository: the artifacts it MUST and SHOULD have, what makes a plan well-formed, and how to verify it.

State

Plan state

The machine-readable plan state layer: manifest.json and state.json, gate records, outcome records as episodic memory, reconciliation, and when it is required.