Section 5
Decomposition and Work Units
On this page
- 5.1 Deliverable-anchored decomposition
- 5.2 Purpose-defined Components
- 5.3 System level before Component detail
- 5.4 Integrated modularity first
- 5.5 Sizing
- 5.6 Work Units bounded by Blast Radius
- 5.7 Work Units must be verifiable
- 5.8 Nested levels of intent
- 5.9 Work Units for long-horizon work
- 5.10 Reusable task definitions
5.1 Deliverable-anchored decomposition #
Project decomposition must be organized around the deliverables the Project produces, not around the Executors doing the work or around organizational structure. Every decomposition element must carry a short definition stating what the element is and what it delivers. The identity of an element must not depend on which Executor performs the work. Work that yields no deliverable (management, integration, etc.) must appear as explicit elements. [GP-07; COD]
5.2 Purpose-defined Components #
The System must be decomposed into Components defined by the purpose they serve, not by physical form, packaging, or implementation technology, etc. Each Component must carry its own Obligations and design criteria, one named human owner, and a Verification Procedure that yields a binary pass/fail status readable by anyone. Obligations, ownership, and pass/fail status of any Component must be retrievable on demand. [GP-08; COD]
5.3 System level before Component detail #
System-level interactions and cross-boundary Contracts must be defined before Component internals. Each Component must be designed against declared System behavior and the interfaces it declares with other Components. Where local and System-level optimization conflict, the System-level optimum governs. The local cost accepted for that System gain must be recorded as a Decision Record (§11). A change that crosses a boundary must be agreed at System level before it is made inside a Component. [GP-09; COD]
5.4 Integrated modularity first #
The default structure is one coherent System with strong internal Component boundaries. Hard separation (independent ownership, strong operational or physical isolation, independent fabrication, independent evolution, etc.) is introduced only when a concrete need exists (significantly different rates or constraints of evolution, required failure isolation, regulatory or safety boundaries, physical constraints, etc.) and its benefits clearly outweigh the added coordination and interface costs. Premature hard separation is a defect. [IMF]
5.5 Sizing #
Significant work that is assigned to an Executor must be decomposed into Work Units that one Executor can complete in one bounded effort while meeting the Work Unit’s Acceptance Criteria. An oversized Work Unit must be split before execution begins. AI Agents may propose the decomposition and the sizing. The human owner remains the final authority on any sizing decision that could affect higher-level Contracts, Invariants, or the definition of done. Work Units that stay strictly inside already-accepted higher-level Contracts and Acceptance Criteria may be sized by AI Agents. [GP-10]
5.6 Work Units bounded by Blast Radius #
Before a Work Unit starts, its Blast Radius must be estimated and bounded. Parallel Work Units must have non-overlapping Blast Radii. A change whose Blast Radius cannot be bounded must be decomposed further before execution. [GP-12]
5.7 Work Units must be verifiable #
Significant work assigned to an Executor must be packaged as a Work Unit: a bounded scope with checkable Acceptance Criteria. Work Units belong to one of two classes:
- Production Work Units: modify the canonical Realization or System description. Each unit must execute in isolation, governed by a pre-existing Specification and a human-approved Plan Document (§6.13). A Production Work Unit is complete only when its Verification Procedures pass.
- Exploratory Work Units: investigate feasibility, test empirical models, optimize parameters, or discover candidate Specifications. Governed by explicit research questions, resource ceilings (time, token, compute budgets, etc.), and stopping criteria. An Executor operating under a human-approved exploratory mandate may spawn and iterate internal exploratory loops autonomously within declared resource boundaries.
Large efforts must be decomposed into bounded Work Units before execution begins. [GP-11; VFE]
5.8 Nested levels of intent #
Decomposition must form nested levels of intent: each level states why the work below it exists and is governed by Acceptance Criteria at its own level. Purpose belongs to the outermost level (the Vision Document, §3.3). No inner level may redefine the Acceptance Criteria of a level above it. [GP-13]
5.9 Work Units for long-horizon work #
Long-horizon work must be decomposed into Work Units, each small enough for one Executor to complete and verify in one bounded effort. Each Work Unit must carry its own Acceptance Criteria and the Verification Procedures that confirm them. The Verification Procedures must run at the end of every Work Unit. Failures must be repaired before the next Work Unit starts. The governing Specification is frozen against drift; a change to it requires a Decision Record (§11). [GP-14; VFE]
5.10 Reusable task definitions #
Recurring kinds of work must be defined once as reusable task-definition documents. In AI coding environments these are commonly called skills. In complex engineering and simulation environments they are more often called procedures or templates. Each document must contain:
- an imperative sequence of steps
- the Acceptance Criteria that must be satisfied when the work is done
- the actions the Executor must not take
- any required inputs (and their expected source)
Each document must also carry a short summary of when it applies, so an Executor can select the applicable task definition. Each task-definition document is a Governance Document (§4.9). The name and terminology used may follow the conventions of the tools and domain in use; the binding to concrete storage is declared in the Path Map (§14.8). [GP-77]