Glossary

Every term of the method in one sentence, grouped by kind.

Every term of the method, one sentence each, grouped by kind. For terms that also appear in the working paper’s glossary, the working paper remains canonical; this file adds the terms introduced after it (standards and domain files, intent weights, the readiness gate, the slicing vocabulary, findings) and is the complete current register.

Written artifacts

Full treatments: the artifact layers, the constitution, the working loop, and the practitioner guide for complete examples of each artifact.

TermMeaning
ConstitutionThe one-page law of a project: numbered clauses, each of which would justify stopping work if violated. Read by every agent, every session.
ClauseOne rule of law (C-01, C-02, …), carrying the version it entered at.
AmendmentThe only way the constitution changes: a diff with written rationale (change, reason, rejected alternatives, what becomes invalid) and a semantic version bump.
Constitution stampThe line on every piece of work recording which constitution version it was built under.
Decision record (ADR)The reasoning behind a clause or a choice; read on demand, not by default.
Standards fileTechnical conventions for one area (naming, error handling, testing), one screen each; loaded only when a slice declares them. Convention, not law.
Domain fileCross-feature business facts (domain rules, fixed lists, how the customer operates), human-written, loaded per declaration.
Collaboration corpusWritten norms about working together, learned at retrospectives: wording that works, slicing rules, calibration values.
IdeaA backlog entry; free to capture, carries no obligations, and is not yet an intent.
Feature intentThe human-owned statement of purpose: why, success in user terms, scope, and known requirements. Has a weight class.
Weight classLight (purpose, success, scope, knowns) or full (adds scenario, decisions, sketch); full applies to new user-facing surfaces, expected constitution contact, or larger features.
Known requirementsThe intent’s fact list under the provenance rule.
Provenance ruleFacts the human actually holds may be written at any length; nothing may be invented to make a document look complete.
Primary scenarioFull-weight intents only: an owner-written walkthrough of a named user doing the real thing; writing it forces the behavior decisions.
Behavior decisionA choice about how the feature behaves, explicitly made by the owner in the intent.
Deferred decisionA choice the owner has explicitly left open, bound to the demo that will answer it.
SketchAn owner-drawn mockup for a new surface; binding for structure, not for pixels.
Slice listThe feature’s decomposition into slices, with ordering rationale and risk flags.
Slice specThe one-screen specification of one slice: summary, acceptance criteria, Standards and Domain lines, a “not specified on purpose” list, and the stamp.
Acceptance criterionA single checkable statement, tagged [test] (must become an executable test) or [prose] with a justification (checked at a demo).
Deviation reportWritten when work stops mid-build: what the spec assumed, what is actually the case, two or three options with consequences, and the recorded decision.
Deviation logOne line per implementation-detail deviation; raw material for the retrospective.
Atomic PRThe single reviewable unit: code, tests, and any spec change together, with the stamp and the deviation log.
VerdictThe recorded outcome of a demo: validated, misaligned, or intent evolved, with who drove and what artifacts resulted.
FindingOne recorded contradiction between a spec and the system, with detection and resolution dates; classified descriptive, normative, or constitutional.
ArchiveSealed specs of validated slices; read-only, and stale by design.
Derived documentA description of current behavior regenerated from code on demand; never maintained by hand.

Structural concepts

Full treatments: the working loop, slicing the work, and the artifact layers.

TermMeaning
The loopThe working shape: intent, slice, specify, build, verify, validate, learn, with three backward paths.
Backward edgeAny defined channel through which learning flows against the direction of production and changes the plan.
Durable layerThe small, law-like document layer (constitution, ADRs, invariants); maintained deliberately, read every session.
Ephemeral layerPer-slice working documents (intents, specs, criteria); archived after validation, not maintained.
Derived layerDocuments regenerated from the source of truth at read time; cannot go stale.
Layered truthThe precedence rules: code and tests decide what the system does; the constitution decides what it should do; a contradiction between the two is a discovered defect.
SliceThe unit of work, defined by the user question it answers; called increment in the papers, and the two words mean the same thing.
Walking skeletonThe mandatory first slice: the thinnest end-to-end cut, ugly but real, demoed before further slices.
SpikeA timeboxed investigation of an open question whose deliverable is a written answer; it never ships code and never has acceptance criteria.
Sizing ruleThe binary size test: one human can review the change in one sitting, and one agent can build it in one session.
Split catalogThe preferred seams for splitting an oversized slice: scenario, data variation, scope, operation, rule depth, fidelity; never layer or activity.
Detail budgetSpecifications state what must stay true, not what happens to be true, because descriptive prose goes stale.
Readiness gateThe adversarial check before slicing: a full-weight intent whose owner cannot walk the scenario goes back at the cost of a conversation.

Protocols and events

Full treatments: deviation and drift, the validation architecture, and Learning that lasts.

TermMeaning
Deviation protocolThe rules for a mid-build discovery that the spec is wrong: classify observably, stop or log, never diverge silently.
Observable classificationThe sorting question: what must change? Tests, interfaces, or the constitution moving means behavioral; internals only means implementation detail.
AndonThe stop-the-line event for behavioral deviations, named after the Toyota practice.
ConsortiumWhoever the authority matrix designates to decide a stopped deviation, within the latency budget.
Latency budgetThe agreed maximum time for an andon decision, with a named default if it passes.
DriftDivergence between specifications and the system, discovered after the fact; treated like bugs, not like shame.
Drift pipelineThe four stages of handling drift: prevent, detect, triage, learn.
Conformance sweepThe check that reads specs against code and reports contradictions; a retro ritual first, a standing agent later.
Graduation triggerThe evidence threshold for moving from ritual to standing agent: the ritual keeps finding real drift.
Drift half-lifeThe health number: the time from a gap appearing to the gap being fixed.
Skeleton demoThe human-driven demo of the walking skeleton, before further slices are built.
Feature demoThe guaranteed human-driven walkthrough before a feature seals.
Risk-pulled demoAn on-demand demo of a slice that touched the constitution, stopped the line, or sits in a drift-prone area.
Brains-eyes-hands ruleA demo watched as a recording or read as a summary does not count; the human operates the software directly.
RetrospectiveThe learning event after a validated feature, with three routed outputs: system learnings, collaboration learnings, drift findings.
Comprehension auditThe retro check that each human’s validation authority is backed by recent hands-on contact.
GardeningThe scheduled pruning of the durable layer: consolidate, delete, promote, demote, with no lost enforcement.
Promotion / demotionMoving a repeatedly violated fact into the constitution, or moving over-specified prose out of it.
Impact censusAfter a major amendment: querying the stamps for all work built under older versions and dispositioning each.
Honest rollbackReverting an amendment with the stamped list of work built on it in view, so the cost is enumerable.

Authority concepts

Full treatments: the authority matrix and Keeping humans in charge of what matters.

TermMeaning
Core invariantHumans always own the why; automation only ever moves who owns the check.
Authority matrixThe per-layer assignment of checking work between humans and agents, recorded in the constitution.
Fixed rowFeature intent and validation, which never transfer to agents in any configuration.
Graduated autonomyAuthority moves toward agents on a recorded track record and returns on incident, like a licensing system.
MandateThe written, human-held, revocable grant under which a lead-architect agent may decide amendments.
Human samplingThe share of agent-reviewed work that humans still review; never zero, serving as tripwire and comprehension spend.
Correlated verification failureThe hazard of agents checking agents of the same model family: shared blind spots approve the same error every time.
ScribeThe agent role at demos that turns spoken feedback into spec-diff proposals for the human to approve in session.
Goodhart anchorThe rule that self-improving agent processes are judged only against human demo verdicts, never against internal numbers alone.
RulebookThe numbered rules R1 to R36, defined across the deep-dive papers.