The VCDesign core

Decisions

A human closes each Δ with one of six words. No other vocabulary is used. Every decision passes one judgment gate.

Norms: core.yaml decision and closure_loop; policies.yaml judgment_gate, enforcement, temporal_governance. Record format: schema_log.yaml.

1. A human closes the decision

2. The six words

The six words are the canonical Decision. VCDesign maps each to a handling of the declaration and a next state (implementation.md §3).

DecisionMeaningDeclarationNext state
ProceedContinue with the current structure and declarationKept as is, including corrections that do not change the chapteractive
ExpandWiden target, scale or connections based on an observed Positive ΔWiden blast_radius (before / after). Requires an observed Positive Δ and confirmed recovery capabilityactive
LimitThere is value but the spread is too wide; narrow target, authority, scale or periodNarrow blast_radius (before / after)active
ReframeRedefine value, target, boundary or premisesDefine a new chapter: premises, boundary, owner and declarationreframed
DeferHold with responsibility until the material for judgment is readySet a temporary owner and the next review timedeferred
RetireEnd it because it does not lead to the next valueRelease responsibility and hand over what remains to a new holder. Includes deciding not to startretired

A confirmed Δ stays under responsibility until a decision closes it. Defer is a closure path with an owner and a review time, not an escape.

3. The judgment gate

Every decision is closed by a human through this single gate. Its checks follow the canonical Review Output (Upside / Downside / Continuity / Asymmetry / Decision) in the order of the five principles. Long-term and short-term decisions differ only in the depth of the check; there is no separate gate.

PrincipleWhat is checked
Keepvalue_intent is declared; residual_assets are declared with holders
Findspread_signals.expected is declared; a Positive Δ is recorded separately from the average outcome
Closeblast_radius is declared; failure_domain is declared if shared; upstream conclusions are revalidated
Tryreversibility is declared; the halt path is confirmed
Pass onthe decision basis is recorded; the re-derivation basis is recorded for long-lived cases

4. What each decision requires

DecisionRequires (judgment_gate.per_decision)
ProceedNothing beyond the gate's checks
ExpandAn observed Positive Δ (spread_signals observed or unexpected) / recovery capability confirmed for the widened scope / blast_radius before and after
Limitblast_radius narrowed, before and after
ReframeThe existing chapter is not sustainable / new premises and boundary / a new owner / supervisor approval if structural
DeferA reason / a temporary owner / the next review time (default ceiling 7 days, after which the supervisor forces closure)
RetireNo hidden dependency / responsibility released / related chapters notified / what remains handed over

5. Expand and Limit update the declaration

Expand and Limit are decisions that update the blast_radius declaration without changing the chapter, recorded as before and after. Expand widens the declaration; Limit narrows it.

An Expand record from a fictional parts factory (excerpt from point-vs-line-improvement.md; values translated):

decision:
  value: expand
  positive_delta_refs: [reuse_cost_decline, unsolicited_pull]
  declaration_update:
    before:
      scope: data collection on lines 1–3 only (never writes to control systems)
      max_loss: {unit: hours_data_gap, value: 8}
    after:
      scope: data collection on lines 1–4 and read-only feed to quality control (never writes to control systems)
      max_loss: {unit: hours_data_gap, value: 8}
      approved_by: {role: plant_manager}
  decided_by: {role: plant_manager}

6. Positive Δ and Expand

"Propagable" does not mean "spread automatically".

7. Hard stops

The judgment gate stops the propagation of a Negative Δ and an Expand decision that lacks its preconditions (judgment_gate.hard_stops). It never stops observing or holding a Positive Δ.

Blocking applies only to a Negative Δ and to the decision Expand. Findings about observing or holding a Positive Δ are at most a warning (policies.yaml enforcement).

8. Recording decisions

9. Anti-patterns