Skip to content

Concentrated OAP

Human Work Preloading, Human Judgment Postloading, and Deferred Human Adjudication


Four repositories, one weekend, one hard deadline

During 22–23 August 2026, SLAIF ran a concentrated agentic-development field exercise across four public software repositories: SLAIF Agent Site, SLAIF Local Coding, SLAIF API Gateway, and SLAIF Zap-It. A temporary free-access window for the Ox Alpha coding model created a hard target: move all four systems towards MVP before Monday.

In roughly 48 hours, the repositories accumulated 390 main-branch commits and 75 merged pull requests, with more than 77,000 added lines. By Monday morning, activity had reached 464 commits and 91 merged pull requests. OpenRouter telemetry records 13,528 Ox Alpha requests and 2.69 billion total tokens during 22–23 August. Including preparation and preloading activity on 21 August, the field exercise used 17,812 requests and 3.07 billion total tokens.

The decisive result was not the volume of generated code. Providers failed, processes exited, sessions fragmented, machines changed, and models were replaced. Work nevertheless continued because repository state, work orders, reports, and orchestration artifacts survived the individual agent processes.

The exercise also exposed the limit of autonomy: implementation could move faster than anyone could responsibly prove completeness. Human intervention remained essential for rejecting over-engineering, correcting false diagnoses, defining consequential judgment gates, preventing orchestration from requiring constant babysitting, and demanding an independent sceptical review.

Concentrated OAP—Human Work Preloading, Human Judgment Postloading, Deferred Human Adjudication, logical role persistence, and Independent Closure Audit—was refined in direct response to these observations. It was not yet part of the June workshops because it emerged from this later field exercise; it will be incorporated into forthcoming OAP workshops as advanced material grounded in practical evidence. This chapter is an advanced operating mode of Orchestrated Agentic Programming and assumes the governance model established in Chapter 1.

Abstract

Ordinary Orchestrated Agentic Programming (OAP) is a human-governed, constitution-driven method in which a strategic AI acts as the control plane, a high-autonomy coding agent performs implementation work in a bounded environment, and the human preserves authority over product intent, risk, acceptance, and release. It already moves the human away from low-level typing and terminal work. It does not, however, necessarily remove the human from recurring decision, review, merge, and escalation points during execution.

This document proposes a more concentrated variant of OAP for environments in which reaching a credible minimum viable product (MVP) or demonstration quickly is important, while production deployment remains a later and more demanding decision. The extension introduces two temporal mechanisms:

  1. Human Work Preloading (HWP): the human concentrates architectural reasoning, constraints, acceptance criteria, work decomposition, risk policy, and governance before the autonomous loop begins.
  2. Human Judgment Postloading (HJP): consequential decisions that cannot be settled confidently from the preload are made provisionally by the strategic agent, recorded transparently, and deferred for explicit human adjudication after the MVP is reached but before the relevant deployment boundary is crossed.

The formal human review mechanism is called Deferred Human Adjudication (DHA). Its central artifact is CRITICAL.md: an append-only-in-spirit register of consequential autonomous decisions, unresolved assumptions, possible vulnerabilities, security relaxations, trust-model choices, data-integrity dilemmas, and other judgment debt.

The result is Concentrated OAP: a workflow in which the human works intensely before the loop, agents execute and supervise development with high autonomy, and the human returns at defined adjudication and deployment gates. The strategic agent is not allowed to stop merely because a difficult but reversible engineering decision would be more comfortable to delegate to a human. It must decide, document, mitigate, and continue. At the same time, it is not allowed to cross non-delegable production, legal, destructive, or external-exposure boundaries without human authorization.

The core doctrine is:

Preload what can be decided in advance. Decide provisionally what remains. Preserve the uncertainty. Adjudicate before deployment.


1. Source relationship and scope

This document deliberately distinguishes two layers:

  • Ordinary OAP baseline: derived from the published OAP Manual, especially its role separation, strategic discovery, project constitution, PR-sized delegation, bounded execution, evidence-based review, remote-repository truth, human accountability, and release gates.
  • Concentrated OAP extension: the HWP/HJP/DHA model developed from operational experience with persistent strategic agents, disposable coding agents, automatic strategic review and merge, and a repository-level critical review queue.

The extension does not claim that ordinary OAP is weak or naïve. Ordinary OAP already removes the human from much implementation labor and encourages strategic compression rather than command-by-command supervision. The difference is primarily where human judgment is placed in time and which development decisions are delegated to the strategic agent.

flowchart LR
    O[Ordinary OAP principles] --> E[Concentrated OAP extension]
    H[Operational experience] --> E
    E --> HWP[Human Work Preloading]
    E --> LOOP[More autonomous strategic/coding loop]
    E --> HJP[Human Judgment Postloading]
    HJP --> DHA[Deferred Human Adjudication]
    DHA --> CRIT[CRITICAL.md]

This is a proposed operational profile, not a replacement for every use of OAP. Ordinary OAP remains the safer default when requirements are unstable, the human must approve every change, or the execution environment directly touches production-critical systems.

The Field note boxes added to this edition are drawn from August 2026 SLAIF runs in which concentrated two-agent workflows operated through model failures, work-order corrections, hostile completeness audits, GPU qualification, and deferred security decisions. They are examples of observed workflow behavior, not universal performance claims. Quotations have been lightly edited where necessary for readability.

1.1 Evidence basis and limitations

Concentrated OAP was refined through an observational field exercise conducted during 22–24 August 2026. Its evidence base includes the public GitHub histories of four SLAIF software repositories, versioned OAP work orders and execution reports, CI results, OpenRouter request and token telemetry, and contemporaneous human–AI transcripts documenting strategic decisions, operational failures, corrections, and recovery.

The exercise was not a controlled benchmark. Repository activity and token volume demonstrate the scale and intensity of agentic execution, but they do not independently prove software quality or milestone completeness. Commits include implementation, tests, documentation, reports, corrective work, merge commits, generated material, and dependency updates. Prompt-token totals also include substantial cached context.

For that reason, the methodology treats activity metrics as evidence of implementation capacity—not evidence of completion. Product claims must instead be established through current code, boundary-faithful tests, CI, documentation, and an Independent Closure Audit.

1.2 Doctrine and the reusable bootstrap reference profile

There are two methodological layers above, and a third, implementation-specific layer in this chapter:

  • Ordinary OAP principles establish human governance, role separation, bounded execution, repository truth, evidence, and release responsibility.
  • Concentrated OAP doctrine adds the timing and authority rules of HWP/HJP/DHA, D0/D1/D2, delegated development merge, judgment debt, logical continuity, provenance, and ICA.
  • The reusable bootstrap reference profile provides one concrete way to install that doctrine after project planning: separate workspaces, role-specific instruction sets, full and compact governance documents, a local orchestration protocol, and a validated but inactive handoff.

The profile is specified by Concentrated OAP — Reusable Bootstrap-Package Generator Prompt, Version 1.0. Its filenames, context budgets, POSIX FIFOs, round grammar, and report-publication convention apply within this reference profile; they are not universal OAP requirements. Other tools, transports, layouts, and vendors remain possible when they preserve the governing roles, evidence, and authority boundaries. Ordinary OAP can also use such engineering techniques.

The additions describe a reusable design, not a new field result or a claim that every client has been qualified. They do not retrospectively attribute this profile to the June workshops or August exercise. Start with the adoption walkthrough; precise contracts and validation responsibilities are in Appendices D–F.


2. Ordinary OAP: the baseline

2.1 Working model

The OAP Manual defines OAP as a human-governed, constitution-driven subtype of agentic software engineering. Its characteristic role separation is:

  • the human lead owns problem definition, product purpose, domain truth, risk appetite, priorities, acceptance criteria, release decisions, and accountability;
  • the strategic AI acts as control plane, architecture and planning layer, memory layer, work-order author, critic, evidence synthesizer, and first reviewer;
  • the execution agent performs repository and machine work, usually in a hardened and rebuildable environment;
  • the remote repository, pull requests, CI, tests, documentation, and review trail preserve durable project truth.
flowchart TD
    H[Human lead<br/>intent, risk, acceptance, release] --> S[Strategic AI<br/>architecture, work orders, review]
    S --> C[Coding agent<br/>implementation and tests]
    C --> R[Branch, PR, CI, report]
    R --> S
    S --> B[Decision brief and recommendation]
    B --> H
    H -->|accept, repair, reject, defer| S

Ordinary OAP is not ordinary AI pair programming. The human does not need to remain beside the coding agent. The human interacts mainly through the strategic layer and asks managerial questions about goal match, proof, safety, scope, and readiness.

2.2 Ordinary OAP lifecycle

A typical ordinary OAP lifecycle is:

  1. human and strategic AI perform discovery;
  2. the project constitution and architecture are written;
  3. the strategic AI prepares a bounded work order;
  4. the execution agent implements it and returns evidence;
  5. the strategic AI reviews the result;
  6. the human judges the strategic review and authorizes merge, repair, rejection, or release as appropriate;
  7. the cycle repeats.
sequenceDiagram
    participant H as Human lead
    participant S as Strategic AI
    participant C as Coding agent
    participant G as GitHub and CI

    H->>S: Domain intent, constraints, risk posture
    S->>H: Architecture and alternatives
    H->>S: Accept or redirect
    S->>C: PR-sized work order
    C->>G: Branch, commits, PR, tests
    G-->>S: Diff, CI, report, evidence
    S->>H: Decision brief and recommendation
    H->>S: Merge, repair, reject, or defer
    S->>C: Next or corrective work order

2.3 Ordinary OAP human gates

The manual preserves human approval for consequential actions such as:

  • production deployment;
  • merge to protected branches;
  • destructive data operations;
  • credential rotation;
  • public release claims;
  • adding risky dependencies;
  • widening network access;
  • changing security posture.

It also states that the strategic model is the default first reviewer, not the final accountable reviewer. A model can miss risk, overpraise a result, or rationalize a weakness. Ordinary OAP therefore keeps the human available at recurring management and release gates.

2.4 Why ordinary OAP is already powerful

Ordinary OAP already provides several essential foundations that Concentrated OAP retains unchanged:

  • strategic discovery before coding;
  • machine-readable project law in a constitution;
  • narrow, reviewable, PR-sized work units;
  • durable repository and CI truth;
  • explicit evidence and negative-path testing;
  • bounded high-autonomy execution;
  • documentation and handoffs as operational memory;
  • honest distinction between implemented scope and claimed readiness;
  • human accountability for the resulting system.

Concentrated OAP does not weaken these foundations. It attempts to reduce the frequency of routine human interruption while making unresolved judgment more visible and enforceable.


3. The operational limitation: strategic reluctance to decide

In long autonomous runs, a strategic agent may encounter a dilemma that it understands technically but does not want to resolve without a human. Typical examples include:

  • whether a security boundary may be relaxed for an MVP;
  • whether an authorization model is sufficiently conservative;
  • whether deletion should be hard, soft, or represented as a tombstone;
  • whether a scanner warning is an acceptable false positive;
  • whether a provisional authentication mechanism is acceptable in a confined demo;
  • whether a design should favor speed, reversibility, provenance, or simplicity;
  • whether a technically legitimate architecture change exceeds the intended risk budget.

The failure mode is not always ignorance. It is often decision aversion:

“Both choices are plausible and consequential. A human should decide.”

Field note — The model knew, but did not want to own the choice.

The extension began with a repeated human observation from live strategic-agent runs: the agent could enumerate the alternatives, consequences, and mitigations for security boundaries or security-model relaxations, yet still stopped because it preferred a human to own the consequential choice immediately. Paraphrased, the human's complaint was: “The problem is not that it does not know how to decide. It does not want to decide.”

That distinction matters. Missing knowledge requires investigation. Decision aversion inside an already delegated, reversible design space requires a forced provisional choice plus an honest future human gate.

That response is reasonable in a generic assistant. In a deliberately preloaded autonomous delivery loop, however, it can halt the entire project for a decision that is reversible, locally containable, and within the delegated design space.

flowchart TD
    A[Strategic agent encounters dilemma] --> K{Does it understand the alternatives?}
    K -->|No| R[Research, inspect evidence, run tests]
    R --> K
    K -->|Yes| W{Does it want human ownership now?}
    W -->|Yes| STOP[Stop loop and request human decision]
    W -->|No| D[Choose and continue]

    style STOP fill:#f9d0d0,stroke:#a33

Repeated stops create several costs:

  • serial latency while the human is unavailable;
  • loss of strategic context while waiting;
  • fragmented attention for the human;
  • pressure to answer quickly without reviewing the full evidence;
  • a return to human-in-the-loop scheduling;
  • reduced value from an otherwise autonomous two-agent architecture.

Concentrated OAP addresses this by changing the default rule:

A difficult but reversible development decision is not, by itself, permission to stop.


4. Human Work Preloading (HWP)

4.1 Definition

Human Work Preloading (HWP) is the deliberate concentration of human engineering judgment before autonomous execution, encoded into durable project artifacts so that the strategic and coding agents can operate for long periods without routine human intervention.

The word work is important. The human is not merely supplying background context. The human has already performed substantial engineering labor:

  • defining the product;
  • resolving major architectural alternatives;
  • deciding trust boundaries;
  • deciding what “done” means;
  • setting the risk budget;
  • sequencing the work;
  • specifying what must not be improvised;
  • defining the distinction between demo, MVP, pilot, and production readiness.

4.2 HWP as compilation of judgment

HWP turns diffuse human understanding into executable project governance.

flowchart LR
    subgraph Human_reasoning[Human reasoning]
        P[Product intent]
        D[Domain truth]
        R[Risk appetite]
        A[Architecture choices]
        N[Non-goals]
        G[Acceptance and release criteria]
    end

    subgraph Preload[HWP compilation]
        AR[ARCHITECTURE.md]
        CO[Project constitution]
        RM[Roadmap]
        WO[Initial work orders]
        DP[Decision policy]
        CT[CRITICAL.md schema]
    end

    P --> AR
    D --> AR
    R --> CO
    A --> AR
    N --> RM
    G --> WO
    R --> DP
    DP --> CT

The resulting artifacts act as a durable “preloaded management state” for the strategic agent.

4.3 Minimum HWP artifact set

A serious HWP package should normally include:

Artifact Purpose
ARCHITECTURE.md Human-readable product shape, boundaries, components, data flows, deployment model, and rationale.
AGENTS.md or equivalent Entry point for coding law; may be a minimal router to a role-specific constitution.
Strategic-agent constitution Role, authority, review duties, merge policy, and decision rules.
Security and testing documents Non-negotiable security invariants and evidence requirements.
Roadmap Ordered objectives and milestone definitions.
Initial work orders Concrete first execution slices with acceptance criteria.
Non-goals Explicitly postponed work and forbidden scope expansion.
Readiness definitions Separate criteria for demo, MVP, pilot, and production.
Decision classification D0, D1, and D2 rules described later in this document.
CRITICAL.md template Durable format for deferred human judgment.
Runtime constraints Hosts, GPUs, ports, credentials, protected services, and test boundaries.
Recovery protocol Rules for agent crash, context loss, stale branches, and partial work.

These are product HWP documents. The bootstrap-input package adds materialization contracts and package checks; the installed setup adds helpers, role contexts, and validation evidence. They serve different purposes: see the two inventories in Appendix D.

4.4 HWP is not prompt engineering

Prompt engineering optimizes an interaction. HWP establishes a project operating system.

flowchart TB
    PE[Prompt engineering] --> P1[Better single interaction]
    HWP[Human Work Preloading] --> P2[Durable architecture]
    HWP --> P3[Persistent governance]
    HWP --> P4[Sequenced work]
    HWP --> P5[Acceptance and risk policy]
    HWP --> P6[Recovery and adjudication rules]

A prompt can disappear with a session. HWP artifacts are versioned, reviewable, diffable, and reusable across agents and model contexts.

A reusable generator prompt can compile already completed planning into durable HWP artifacts and bootstrap specifications. It does not replace that planning or authorize product execution.

4.5 HWP is not immutable design

Preloading does not mean the initial architecture is perfect. It means that changes become explicit engineering events.

The strategic agent may refine the design when evidence demands it, but it must not silently redefine:

  • product purpose;
  • domain truth;
  • ethical or legal boundaries;
  • explicit non-goals;
  • non-delegable security constraints;
  • production authorization.

A change inside the delegated design space may be D0 or D1. A change that would redefine human intent or cross a non-delegable boundary is D2.

Field note — Preloaded intent met an 11 GB GPU.

The ZAP-IT preload described development on physical GPU1 and carried an early assumption that the card had roughly 22–24 GB of VRAM. Live qualification found an ordinary 11 GB RTX 2080 Ti. The strategic process did not discard the product goal and did not pretend the preload was factually correct. It preserved the intent—use GPU1, protect GPU0, produce a real service—then measured the model stack, kept SAM2 and CLIP resident, and refused to load BLIP3 beyond the safety budget.

HWP preloads direction and judgment. It does not make reality subordinate to the draft.

4.6 From a settled plan to a self-contained bootstrap package

The handoff begins in the conversation where the human and planning model have already settled product intent, scope, constraints, architecture, and acceptance criteria. The planning model produces a project-specific bootstrap-input ZIP. A separate tool-using agent, launched in the extracted temporary directory, turns those inputs into actual coding and strategic workspaces.

Stage Actor and result Authority does not include
Package design Planning model produces source documents, contracts, work-program specifications, and acceptance requirements in an input archive. Operating the target machine, publishing its repository, or beginning product implementation.
Bootstrap materialization Bootstrap agent creates the workspaces, installs governance, implements and tests orchestration helpers, expands inactive drafts, and writes a receipt. Product work, operational activation, release, deployment, or protected service changes.
Governed development Strategic and coding roles produce bounded work, PRs, evidence, reviews, and authorized development merges. Human adjudication, unsupported milestone certification, or an unapproved D2 action.
Closure, adjudication, and release Independent reviewer and accountable human assess architecture coverage, DHA, remediation, and the separately authorized target transition. Treating green checks or an exhausted queue as human approval.

The planning model writes instructions to generate and validate the harness, not necessarily the final executable harness. The ZIP must still specify concrete helper behavior and positive and negative tests: the bootstrap agent is not asked to invent the operating protocol. Conversely, materialization must produce actual files and executable helper implementations, rather than another plan or another archive.

The successful handoff is deliberately limited:

Governance and orchestration installed and validated; product work and operational activation not started.

An existing project receives a non-destructive migration or controlled refresh. Its running work, active pointer, register, reports, and history are preserved. Conflicting or running state requires a scoped transition before replacement, not a new-project reset. Section 5.8 separates this handoff from activation.

4.7 Source fidelity and traceable work decomposition

Finalized files are inputs, not rewriting opportunities. Preserve the exact bytes of a finalized plan as PLAN.md and of an approved architecture as ARCHITECTURE.md. Renaming does not permit reformatting, translation, line-ending changes, summarization, or silent correction. Record checksums against the actual supplied files. If no finalized file exists, synthesize a complete standalone document from the settled conversation and identify it honestly as a new artifact; distinguish human decisions from proposed elaborations and do not claim prior approval or byte preservation.

SOURCE-MAP.md separates five kinds of information: explicit human decisions, source-supported facts, proposed implementation defaults, unverified runtime assumptions, and unresolved authority questions. A suggestion in chat is not automatically a requirement. Unknown host names, remote URLs, credentials, model choices, and measurements remain unknown. Cite conflicting source clauses and block their dependent actions while continuing safe independent preparation. Routine reversible defaults may be recorded; conflicts about product meaning, destructive action, or non-delegable authority cannot be resolved by silently editing the source. Authorized D0/D1 evolution remains possible later under §4.5.

The full architecture must describe the product: workflows, components, boundaries, data and control flows, failure behavior, operations, security, and milestone evidence. Launch scripts alone are not HWP. Assign stable references to important requirements; if source bytes are protected, use an external requirement index rather than inserting identifiers into the source.

Decompose those requirements into a project-appropriate number of coherent, proof-sized objectives, without a fixed count or promised duration. Each substantive draft needs a concrete goal, dependencies, architecture and provenance references, scope, non-goals, numbered acceptance criteria, meaningful verification including negative paths, documentation impact, protected resources, and a reporting contract. Tests and documentation belong in each relevant slice. Expand seeds into standalone drafts, not title-swapped boilerplate.

Future orders remain DRAFT UNTIL STRATEGIC RECONCILIATION. Strategy checks the current repository, evidence, dependencies, and authority before activation. Do not fabricate future SHAs, PRs, host measurements, or test results to complete a draft. Changed evidence may revise the queue, but accepted requirements remain obligations until satisfied, properly deferred, or explicitly recorded as unresolved. The source requirements, not the generated queue, also define ICA scope.

Include necessary permitted methodology and project-source snapshots so the bootstrap does not depend on the planning conversation or an inaccessible URL. Exclude private conversations, credentials, personal/customer data, and material without permission. Label sanitized derivatives and missing snapshots honestly. Checksums establish byte identity, not truth, semantic equivalence, or human approval.


5. Concentrated OAP: the autonomous development loop

5.1 Definition

Concentrated OAP is an HWP-enabled OAP profile in which:

  • the human performs a concentrated preload;
  • a logically persistent strategic role carries project continuity;
  • a disposable or restartable coding agent performs one bounded work order at a time;
  • GitHub, CI, reports, and project documents are authoritative;
  • the strategic agent may issue corrective work orders and merge development PRs when policy permits;
  • consequential uncertainty is recorded instead of hidden;
  • the human returns at explicit adjudication and deployment gates.
---
config:
  flowchart:
    useMaxWidth: false
---
flowchart TD
    H[Human HWP phase] --> S[Logically persistent strategic role]
    S --> W[Publish bounded work order]
    W --> C[Disposable coding agent]
    C --> P[PR, tests, CI, report]
    P --> S
    S --> Q{Satisfied and CI green?}
    Q -->|No| FIX[Issue corrective lettered order]
    FIX --> C
    Q -->|Yes| J{Critical provisional judgment?}
    J -->|No| M[Strategic merge]
    J -->|Yes| CR[Record or update CRITICAL.md]
    CR --> M
    M --> NX{"Recommend milestone closure?"}
    NX -->|No| W
    NX -->|Yes| ICA["Independent Closure Audit"]
    ICA -->|Gaps| W
    ICA -->|Evidence supports closure| DHA["Applicable DHA and human milestone gate"]

5.2 Logically persistent strategy, disposable execution

The architecture intensifies an asymmetry already present in OAP:

“Persistent” describes continuity of authority and project understanding, not immortality of one process. The strategic role may be re-instantiated with a different model or provider as long as it reconstructs the same protocol state from durable artifacts before acting.

  • strategic context should be long-lived because it contains product continuity, architecture, roadmap, review history, and unresolved risk;
  • coding context should be task-local because implementation details become stale and consume context;
  • durable truth should live in GitHub and repository artifacts, not in either model’s hidden memory.
flowchart LR
    S[Strategic context<br/>long-lived] --> WO[Work order]
    WO --> C1[Coding context 1]
    C1 --> G[GitHub truth]
    G --> S
    S --> C2[Coding context 2]
    C2 --> G
    S --> C3[Coding context 3]
    C3 --> G

Field note — Changing the brain did not change the project.

During the weekend field run, OpenCode providers failed, coding sessions died after coordination signals had been consumed, models were replaced, strategic sessions became non-resumable, and fresh processes were started in new terminals. The recovery law remained: “GitHub is software truth; OAP files are orchestration truth; process/session memory is disposable.” A fresh strategic process was forbidden to replay merged objectives or recreate their PRs merely because its predecessor disappeared.

Operational lesson: strategic persistence is logical persistence of role, authority, and transcript—not continuous consciousness in one model session.

The reference protocol in Appendix D.5 makes this continuity law concrete for lost signals, partial publication, and process replacement.

5.3 Automatic strategic merge is development authority, not release authority

A major difference from ordinary OAP is that the strategic agent may be authorized to merge PRs after independent review when all required conditions hold.

This does not mean the strategic agent owns production release. It means that the meaning of a merged development PR is:

“This is the best evidence-backed provisional engineering state currently accepted for continued development.”

It does not necessarily mean:

“A human has accepted every security, legal, operational, and trust-model decision for production.”

The distinction is enforced through the dual-gate model described later.

5.4 Conditions for autonomous strategic merge

The strategic agent may merge only when all applicable conditions hold:

  1. the PR implements the active work order;
  2. the diff is bounded and coherent;
  3. required CI and tests are green;
  4. test evidence is meaningful, not merely syntactic;
  5. documentation matches behavior;
  6. no secret or prohibited artifact has been introduced;
  7. no D2 boundary has been crossed;
  8. every D1 decision has a complete CRITICAL.md entry;
  9. rollback or reversibility is adequate for the development stage;
  10. the strategic agent can explain the strongest reason not to merge and why it is nevertheless acceptable for continued development.

In the reference profile, review is tied to the exact current PR head and independently verified remote state; a changed head requires renewed review. Appendix D.4 defines the implementation/report identities and publication chronology.

5.5 Work-order provenance and the anti-busywork rule

A long autonomous loop must be able to explain why every new objective exists. Concentrated OAP therefore requires each strategic work order to trace to one or more durable origins:

H  explicit human instruction or preload
A  architecture, constitution, contract, or roadmap
E  observed failing evidence
I  independent audit finding
C  CRITICAL/DHA remediation
flowchart LR
    H[Human intent] --> O[Work order]
    A[Architecture] --> O
    E[Observed evidence] --> O
    I[Independent audit] --> O
    C[Critical remediation] --> O
    O --> PR[Bounded PR]

A strategic agent should not create work merely because a neighboring improvement seems attractive. Conversely, non-functional work with explicit human or audit provenance—such as restoring unique objective numbering, correcting false readiness claims, or preserving an auditable transcript—must not be dismissed as agent bureaucracy.

Field note — “Are they closing the architecture, or inventing work?”

The human repeatedly asked whether the Agent-Site closure sequence was increasing actual completeness or merely producing activity. The answer became defensible only by mapping each objective back to missing architecture: runtime wiring, capability authority, COW writes, Puck, media, rendering, Playwright, review, promotion, and defining E2E proofs. One apparent example of “bureaucracy”—renumbering the sequence—was later correctly reclassified when the human clarified that it had been explicitly requested to keep the OAP trail unambiguous.

Operational rule: no autonomous order without provenance; no criticism of process work without first checking its provenance.

5.6 Role-specific instruction and context architecture

The reference profile uses three resolved roots, all distinct and non-nested. Operator-selected destinations take precedence over these illustrative conventions:

BOOTSTRAP_ROOT = actual extracted temporary directory
REPO_ROOT      = $HOME/codex-work/<project-slug>
STRATEGIC_HOME = $HOME/codex-supervision/<project-slug>

Separation protects files and instruction inheritance: bootstrap law in an ancestor directory must not become operational law. There are four instruction functions, with an additional versioned strategic source copy:

Location Instruction function
BOOTSTRAP_ROOT/AGENTS.md Bootstrap-only constitution: materialize, validate, record, stop.
REPO_ROOT/AGENTS.md Tiny router selecting the assigned role's governing documents.
REPO_ROOT/oap/coding-instructions/AGENTS.md Deliberately dense coding constitution, scoped to execution.
STRATEGIC_HOME/AGENTS.md Full operational strategic constitution.
REPO_ROOT/oap/strategic-instructions/AGENTS.md Versioned source of that strategic-home copy, refreshed deliberately.
---
config:
  flowchart:
    useMaxWidth: false
---
flowchart TB
    B["Temporary bootstrap root"] -->|Materializes| R["Repository root router"]
    B -->|Installs| S["Strategic home: full constitution"]
    V["Versioned strategic source"] -->|Controlled copy| S
    R -->|Coding role| C["Dense coding law and compact architecture"]
    R -->|Strategic role retains| S
    A["Canonical full architecture"] -->|Derivation| C

Derivation arrows describe document preparation, not authority transfer. The bootstrap agent does not automatically become an operational role. An independent auditor is a scoped reviewer, not a third permanent execution lane.

A root-router illustration, for a materialized project, is:

Use the role assigned by the trusted launcher or explicit human instruction.
CODING -> read oap/coding-instructions/AGENTS.md and its compact read set.
STRATEGIC -> retain STRATEGIC_HOME/AGENTS.md; repository inspection is not a role change.
UNKNOWN/CONFLICT -> no operational mutation until role is reconciled.
BOOTSTRAP/AUDIT -> inspecting this repository grants no operational authority.
Reading another role's instructions does not grant that role's authority.

The role marker, expected launch directory, and small model-visible startup prompt must agree; an environment variable alone may not be visible to the model. Check the directory at launch, while allowing legitimate later inspection. A cd, filename, shared credential, or ability to edit a file does not change logical authority. Routing is context discipline, not authentication, an OS sandbox, or a permission boundary.

Never copy bootstrap law into an operational constitution. Archive it under a non-discoverable name such as BOOTSTRAP-GENERATOR.md, and guard other historical instruction snapshots against accidental discovery. The strategic home references canonical plan, architecture, and CRITICAL files rather than keeping independently editable full copies.

5.7 Governance distillation, loading, and drift control

The coding constitution is an executor projection, not a generic summary. It preserves executor-relevant authority, scope, obligation strength, conditions, exceptions, ordering, failure behavior, verification, and escalation. Defined compact notation and stable clause IDs can remove repetition, history, examples, and strategic deliberation; they cannot remove a prohibition or exception to meet a size target.

The full strategic constitution retains architecture stewardship, delegated evolution, provenance-linked work selection, D0/D1/D2 reasoning, forced provisional decisions, DHA authorship, skeptical review, merge policy, aggregate risk, readiness, continuity, and ICA. It is neither the coding file with a different label nor an instruction to load whole source books repeatedly. Role allocation does not prescribe a model, vendor, or context-window size.

Keep one current canonical REPO_ROOT/ARCHITECTURE.md. Its ARCHITECTURE-for-agents.md projection carries source revision/hash and requirement/invariant references. Coding normally reads the projection; strategy and ICA use the full source. The projection must be operationally sufficient for its declared scope and cannot override that source. A real gap requires bounded strategic clarification, projection correction, or an explicitly authorized relevant source-section read—not invented law or automatic loading of the complete source.

Context Routine or initial read set Not automatically loaded
Bootstrap Bootstrap constitution, instructions, supplied full plan/architecture, source relationships, specifications, relevant methodology. Unrelated private history or runtime secrets.
Coding startup/recovery Minimal router, dense coding law, compact architecture and communication, exact active order, applicable security/testing/subtree contracts, ordered excerpts. Full plan/architecture, strategic law, source OAP chapters, whole roadmap, future drafts, distillation audit, historical CRITICAL register.
Strategic startup/new incarnation Full strategic law, communication/init, canonical full plan/architecture, roadmap, decision/readiness/runtime policy, current CRITICAL, active state, current repository evidence. Complete source books and historical content on every turn without need.
Independent audit Human milestone scope, full architecture, exact merged revision, relevant source/runtime/tests, independently examined evidence. Automatic adoption of strategic conclusions or coding/merge authority.

Strategy refreshes relevant material after changes, compaction, uncertainty, and before gates. Concise state summaries do not replace the authoritative detail for a related decision. The selective CRITICAL rule in §8.9 remains unchanged.

Measure the transitive read set, including automatic discovery, mandatory references, applicable security/testing rules, inherited instructions, and duplicate injection. A tiny router that indirectly demands ten long files saves no context. Inspect the installed client's actual discovery and inheritance behavior: a Markdown link need not cause a read, while a nested AGENTS.md may load during subtree inspection. Guard cross-role sources explicitly; do not overwrite unrelated global or ancestor instructions to make a routing test pass.

Appendix E supplies illustrative, separately measured byte/token budgets and a source-to-clause map. Mechanical checks can establish identity, declared coverage, sizes, and syntax; deliberate semantic review must still assess whether the projection preserves law.

Integrity has four domains: immutable package sources; current canonical governance and projections; installed strategic copies; and evolving orchestration/CRITICAL state. Compare governance-changing PRs against the accepted base and authorized candidate scope. After acceptance, refresh affected strategic copies at a quiescent checkpoint, preserving private configuration, drafts, handoffs, and history. Editing an expected hash is not authorization, and a legitimate live-register append must not be rejected for differing from its original seed.

5.8 Materialization, setup, and operational activation

Materialization follows the contracts in Appendix D and produces the evidence in Appendix F. In this profile a shared POSIX filesystem supports durable order/report files and local named-pipe notifications. Pipes are wakeups; authoritative state and exact correlation survive them. Operational idle waiting occurs outside model inference.

For a new installation, successful inactive handoff means no oap/active, no activated order, no fabricated report/review, no sent control signal, and no running operational roles. Drafts and configured pipes may exist. An empty or malformed pointer is an error, not inactivity. Existing projects instead preserve their real state and require an explicit scoped transition if it conflicts; rerunning a bootstrap is not permission to reset them.

Setup mode opens two side-by-side shells in the correct directories with separate role-specific client homes. It allows explicit configuration and login without activating an order or starting the loop. Missing credentials, model configuration, or a remote must not prevent access to these shells. Separate homes do not authorize copying authentication files, histories, cookies, or private global configuration.

Operational mode checks source/projection freshness, the accepted baseline, installed client configuration, repository/remote and CI readiness, actual runtime boundaries, process ownership, and explicit activation authority. Coding starts fresh per activated round; strategy preserves its logical continuity. Inspect client version/help/configuration behavior, retain explicit model choices, and record missing prerequisites without silent provider/model fallback. Development-agent configuration is distinct from models used inside the product.

Launchers must respect deliberate quit, prevent duplicate processes, and clean up only owned resources. Print-only/dry-run modes start no agents; no cron, daemon, or automatic resurrection is installed by default. A local YES or true acknowledgement can record a decision but cannot prove the human delegated authority.

A validated scaffold can remain blocked for activation. Package checking, helper verification, activation readiness, product qualification, and milestone/target-gate acceptance are separate evidence layers. Installation does not authorize remote repository creation, publication, product downloads/inference, network exposure, credential changes, or protected service mutation. The subsequent first work order requires strategic reconciliation and separately established human/delegated authority.


6. Human Judgment Postloading and Deferred Human Adjudication

6.1 Terminology

Human Judgment Postloading (HJP) is the temporal design principle: human judgment that cannot be usefully or economically supplied before execution is deliberately scheduled after autonomous MVP development rather than interrupting every work order.

Deferred Human Adjudication (DHA) is the formal process by which the human later accepts, rejects, modifies, or requests more evidence for each recorded provisional decision.

The relationship is:

flowchart LR
    HJP[Human Judgment Postloading<br/>temporal principle] --> DHA[Deferred Human Adjudication<br/>formal process]
    DHA --> CR[CRITICAL.md<br/>decision register]
    CR --> DEC[Human disposition]
    DEC --> HARD[Hardening work orders]

“HJP” is memorable and symmetrical with HWP. “DHA” is precise: the eventual human is adjudicating between alternatives, not merely proofreading code.

6.2 The forced-decision rule

When the strategic agent encounters a consequential dilemma within its delegated development authority, it MUST NOT stop merely because human ownership would be more comfortable.

It must:

  1. inspect governing architecture and constitution;
  2. gather available evidence;
  3. identify credible alternatives;
  4. compare risks, reversibility, blast radius, and stage suitability;
  5. choose a provisional solution;
  6. implement or order appropriate mitigation and tests;
  7. record the dilemma and decision in CRITICAL.md;
  8. continue the development loop.

The strategic agent is not allowed to erase uncertainty by writing a confident justification. It must preserve the uncertainty explicitly.

The autonomous system may resolve uncertainty provisionally, but it may not make the uncertainty disappear.

6.3 What the forced-decision rule does not mean

“Forced to decide” does not mean “forced to perform every action.”

The strategic agent can be required to choose an architecture while still being prohibited from:

  • deploying it to production;
  • destroying real production data;
  • rotating real credentials;
  • widening a real firewall or public network boundary;
  • making a legally binding or ethically non-delegable choice;
  • processing real sensitive data under an unapproved trust model;
  • overriding explicit human product intent;
  • accepting an irreversible external obligation.

This distinction produces three decision classes.


7. Decision classes: D0, D1, and D2

7.1 Classification

Class Meaning Strategic-agent behavior Human timing
D0 — Ordinary delegated decision Reversible, low-consequence engineering choice inside architecture and risk budget. Decide, test, document normally, continue. No special adjudication required.
D1 — Deferred critical judgment Consequential but containable and reversible enough for continued development. Multiple legitimate choices exist. Decide provisionally, mitigate, add tests, record in CRITICAL.md, merge if development gate passes. Human adjudicates before the declared release/deployment boundary.
D2 — Non-delegable boundary Would cross production, destructive, legal, ethical, credential, public-exposure, or explicit human-authority boundary. Analyze and recommend; may implement safely in isolation if authorized; MUST NOT cross the real boundary. Human authorization required before action.

7.2 Decision flow

flowchart TD
    X[Strategic dilemma] --> I{Enough evidence to understand choices?}
    I -->|No| E[Research, test, inspect]
    E --> I
    I -->|Yes| B{Would action cross a non-delegable boundary?}
    B -->|Yes| D2[D2: recommend and stop before boundary]
    B -->|No| C{Consequential uncertainty requiring later human acceptance?}
    C -->|No| D0[D0: decide and continue]
    C -->|Yes| D1[D1: decide provisionally]
    D1 --> M[Mitigate and test]
    M --> R[Record CRITICAL entry]
    R --> CONT[Continue development]

7.3 Default D2 boundaries

The human approval gates identified in ordinary OAP should normally map to D2:

  • production deployment;
  • merge or release operations that directly deploy to production;
  • destructive operations on production or irreplaceable data;
  • real credential rotation or disclosure;
  • public release claims with legal or contractual consequence;
  • risky dependency acceptance where licensing or supply-chain obligations are unresolved;
  • widening real network access;
  • changing the real production security posture.

An organization may add additional D2 boundaries in its preload.

Before enabling delegated development merge, inspect the actual merge-triggered automation. A merge that deploys or exposes a protected service is still D2; setup or activation flags do not grant another kind of autonomous release authority. See §5.8 and Appendix D.4.

7.4 Examples

Dilemma Likely class Reason
Choose cache library A or B D0 Routine, reversible engineering choice.
Use soft-delete or hard-delete for demo-only synthetic records D1 Data-integrity and provenance consequences, but containable.
Merge a scanner-flagged SSRF pattern behind strict local allowlists for continued development D1 Security judgment requiring later human review.
Keep a placeholder auth implementation in an isolated demo D1, with deployment block Development may continue, external deployment may not.
Expose that placeholder-auth service to the public Internet D2 Crosses a real security boundary.
Delete production customer data D2 Irreversible, destructive, externally consequential.
Redefine the product’s intended users or legal purpose D2 Changes human-owned product meaning.

8. CRITICAL.md: the Deferred Human Adjudication Register

8.1 Purpose

CRITICAL.md is not merely a vulnerability list and not merely technical debt. It is an autonomous judgment ledger.

It records situations where:

  • the strategic agent made a consequential provisional decision;
  • a possible vulnerability remains;
  • a security boundary was relaxed or interpreted;
  • a scanner warning was accepted or deferred;
  • authorization or trust semantics remain uncertain;
  • data integrity or deletion semantics are debatable;
  • an MVP shortcut would be unacceptable for production;
  • an assumption is necessary but not yet human-approved;
  • architecture and implementation are temporarily misaligned;
  • external evidence is insufficient for production confidence.

The existing slaif-agent-site/CRITICAL.md demonstrates the basic pattern: autonomously merged PRs are listed with risk, decision taken, and review priority, including explicit “before production” and “before any deployment” gates.

Field note — The register existed before the methodology had a name.

Agent-Site had already accumulated a queue of autonomously merged decisions about privilege grants, hard deletion, placeholder authentication, SSRF mitigation, capability handling, and deployment gates. It was called a “Critical Review Queue,” but operationally it was already an autonomous judgment ledger: the agent chose a provisional path, development continued, and the human review obligation remained visible. HJP and DHA formalized an emergent practice rather than inventing it entirely on paper.

8.2 Judgment debt

A D1 decision creates judgment debt: a consequential choice has been made for development, but human acceptance remains outstanding.

Technical debt may be visible in code. Judgment debt is easier to hide because the implementation can look clean, tests can pass, and documentation can sound persuasive.

Concentrated OAP therefore adopts this law:

Autonomy may accumulate implementation debt, but it may not accumulate invisible judgment debt.

8.3 Required entry structure

Every D1 entry MUST include:

## CRIT-0001 — Short decision title

- **Status:** OPEN — HUMAN ADJUDICATION REQUIRED
- **Introduced by:** PR #123 / OAP objective 037-a
- **Category:** security | authorization | data integrity | privacy | operations | architecture | dependency | other
- **Severity:** low | medium | high | critical
- **Decision confidence:** low | medium | high
- **Required human gate:** before pilot | before external demo | before production | before irreversible migration
- **Affected components:** ...

### Dilemma
What consequential question lacked a clearly mandated answer?

### Decision taken
What did the strategic agent choose?

### Reasoning
Why was this judged the best provisional choice at the current stage?

### Alternatives considered
What credible alternatives existed?

### Strongest argument that this decision is wrong
State the best counterargument, not a token objection.

### Assumptions
What must be true for the decision to remain sound?

### Failure mode and blast radius
What could happen if the decision is wrong, and what would be affected?

### Mitigations and evidence
What tests, controls, isolation, monitoring, or constraints reduce the risk?

### Reversibility and rollback
How can the decision be changed later? What would migration cost?

### Safe autonomous continuation
Why is it safe to proceed without immediate human adjudication? What exact
work may continue autonomously, and what must remain blocked?

### Exact human gate
Before which demo, pilot, release, deployment, migration, exposure, or other
boundary must a human disposition exist?

### Exact question for the human adjudicator
What precise decision must the human eventually make?

### Strategic attestation
ALL FIVE CRITICAL-ENTRY CONDITIONS SATISFIED

### Human disposition
PENDING — append separately; do not edit this entry.

### Resolution
PENDING — cleared only by the latest appended human `ACCEPTED` disposition.

8.4 Admission threshold: the anti-garbage mechanism

A CRIT-NNNN entry is permitted only when all five conditions are satisfied:

  1. Existing human instructions, constitution, architecture, active work order, and available evidence do not resolve the issue.
  2. The strategic agent has investigated enough to identify materially different alternatives and must choose one.
  3. A wrong choice could materially affect security, authorization, privacy, data integrity, irreversible loss, trust boundaries, public exposure, deployment safety, or release acceptability.
  4. One provisional choice can be implemented and tested safely without crossing a non-delegable external or production boundary.
  5. A competent human could plausibly reject or materially change the choice before the declared gate.

The register explicitly excludes:

  • ordinary implementation decisions;
  • bugs and failed tests;
  • TODOs and known limitations;
  • refactoring and style choices;
  • ordinary dependency choices;
  • speculative risks unsupported by concrete evidence;
  • low-impact reversible trade-offs;
  • repeated entries for the same underlying dilemma.

This threshold prevents CRITICAL.md from becoming a convenient uncertainty inbox. The strategic agent must do the reasoning first. The register is reserved for consequential judgment debt, not everything that is unfinished, uncomfortable, or imperfect.

8.5 Every finalized work order declares the adjudication outcome

In the strict mechanically enforced profile, every finalized work order MUST contain one of these declarations:

## Deferred human adjudication
- Decision: NONE

or:

## Deferred human adjudication
- Decision: APPEND CRIT-0001

NONE is expected in nearly every order and requires no defensive boilerplate. An APPEND order is invalid unless it includes the complete strategic-authored entry, including the strongest case that the decision is wrong, assumptions, failure mode and blast radius, mitigations and evidence, rollback, the exact human question, safe autonomous continuation, the exact human gate, and the attestation:

ALL FIVE CRITICAL-ENTRY CONDITIONS SATISFIED

A repository implementation can enforce this in publish_order.py: reject a finalized order that omits the declaration, and reject APPEND unless the entry is complete and the attestation is present. This converts the anti-garbage rule from advice into a publication invariant.

This invariant checks structure, not whether the five conditions are substantively true. Strategy still owns that judgment. Profile validators must distinguish fenced templates from live entries; exact payload extraction, safe retries, and genuine PR provenance are specified in Appendix D.6.

8.6 Append-only-in-spirit lifecycle

Agents may add evidence, mitigation, links, and superseding implementation details. They may not erase the historical dilemma or mark it human-approved themselves.

stateDiagram-v2
    [*] --> OPEN
    OPEN --> MITIGATED: agent adds controls or evidence
    OPEN --> SUPERSEDED_PENDING: later design replaces implementation
    OPEN --> OPEN: human DEFERRED
    OPEN --> CHANGE_REQUIRED: human REJECTED or CHANGE REQUIRED
    MITIGATED --> CHANGE_REQUIRED: human REJECTED or CHANGE REQUIRED
    SUPERSEDED_PENDING --> CHANGE_REQUIRED: human REJECTED or CHANGE REQUIRED
    CHANGE_REQUIRED --> MITIGATED: agents implement human-directed fix
    OPEN --> ACCEPTED: human ACCEPTED
    MITIGATED --> ACCEPTED: human ACCEPTED
    SUPERSEDED_PENDING --> ACCEPTED: human ACCEPTED
    ACCEPTED --> [*]

8.7 Human dispositions are appended, never rewritten

Agents may not close entries. A human disposition is appended as a separate, attributable record:

## HUMAN ADJUDICATION — CRIT-0001 — 2026-09-15
- Decision: ACCEPTED
- Authority: Janez Perš / project owner
- Conditions or required follow-up:
- Evidence/reference:

Allowed decisions are:

ACCEPTED
REJECTED
CHANGE REQUIRED
DEFERRED

Only the latest human ACCEPTED disposition clears the registered gate. DEFERRED, REJECTED, and CHANGE REQUIRED remain blocking. Later mitigation or a superseding implementation does not silently close the original judgment; it supplies evidence for a later human disposition.

A mechanically enforced repository should make check_state.py report:

  • all critical entry identifiers;
  • duplicate identifiers;
  • the latest human disposition for each entry;
  • entries accepted for their registered gate;
  • entries whose gates remain open.

A named Authority: field or matching checksum does not authenticate human approval. The project needs an attributable human recording path separate from agent append permissions; unverified attribution remains blocking. Acceptance clears only the registered scope, not deployment authorization. Appendix D.6 describes these mechanical limits without prescribing a universal authentication system.

8.8 Integrity rules

CRITICAL.md should obey the following invariants:

  • every entry has a stable identifier such as CRIT-0001;
  • every entry links to the introducing PR and objective;
  • entries cannot be silently deleted;
  • an agent cannot set HUMAN_ACCEPTED;
  • a “mitigated” entry remains pending until adjudicated;
  • deployment tooling can identify open blocking entries mechanically;
  • summaries may be generated, but the detailed entry remains authoritative;
  • security tool warnings accepted as false positives remain visible until the relevant human gate.

8.9 Deliberate context-loading policy

CRITICAL.md is not an always-loaded instruction file. It should normally be excluded from opencode.json or any equivalent routine instruction list supplied on every model turn.

Instead:

  • the strategic agent reads it at startup, before a release or deployment gate, and whenever a related dilemma or existing entry becomes relevant;
  • the coding agent reads it only when the active work order requires an exact append or a relevant cross-reference;
  • summaries or state-check output may be loaded routinely, but not the full historical register.

This preserves context capacity and prevents the register from becoming an easy substitute for fresh strategic reasoning. The agent must first investigate the current issue; it may consult CRITICAL.md to detect related prior dilemmas and avoid duplicates, not to dump routine uncertainty into the queue.

Apply the wider role-specific and transitive context policy in §5.7 without changing these CRITICAL-specific read conditions.


9. The dual-gate model

9.1 Why two gates are necessary

Concentrated OAP separates:

  1. the development merge gate; and
  2. the human deployment gate.

Without this separation, automatic strategic merge would imply more confidence than the workflow actually has.

---
config:
  flowchart:
    useMaxWidth: false
---
flowchart TD
    PR[PR with tests and report] --> SG{Strategic development gate}
    SG -->|fail| REPAIR[Corrective work order]
    REPAIR --> PR
    SG -->|pass| MERGE[Merge to development truth]
    MERGE --> MVP["Milestone closure recommendation"]
    MVP --> ICA["Independent Closure Audit"]
    ICA -->|Gaps| REPAIR
    ICA -->|Evidence supports closure| HG{Human deployment gate}
    HG -->|open critical decisions| DHA[Deferred Human Adjudication]
    DHA --> HARDEN[Hardening work orders]
    HARDEN --> MVP
    HG -->|Gates satisfied and explicit authorization| DEPLOY[Deployment authorized]

9.2 Development merge gate

The strategic agent may merge when:

  • the work order is satisfied;
  • CI is green;
  • the diff is coherent;
  • evidence is adequate for continued development;
  • no D2 action occurred;
  • all D1 decisions are explicitly registered;
  • the merged state does not falsely claim production readiness.

This gate applies to product work only after the activation boundary in §5.8. Installed helpers and successful setup checks do not satisfy it.

9.3 Human deployment gate

The human deployment gate evaluates:

  • every open CRITICAL.md entry whose gate applies;
  • security and privacy boundaries;
  • trust and authorization model;
  • data lifecycle and destructive operations;
  • operational recovery and monitoring;
  • external exposure;
  • licensing and compliance where relevant;
  • whether MVP shortcuts must be removed;
  • whether the accepted residual risk matches organizational risk appetite.

Activation readiness is a separate preparation prerequisite, not a third acceptance gate or a substitute for either gate above. Review merge side effects under §7.3 and current evidence under Appendix D.4 before using delegated development merge.

9.4 Merge does not equal deployment approval

flowchart LR
    M[Strategically merged] --> A[Accepted for continued development]
    M -. does not imply .-> P[Human-approved for production]
    C[CRITICAL register cleared for target gate] --> P
    H[Explicit human authorization] --> P

This semantic distinction must be visible in documentation, branch protection, release tooling, and organizational communication.

In compact form:

strategic merge
=
best available bounded provisional engineering decision,
safe for continued development

but:

strategic merge
≠
human approval for deployment across a registered gate

An open critical entry is therefore not a waiver for public exposure, production or real customer data, destructive production mutation, disabling mandatory controls, external privilege expansion, or final release across the stated human gate.


10. MVP-ready versus production-ready

A core benefit of the extension is an honest separation of readiness levels.

Dimension MVP/demo-ready Production-ready
Core workflow Works for intended demonstration Works under qualified operational conditions
Tests Sufficient to demonstrate implemented behavior Includes critical invariants, failure recovery, security, load, and operational tests
Security decisions May contain explicit D1 provisional choices Blocking choices human-adjudicated and remediated
Authentication May be isolated or provisional if clearly blocked from exposure Fully implemented, tested, reviewed, and operationally managed
Data Synthetic, disposable, or tightly controlled Real data lifecycle, retention, deletion, backup, and recovery approved
Deployment Local or confined demo environment Approved infrastructure and exposure model
CRITICAL.md Open entries allowed if their gates are not crossed No unresolved entries blocking the target deployment
Claims “MVP”, “demo”, “prototype”, or similarly honest label Claims match verified production scope
---
config:
  flowchart:
    useMaxWidth: false
---
flowchart TB
    IDEA[Idea] --> HWP[HWP package]
    HWP --> DEV[Concentrated OAP development]
    DEV --> ICA["Closure recommendation and ICA"]
    ICA -->|Gaps| DEV
    ICA -->|Milestone evidence supports claim| MVP[MVP / demo-ready]
    MVP --> VALUE{Demo validates value?}
    VALUE -->|No| STOP[Stop, pivot, or archive]
    VALUE -->|Yes| DHA[DHA and hardening]
    DHA --> RECHECK["Updated evidence and repeat ICA where relevant"]
    RECHECK --> GATE["Human target gate and explicit authorization"]
    GATE --> PROD[Production-ready]

This is especially valuable for SMEs. Enterprise hardening is expensive. It should not necessarily precede proof that the product is useful. But demo shortcuts must not become invisible production defaults.

10.1 Independent Closure Audit: the milestone self-evaluation firewall

Concentrated OAP creates an unusually strong self-confirmation risk. The same strategic role may have:

  • interpreted the preload;
  • authored the roadmap and work orders;
  • reviewed the implementation reports;
  • issued corrections;
  • merged the PRs;
  • summarized progress;
  • and finally asked itself whether the milestone is complete.

That role may recommend closure, but it must not self-certify solely from its own queue and narrative. Before “MVP complete,” “release candidate,” or an equivalent architecture-defined milestone, run an Independent Closure Audit (ICA) using a fresh model/context, an explicitly hostile review mode, or an independent human/audit agent.

flowchart TD
    LOOP[Concentrated OAP loop] --> CLAIM[Strategic closure recommendation]
    CLAIM --> ICA[Independent Closure Audit]
    ARCH[Human scope and architecture] --> ICA
    MAIN[Current merged main] --> ICA
    EVID[Boundary-faithful evidence] --> ICA
    REPORTS[Orders, reports, README claims] -. claims only .-> ICA
    ICA --> GAPS{Gaps or unproven requirements?}
    GAPS -->|Yes| FIX[New provenance-linked closure orders]
    FIX --> LOOP
    GAPS -->|No| DHA[Human adjudication and target gate]
    LOOP --> REPEAT[Repeat ICA after closure work]
    REPEAT --> ICA

The audit classifies each requirement as implemented, partial, absent, or unproven. Completing every item in a closure plan is not enough; the plan itself may have omitted architecture requirements, so the audit is repeated after remediation.

The bootstrap profile prepares a substantive project-derived requirement matrix, an ICA protocol, request/report/matrix templates, and milestone-specific draft requests. Planned work starts honestly as unproven or absent, not pre-labeled implemented. Each audit row ties a requirement and source to enforcing code/runtime paths, tests and negative paths, limitations, and the exact audited merged revision, using IMPLEMENTED, PARTIAL, ABSENT, or UNPROVEN.

Record auditor/context provenance and evidence freshness. A new context alone does not establish independence; a generator's own second pass is not ICA. The scoped auditor works from full human/architecture scope and current evidence, not the strategist's progress narrative, and gains no implementation or merge authority. Relevant subsequent changes require reassessment. Routine bounded PRs do not each require a milestone ICA, and ICA itself does not authorize deployment. Appendix F distinguishes these evidence layers.

Field note — “Do not trust the agents.”

During the Agent-Site run, the surrounding autonomous evidence trail had converged on a “100% MVP” characterization. The human ordered a fresh rescore from architecture and current main: “Do not trust the agents.” The hostile audit treated reports, PR descriptions, README percentages, and green-check summaries as claims until code and runtime paths supported them. It found several defining paths still synthetic, stubbed, or unwired and revised the informal completeness estimate to roughly 40 percent.

The resulting closure sequence was substantially better—but another review noticed that even this sequence might omit MCP, complete media operations, source reconstruction, and some visual targets. The lesson was sharper than “audit once”: a closure plan is not evidence that the closure plan is complete.


11. Full HWP–OAP–HJP lifecycle

---
config:
  flowchart:
    useMaxWidth: false
---
flowchart TB
    subgraph BEFORE["Before the loop: HWP and reference-profile preparation"]
        B1["Settled plan and finalized sources"] --> B2["Planning model designs package"]
        B2 --> B3["Project-specific input ZIP"]
        B3 --> B4["Separate bootstrap materialization"]
        B4 --> B5{"Validation complete?"}
        B5 -->|No| HOLD["Incomplete: repair within setup scope"]
        HOLD --> B4
        B5 -->|Yes| INACTIVE["Installed and inactive"]
        INACTIVE --> READY{"Activation prerequisites and authority?"}
        READY -->|Missing| WAIT["Remain inactive; complete setup"]
        WAIT --> READY
    end

    subgraph LOOP[Concentrated autonomous OAP]
        S[Strategic agent]
        C[Coding agent]
        PR[PR, CI, tests, report]
        CR[CRITICAL.md updates]
        S --> C
        C --> PR
        PR --> S
        S --> CR
        S -->|merge or corrective order| C
    end

    subgraph AFTER[After MVP: Human Judgment Postloading]
        A1["Human reviews applicable gates and CRITICAL"] --> A2["Accept, reject, change, or defer"]
        A3["Hardening work orders"]
        A4["Explicit human deployment authorization"]
    end

    READY -->|Established| ACTIVATE["Explicit operational activation"]
    ACTIVATE --> S
    LOOP --> CLAIM["Strategic closure recommendation"]
    CLAIM --> ICA[Independent Closure Audit]
    ICA -->|gaps| LOOP
    ICA -->|coverage proved| AFTER
    A2 -->|remediation or more evidence| A3
    A3 --> LOOP
    A2 -->|Evidence and applicable gates satisfied| A4

The human is not removed. Human work is redistributed:

  • before the loop: high-density architecture and governance work;
  • during the loop: exceptional intervention only;
  • after independent closure of the MVP claim: focused adjudication of recorded judgment debt;
  • before deployment: explicit authorization.

The package/materialization steps illustrate the reference profile; the existing HWP, ICA, and human-authority rules govern any implementation. Missing validation or activation prerequisites leave preparation inactive and never auto-start product work.


12. Ordinary OAP versus Concentrated OAP

Dimension Ordinary OAP Concentrated OAP with HWP/HJP
Human role Human remains available at recurring strategic review and approval gates. Human concentrates work before the loop and returns at milestone/adjudication/deployment gates.
Initial preparation Strategic discovery and constitution precede execution. Much deeper preload: architecture, roadmap, work-order sequence, decision taxonomy, critical-register law, and readiness semantics.
Strategic AI Advisory control plane and first reviewer. Logically persistent delegated development supervisor, work-order authority, first reviewer, and conditional merge authority.
Coding agent Executes PR-sized work and returns evidence. Same, often more disposable and mechanically driven by strategic work orders.
Merge authority Human approval is normally required for protected branches. Strategic agent may merge development PRs under strict policy; human retains release/deployment authority.
Difficult dilemma Strategic AI may prepare the issue for human decision. Strategic AI must decide D0/D1; D1 is recorded for later adjudication.
Human interruption Expected at meaningful review and approval points. Minimized during development; reserved for D2 or explicit milestone gates.
Uncertainty handling Often surfaced in decision brief before merge or release. Converted into visible judgment debt in CRITICAL.md; development may continue.
Critical artifact Decision brief, review report, remediation list. All ordinary artifacts plus a durable Deferred Human Adjudication Register.
Readiness model Human judges merge and release readiness continuously. Explicit dual readiness: development/MVP acceptance versus production authorization.
Milestone completion claim Human and strategic review certify completion at ordinary gates. The concentrated loop may recommend closure but must pass a fresh Independent Closure Audit before the milestone is accepted.
Risk posture Conservative human-governed cadence. Aggressive development velocity with strict containment and deferred deployment gate.
Best fit High-risk work, changing goals, or teams requiring frequent human control. Well-preloaded MVP programs, time pressure, isolated environments, and SMEs proving value before hardening.
Reproducible bootstrap May use separate workspaces and bootstrap tooling. Optional reference profile compiles settled planning into inputs, materializes the harness, and stops before activation.
Governance/context loading May use concise constitutions and selective context. Reference profile makes full strategic law, executor projections, transitive budgets, and controlled refresh explicit.

12.1 Human-attention distribution

---
config:
  flowchart:
    useMaxWidth: false
---
flowchart TD
    subgraph Ordinary[Ordinary OAP]
        direction TB
        O1[Human discovery]
        O2[Agent work]
        O3[Human review]
        O4[Agent repair]
        O5[Human merge decision]
        O6[Next cycle]
        O1 --> O2 --> O3 --> O4 --> O5 --> O6
    end

    subgraph Concentrated[Concentrated OAP]
        direction TB
        C1[Heavy human preload]
        C2[Long autonomous development interval]
        C3["Closure recommendation and ICA"]
        C4[Focused human adjudication]
        C5[Autonomous hardening]
        C6[Human deployment decision]
        C1 --> C2 --> C3 --> C4
        C3 -->|Gaps| C2
        C4 -->|Remediation| C5
        C5 --> C3
        C4 -->|Evidence and applicable gates satisfied| C6
    end

13. Authority and responsibility

13.1 Authority matrix

Activity Human Strategic agent Coding agent
Define product purpose and domain truth Owns Advises and challenges No authority
Define risk appetite and D2 boundaries Owns Drafts and applies Must obey
Maintain architecture Approves foundational intent Owns delegated evolution Implements ordered changes
Create work orders May direct Primary authority No authority to self-assign broad objectives
Implement and test Optional targeted work Reviews Primary authority
Create/amend PR Optional Supervises Primary authority
Review PR and CI May inspect Primary development reviewer Supplies evidence, cannot self-approve
Merge development PR Delegated by policy Conditional authority Never
Record D1 judgment May add Determines necessity, authors exact entry, assigns ID May report a candidate; cannot invent or rewrite the entry
Resolve CRITICAL.md entry Exclusive final authority Recommends Implements resulting work
Cross D2 boundary Exclusive authority Must stop before action Must not act
Authorize production deployment Exclusive authority Prepares evidence Executes only after authorization
Accountability Retains Not accountable Not accountable

13.2 Authority flow

flowchart TD
    H[Human authority<br/>intent, risk, adjudication, deployment] --> S[Strategic delegated authority<br/>planning, review, development merge]
    S --> C[Coding delegated authority<br/>implementation, testing, PR]
    C --> G[GitHub and CI evidence]
    G --> S
    S --> CR[CRITICAL judgment register]
    CR --> H

Delegation does not transfer accountability. The human or organization remains responsible for the system and for the decision to deploy it.

13.3 Authorship and append mechanics

The strategic agent owns whether an entry is warranted. It must investigate, make the provisional decision, assign the next CRIT-NNNN identifier, author the exact entry, include it in the current work order or a same-PR corrective order, and verify that it was appended without changing previous entries. If continued development is safe and the development merge gate passes, it may still merge while preserving the human gate.

The coding agent cannot invent a critical entry or rewrite the strategic judgment. It may append only the exact ordered bytes, preferably through a narrow helper such as:

python oap/bin/append_critical.py \
  --repo-root "$REPO_ROOT" \
  --source /path/to/strategic-authored-entry.md \
  --id CRIT-0001

The append belongs in ordinary implementation work and is committed before the implementation SHA is captured. It must never be smuggled into the final report-only commit. The coding agent may not edit, delete, weaken, close, or mark an entry human-approved.

If the coding agent independently discovers a possible consequential issue, it may report a candidate with evidence. Only the strategic agent may decide whether the five-condition threshold is met and order an append.

Within the reference profile, the introducing PR must actually exist: if unknown at order finalization, establish a safe prerequisite PR and issue a same-PR continuation containing the complete entry before development acceptance of that provisional choice. Coding must not replace placeholders with its own judgment. Appendix D.6 defines byte-preserving append/retry checks; Appendix D.4 defines the separate report-only SELF commit and current-head review.


14. Strategic-agent decision protocol

When a D1 dilemma appears, the strategic agent should follow a reproducible protocol rather than improvising a persuasive justification.

14.1 Decision procedure

  1. Name the dilemma precisely. Avoid vague language such as “security may be a concern.”
  2. Locate governing authority. Cite architecture, constitution, work order, tests, standards, or code.
  3. Generate credible alternatives. Include at least one materially different approach when possible.
  4. Evaluate stage suitability. A good MVP decision may be a bad production decision.
  5. Prefer reversibility. Under uncertainty, prefer the option that preserves future correction.
  6. Prefer containment. Confine provisional risk to local, synthetic, or non-production contexts.
  7. Prefer fail-closed behavior for security and authorization unless the preload explicitly says otherwise.
  8. Choose. Do not end with “human should decide” for D1.
  9. Mitigate and test. Add controls proportional to the provisional risk.
  10. Write the strongest counterargument. Explain how the decision could be wrong.
  11. Record the entry. Commit CRITICAL.md in the same PR or before strategic merge.
  12. Continue. Move to the next objective unless a D2 boundary is reached.
flowchart LR
    N[Name dilemma] --> G[Find governing constraints]
    G --> A[Compare alternatives]
    A --> S[Assess stage, reversibility, containment]
    S --> D[Choose provisional decision]
    D --> T[Mitigate and test]
    T --> X[Write strongest counterargument]
    X --> C[Commit CRITICAL entry]
    C --> M[Merge for continued development]

14.2 Confidence is not permission to omit

A high-confidence strategic decision may still be D1 if the consequence is high. A low-confidence decision is not automatically D2 if it remains reversible and contained.

Classification depends on authority and consequence, not only model confidence.

14.3 Allowed reasons to stop

The strategic agent MAY stop and request immediate human intervention when:

  • a D2 boundary would otherwise be crossed;
  • explicit project instructions conflict irreconcilably;
  • required human product intent is absent and any choice would redefine the product;
  • an imminent action could cause irreversible harm;
  • available evidence is insufficient even to choose a containable provisional path;
  • legal, ethical, contractual, or organizational authority cannot be delegated;
  • the runtime cannot safely isolate the proposed work.

It MUST NOT stop merely because:

  • two reasonable libraries exist;
  • a reversible architecture choice is uncomfortable;
  • the strategic agent prefers a human to absorb reputational responsibility;
  • perfect certainty is unavailable;
  • production hardening is incomplete but the current work is confined to MVP development.

15. Failure modes introduced by the extension

Concentrated OAP increases autonomy and therefore introduces risks beyond ordinary OAP.

15.1 Strategic self-rationalization

The same model may choose a design and then review its own reasoning. It can produce a coherent but biased explanation.

Mitigations:

  • mandatory strongest-counterargument section;
  • separate coding and strategic roles;
  • independent CI and scanners;
  • external model or human audit at milestones;
  • explicit confidence and assumptions;
  • evidence links rather than prose-only justification.

15.2 Missing critical entries

The greatest danger is not a bad recorded decision but an unrecorded one.

Mitigations:

  • work-order template asks whether D1 decisions were introduced;
  • coding report has a “critical decisions discovered” section;
  • strategic merge checklist requires CRITICAL.md review;
  • automated diff rules flag changes to auth, permissions, deletion, networking, credentials, migrations, security policy, and data retention;
  • release tooling fails if required critical metadata is missing.

15.3 Compounding provisional decisions

Several individually defensible shortcuts can combine into an unsafe architecture.

flowchart LR
    D1A[D1 auth shortcut] --> C[Combined system]
    D1B[D1 network shortcut] --> C
    D1C[D1 logging shortcut] --> C
    C --> X[Emergent high risk]

Mitigations: periodic aggregate review of the complete CRITICAL.md, not only entry-by-entry review; dependency links between entries; milestone-level threat-model refresh.

15.4 Demo-to-production leakage

A successful demonstration creates organizational pressure to deploy immediately.

Mitigations:

  • explicit readiness labels;
  • deployment gate in CI/CD;
  • local/demo environment isolation;
  • CRITICAL.md banner in release notes;
  • no production credentials in MVP runtime;
  • separate deployment authorization token or manual environment protection rule.

15.5 Stale preload

The human preload may become wrong as requirements evolve.

Mitigations: versioned architecture decisions, strategic drift checks, periodic HWP refresh, and D2 classification when implementation would contradict human-owned intent.

15.6 Unmanageable adjudication backlog

If every minor choice becomes D1, CRITICAL.md becomes noise.

Mitigations: clear D0/D1 thresholds, deduplication, grouping related entries, severity and gate fields, and milestone triage.

15.7 Strategic milestone self-certification

A strategically coherent system can still overestimate its own completeness because omissions compound across the same architecture, execution, review, and reporting loop.

Mitigations: mandatory Independent Closure Audit at named milestones; architecture-to-current-main requirement matrices; reports treated as claims rather than proof; repeated audit after remediation; human authority over the final milestone label.

The following are design risks addressed by the reusable reference profile, not additional observations from the field exercise.

15.8 Role contamination through instruction discovery

A bootstrap, coding, strategic, or audit role inherits another role's instructions or treats inspection as permission to act.

Mitigations: distinct non-nested roots, minimal router, explicit launcher identity and model-visible routing, guarded role sources, safe archive filenames, and checks of actual client discovery. Prompt routing is not an OS security boundary.

15.9 Lossy distillation and indirect context bloat

A summary drops a prohibition or exception, or a small router indirectly loads the complete source library.

Mitigations: stable source-to-clause mapping, deliberate semantic review, transitive read-set measurement, declared projection scope, and bounded clarification. Density never permits truncation or ambiguous law.

15.10 Source, projection, and installed-copy drift

Compact architecture becomes stale, private strategic copies diverge, or a seed checksum incorrectly freezes a live register.

Mitigations: separate integrity domains, accepted-versus-candidate comparison, authorized refresh at a quiescent checkpoint, and preserved history.

15.11 Accidental activation during setup

Extraction, reruns, login shells, or an acknowledgement flag starts product work or triggers protected remote effects.

Mitigations: separate package, materialization, setup, and activation stages; absent new-project active pointer; no-write/no-start checks; preservation of existing state; inspection of merge-triggered automation.

15.12 False confidence from bootstrap validation

File existence, fake-client tests, or a polished receipt are mistaken for actual-client qualification, product execution, ICA, or release approval.

Mitigations: separate evidence layers, truthful result vocabulary, exact tested boundaries and revisions, independent milestone audit, and human target gates.


16. SME and MVP use case

16.1 Why the model fits SMEs

SMEs often face a staged economic problem:

  1. prove that the product or internal tool creates value;
  2. obtain management, customer, or funding approval;
  3. only then justify enterprise hardening and operational integration.

Requiring complete production maturity before validation can consume scarce expertise on a product that may never be approved. Skipping hardening entirely creates dangerous prototype-to-production drift.

Concentrated OAP provides a third path:

---
config:
  flowchart:
    useMaxWidth: false
---
flowchart TD
    SME[SME need] --> PRE[Concentrated expert preload]
    PRE --> AUTO[Autonomous MVP delivery]
    AUTO --> DEMO[Demo with honest readiness label]
    DEMO --> DEC{Business value approved?}
    DEC -->|No| ARCHIVE[Stop without paying full hardening cost]
    DEC -->|Yes| REVIEW[Human adjudication and risk acceptance]
    REVIEW --> HARDEN[Agentic production hardening]
    HARDEN --> ICA["ICA against current milestone evidence"]
    ICA -->|Gaps| HARDEN
    ICA -->|Evidence supports target| GATE["Explicit human target authorization"]
    GATE --> DEPLOY[Controlled deployment]

16.2 What makes it a responsible accelerated workflow

The workflow is not “move fast and ignore security.” It is:

  • move fast inside a bounded development environment;
  • preserve every consequential unresolved judgment;
  • prohibit non-delegable production actions;
  • prove business value before buying full hardening;
  • perform focused human review before exposure;
  • convert rejected provisional decisions into new work orders;
  • keep release claims honest.

16.3 Stage-specific risk appetite

Stage Allowed state
Local development D0 and contained D1 decisions permitted; D2 prohibited.
Internal demo with synthetic data Open D1 entries permitted if their declared gate is later and isolation is verified.
External demo or controlled pilot Entries affecting exposure, auth, privacy, data, and contractual claims must be adjudicated first.
Production All entries blocking production must be resolved; remaining accepted risks must be explicit.

17. Adoption path from ordinary OAP

An existing OAP project can adopt the extension incrementally.

flowchart LR
    O[Ordinary OAP] --> A1[Add deeper HWP package]
    A1 --> A2[Define D0 D1 D2]
    A2 --> A3[Create CRITICAL.md]
    A3 --> A4[Require forced D1 decisions]
    A4 --> A5[Delegate strategic development merge]
    A5 --> A6[Add deployment gate]
    A6 --> A7[Require Independent Closure Audit]
    A7 --> A8[Schedule DHA milestone]

Step 1: deepen the preload

Add a detailed architecture, risk posture, milestone definitions, non-goals, work-order roadmap, and readiness levels.

Step 2: define delegated decision space

Specify D0, D1, and D2 with examples specific to the repository.

Step 3: create CRITICAL.md

Commit the template before autonomous development begins. Make its review part of every strategic merge.

Step 4: modify the strategic constitution

Require the strategic agent to decide D1 dilemmas and prohibit it from using human escalation as a default escape.

Step 5: delegate development merge carefully

Allow strategic merge only after CI, evidence, scope, and critical-register checks. Do not delegate production deployment.

Step 6: enforce readiness semantics

Add MVP/demo labels, release notes, and CI/CD checks that distinguish merged development truth from deployable production truth.

Step 7: require Independent Closure Audit

Before the strategic agent may label an architecture-defined milestone complete, require an architecture-to-current-main audit that does not begin from the strategic agent's own completion narrative. Repeat it after closure work.

Step 8: schedule DHA

Define when the human adjudication sprint occurs: MVP completion, before external demo, before pilot, before production, or at multiple milestones.

17.1 Using the reusable bootstrap-package generator

  1. Finish planning in a conversation with settled intent, scope, architecture, constraints, and acceptance criteria. Attach finalized source files when their exact bytes matter.
  2. Paste the entire reusable bootstrap-package generator prompt into that same planning conversation. It uses the existing project context; it is not a request to refill a generic questionnaire or invent a new plan.
  3. Review the resulting project-specific input ZIP, source map, assumptions, and proposed destinations. It contains inputs and contracts, not application code or a running installation.
  4. Extract it into a new empty temporary directory, separate from and not above either operational workspace. AGENTS.md must sit directly at the extraction root, without an extra wrapper directory.
  5. Launch a capable tool-using bootstrap agent in that directory, within the agreed materialization boundary, using the short prompt below.
  6. Inspect BOOTSTRAP-RECEIPT.md, actual validation results, outstanding prerequisites, and the inactive state. Missing remote or model credentials can leave a valid scaffold blocked for activation.
  7. Complete role-specific configuration through setup mode, verify runtime/remote/authority boundaries, and separately authorize operational activation. Strategy reconciles current facts before activating the first appropriate order.

Reusable planning resource

Concentrated OAP — Reusable Bootstrap-Package Generator Prompt, Version 1.0.

Download the generator prompt (.md, English)

Open the downloaded Markdown file as text and paste its entire contents into your completed project-planning conversation. This is the reusable prompt; the project-specific bootstrap-input ZIP is produced by that conversation afterward.

Startup prompt for the bootstrap agent in the extracted directory:

Read AGENTS.md and execute INSTRUCTIONS.md. Use the bundled PLAN.md,
ARCHITECTURE.md, CRITICAL.md, specifications, and available source documents.
Materialize and validate the separate coding and strategic workspaces.
Do not execute product orders or start operational agents.
Stop before activation and write BOOTSTRAP-RECEIPT.md.

Two prompts, two stages

The long reusable prompt goes into the planning conversation to create the input package. The short startup prompt goes to the bootstrap agent in the extracted directory to install and validate the operational setup. Neither is a product work order, and neither starts the autonomous development loop.


The following compact rule set can be adapted into a strategic-agent constitution:

## Deferred judgment law

- You are the strategic development authority, not the human release authority.
- For D0 decisions, decide, test, document normally, and continue.
- For D1 decisions, you MUST choose the best provisional option, mitigate it,
  test it, and record a complete entry in CRITICAL.md. You MUST NOT stop merely
  because a human might prefer to choose between reasonable reversible options.
- For D2 boundaries, analyze and recommend, but MUST NOT perform the real action
  without explicit human authorization.
- A merged PR means accepted for continued development, not human-approved for
  production.
- You may merge only when required CI is green, the work order is satisfied,
  the diff is coherent, no D2 boundary was crossed, and every D1 decision is
  recorded.
- You MUST state the strongest argument that each D1 decision is wrong.
- You may create a D1 entry only when all five critical-entry admission
  conditions are satisfied; ordinary bugs, TODOs, limitations, style choices,
  speculative risks, and low-impact reversible trade-offs do not qualify.
- Every finalized work order MUST declare `Decision: NONE` or
  `Decision: APPEND CRIT-NNNN`; `NONE` is the normal case.
- You own the exact text and identifier of every ordered append. The coding
  agent may append only those exact bytes and may report candidates only.
- You may add evidence or mitigation to CRITICAL.md, but you may not delete an
  entry or mark it human-accepted.
- Only an appended, attributable human `ACCEPTED` disposition clears the
  registered gate; all other dispositions remain blocking.
- Production deployment is forbidden while applicable blocking entries remain
  unresolved.
- Every new work order MUST identify durable provenance in human intent, architecture,
  observed evidence, independent audit, or critical-remediation need.
- Your strategic role is logically persistent across process, model, provider, and
  context replacement; reconstruct state from GitHub and OAP artifacts before acting.
- You may recommend milestone closure, but MUST NOT certify it solely from your own
  work-order history. Require an Independent Closure Audit before the human gate.

For projects selecting the reusable reference profile, add the following separately; it does not replace the deferred-judgment law:

Reference-profile startup and context law
- Bootstrap installs and validates; it stops before product work and activation.
- Keep bootstrap, repository, and strategic roots distinct and non-nested.
- The root router selects assigned role law; inspection never changes authority.
- Coding reads dense executor law and compact architecture for its declared scope.
- Strategy retains full law and canonical sources; ICA examines full milestone scope.
- Measure the transitive read set; never truncate an obligation to meet a budget.
- Reconcile source/projection identity and durable state before operational action.
- A setup shell or acknowledgement flag is not delegated activation authority.
- Preserve existing runs, evidence, and human gates during reruns and refreshes.

19. Pre-deployment Deferred Human Adjudication procedure

19.1 Inputs

The human adjudicator receives:

  • the current ARCHITECTURE.md;
  • the complete CRITICAL.md;
  • links to introducing PRs and objectives;
  • CI and test evidence;
  • current threat model and deployment topology;
  • external scanner or audit results;
  • strategic recommendations;
  • implementation and rollback cost estimates.

19.2 Disposition options

For each entry, the human appends exactly one of four decisions:

  • ACCEPTED: the provisional decision is approved for the registered target gate. This is the only disposition that clears that gate.
  • REJECTED: the provisional decision is not acceptable; the gate remains blocked and remediation or removal is required.
  • CHANGE REQUIRED: the direction may be viable only after explicit named changes are implemented and re-presented for adjudication.
  • DEFERRED: the human is not deciding yet; the registered gate remains open.

Conditions, evidence requests, scope restrictions, and follow-up actions belong in the disposition's Conditions or required follow-up and Evidence/reference fields. They do not create additional decision values. If material work remains, the disposition is CHANGE REQUIRED or DEFERRED, not ACCEPTED.

19.3 Resulting work

sequenceDiagram
    participant H as Human adjudicator
    participant R as CRITICAL.md
    participant S as Strategic agent
    participant C as Coding agent
    participant G as GitHub and CI

    H->>R: Review each applicable entry
    H->>S: ACCEPTED, REJECTED, CHANGE REQUIRED, or DEFERRED
    S->>C: Issue hardening or evidence work orders
    C->>G: Implement, test, open PR
    G-->>S: CI and evidence
    S->>H: Updated adjudication brief
    H->>R: Record final disposition
    H->>G: Authorize target deployment gate

19.4 Completion condition

The deployment gate passes only when:

  • every applicable blocking entry has latest human disposition ACCEPTED;
  • required remediation is merged and verified;
  • accepted conditions are enforceable;
  • release claims match the approved scope;
  • deployment authorization is explicit and attributable.

20. Doctrine

Concentrated OAP can be summarized in fifteen rules:

  1. The human owns product meaning, risk appetite, and deployment authority.
  2. The human performs concentrated engineering work before the loop.
  3. The preload is encoded in durable, versioned artifacts.
  4. The strategic agent owns delegated development planning and review.
  5. The coding agent owns implementation, tests, and PR evidence—not merge or product direction.
  6. GitHub, CI, and repository documents are authoritative.
  7. A difficult reversible decision is not permission to stop.
  8. Only five-condition D1 judgment debt enters CRITICAL.md; qualifying uncertainty becomes a provisional decision plus an exact append.
  9. D2 boundaries remain human-controlled.
  10. Strategic merge means accepted for continued development, not approved for production.
  11. No applicable judgment debt may remain invisible at deployment.
  12. Human adjudication closes the loop before the system crosses its declared deployment boundary.
  13. Persistent strategy is logical, not process-bound. Models and sessions may change without changing the active objective or authority structure.
  14. Every objective needs durable provenance. Autonomous activity must trace to human intent, architecture, evidence, audit, or adjudication.
  15. The strategic loop may recommend closure but may not self-certify it. Independent Closure Audit precedes the human milestone gate.
---
config:
  flowchart:
    useMaxWidth: false
---
flowchart TB
    PRELOAD[Preload what can be decided] --> DECIDE[Decide provisionally what remains]
    DECIDE --> RECORD[Record uncertainty honestly]
    RECORD --> BUILD[Continue autonomous development]
    BUILD --> ICA["Closure recommendation and Independent Closure Audit"]
    ICA -->|Gaps| BUILD
    ICA -->|Evidence supports closure| ADJUDICATE[Human adjudicates at the gate]
    ADJUDICATE --> DEPLOY[Deploy only after authorization]

The reference-profile summary is separate from these fifteen doctrinal rules: compile settled planning into a self-contained package; materialize distinct role workspaces; review and measure executor projections; validate the harness and leave it inactive; activate only after reconciliation and authority checks; preserve durable publication and recovery evidence. Paths, budgets, and transport choices implement the doctrine rather than adding universal rules.


21. Conclusion

Ordinary OAP is a disciplined human-governed workflow that separates strategic reasoning from operational execution while retaining human control over intent, risk, review, and release. Concentrated OAP preserves that foundation but changes the temporal and organizational placement of judgment.

Human Work Preloading moves a larger share of human engineering work before the autonomous loop. A logically persistent strategic role and a task-local coding agent can then execute a much longer sequence of work orders, reviews, corrections, and development merges without routine human interruption. The strategic process may be restarted or replaced, but the project continues from GitHub and the OAP transcript rather than hidden session memory.

Human Judgment Postloading does not suppress the decisions that could not be preloaded. It forces the strategic agent to make contained provisional choices and preserve them in an auditable register. Before that register reaches the human gate, an Independent Closure Audit tests whether the architecture-defined milestone is genuinely present in current merged software rather than only in the strategic narrative. Deferred Human Adjudication then concentrates human review at the point where it has the most value: after the MVP has proved usefulness, but before unresolved judgment can become production exposure.

The extension is therefore not “fully autonomous software engineering.” It is a more aggressively time-shifted form of human governance:

The human works before the loop, agents work inside the loop, and the human adjudicates before deployment.

For SMEs and other teams under serious MVP pressure, this can provide a practical balance between speed and responsibility. It avoids spending full enterprise-hardening effort before value is demonstrated, while also preventing demo-oriented compromises from silently becoming production assumptions.

Reproducible bootstrap makes the HWP handoff explicit: settled human planning becomes inspectable inputs, distinct operational contexts, and a tested but inactive scaffold. Selective context gives each role the law it needs while retaining full architecture authority and traceability. This is a design for carrying governance into execution, not a measured claim of token savings, speedup, reliability, or production readiness.


Appendix A: Minimal CRITICAL.md header

# Deferred Human Adjudication Register

This file records consequential autonomous decisions that require explicit human
adjudication before the declared release or deployment boundary.

Rules:

1. A new entry is permitted only when all five critical-entry admission
   conditions are explicitly satisfied.
2. Agents may add entries, evidence, mitigations, and superseding links.
3. Agents may not delete entries, rewrite history, or mark entries
   human-approved.
4. Every entry has a stable CRIT identifier, source PR/objective, decision,
   counterargument, assumptions, failure mode, rollback, safe-continuation
   scope, exact human gate, human question, and strategic attestation.
5. Human dispositions are appended separately and attributable to a named
   authority.
6. Merged development work may contain OPEN entries.
7. Deployment is prohibited until the latest applicable human disposition is
   ACCEPTED.

Appendix B: Human adjudication checklist

  • Confirm the target gate: internal demo, external demo, pilot, or production.
  • Read every CRITICAL.md entry applicable to that gate.
  • Verify that each entry links to the actual PR, diff, tests, and current code.
  • Challenge the strategic reasoning and strongest counterargument.
  • Check whether assumptions still hold in the actual deployment topology.
  • Check combined risk across entries, not only each entry separately.
  • Confirm rollback and migration feasibility.
  • Append one exact decision: ACCEPTED, REJECTED, CHANGE REQUIRED, or DEFERRED.
  • Convert rejected or conditional decisions into explicit hardening work orders.
  • Verify remediation through CI and targeted evidence.
  • Record human disposition with date and accountable authority.
  • Ensure release language matches the adjudicated scope.
  • Authorize deployment only after all applicable blockers are resolved.

Appendix C: Terminology summary

Term Definition
OAP Human-governed, constitution-driven orchestration of strategic AI and high-autonomy execution agents.
HWP Human Work Preloading: concentrated human engineering judgment encoded before the autonomous loop.
Concentrated OAP HWP-enabled OAP with logically persistent strategic supervision, reduced routine human interruption, and conditional strategic development merge.
HJP Human Judgment Postloading: deliberate temporal deferral of unresolved human judgment until a defined milestone.
DHA Deferred Human Adjudication: the formal human process for resolving provisional decisions.
Judgment debt Consequential human acceptance still outstanding after an autonomous provisional decision.
CRITICAL.md Append-only-in-spirit Deferred Human Adjudication Register.
D0 Ordinary delegated decision.
D1 Consequential but containable provisional decision requiring later human adjudication.
D2 Non-delegable boundary requiring human authorization before the real action.
Development merge gate Strategic evidence and CI gate for accepting work into continued development.
Human deployment gate Human authority gate for external, production, destructive, or otherwise consequential deployment.
Logical strategic persistence Continuity of strategic role, authority, and transcript across model, provider, process, or context replacement.
Work-order provenance Durable reason linking an objective to human intent, architecture, observed evidence, independent audit, or critical remediation.
Independent Closure Audit (ICA) Fresh architecture-to-current-main audit that prevents the strategic loop from self-certifying milestone completion.
Bootstrap-input package Project-specific sources and governance specifications handed to a separate bootstrap agent; not the installed product.
Bootstrap materialization Creation and validation of operational workspaces and orchestration from those inputs.
Role router Minimal entry point selecting the assigned role's governing documents without conferring authority.
Executor projection Dense, traceable representation of full law relevant to coding, preserving its normative meaning.
Transitive read set All automatically or mandatorily loaded content, including indirect references and relevant inherited instructions.
Distillation map Trace from full-source obligations to compact clauses or explicit non-applicability decisions.
Installed-but-inactive handoff Validated scaffold awaiting separately authorized operational activation.
Bootstrap receipt Evidence-linked record of materialization checks and outstanding prerequisites, not product acceptance.
Reference implementation profile A selectable concrete realization of OAP doctrine, not its only valid implementation.

Appendix D: Reusable bootstrap reference profile

This appendix specifies the concrete profile introduced in §1.2. Its inventories, local transport, identifiers, and publication conventions are implementation choices. All paths and commands here are documentation examples for a future materialized project, not instructions to bootstrap the documentation repository.

D.1 Bootstrap-input archive

The reusable resource is a prompt, not a universal prebuilt ZIP. Each settled planning conversation produces its own architecture, work program, contracts, and acceptance requirements. Paths below are relative to that input archive's root:

AGENTS.md                         # bootstrap-only constitution
INSTRUCTIONS.md                   # materialization procedure and stop condition
PLAN.md                           # standalone plan; exact bytes when finalized
ARCHITECTURE.md                   # full product architecture
CRITICAL.md                       # empty new seed or preserved existing register
README.md                         # extraction, start, destinations, later activation
SOURCE-MAP.md                     # authority, facts, defaults, assumptions, conflicts
PACKAGE-MANIFEST.json              # inventory and source relationships
INPUTS.sha256                     # original input byte identities
PACKAGE-CHECKS.md                  # actual package checks only
specifications/
  ROLE-CONTEXT.md
  OAP-PROTOCOL.md
  WORK-PROGRAM.md
  BOOTSTRAP-ACCEPTANCE.md
sources/
  concentrated-oap.md              # when available and permitted
  oap.md                          # when available and permitted
  ...                             # necessary permitted project references

AGENTS.md is directly at the root; there is no enclosing wrapper directory. Package checks inspect absolute paths, traversal, unexpected symlinks, inventory, checksums, links, and extraction into a disposable directory. Only safe relative paths are admitted. Extraction alone neither installs the harness nor validates its runtime. Historical source snapshots are provenance, not additional current governing copies.

D.2 Materialized workspaces and filesystem safety

The bootstrap agent creates the following grouped responsibilities from the specifications. These are not extra files the planning model must falsely claim to have executed:

REPO_ROOT/
  AGENTS.md                         # tiny role router
  PLAN.md
  ARCHITECTURE.md                    # current full source
  ARCHITECTURE-for-agents.md         # executor projection
  CRITICAL.md                        # live register
  OAP-COMMUNICATION-coding-agent.md  # compact protocol
  README.md / STATUS.md / SECURITY.md / TESTING.md
  docs/
    OAP-RUNBOOK.md
    AGENT-ROLE-SETUP.md
    READINESS.md
    DECISION-POLICY.md
    RUNTIME-CONSTRAINTS.md
    BOOTSTRAP-SOURCES.md
    bootstrap/
      BOOTSTRAP-GENERATOR.md         # historical law; not discoverable AGENTS.md
      ...
  oap/
    README.md / RECOVERY.md / COMPLETENESS.md
    bootstrap-sources.lock.json
    runtime.env.example
    coding-instructions/
      AGENTS.md
    strategic-instructions/
      AGENTS.md                     # versioned full strategic source
      OAP-COMMUNICATION-strategic.md
      strategic_model_init_material.md
      INITIAL-ROADMAP.md
      initial-orders/               # substantive inactive drafts
    governance/
      MANIFEST.json
      DISTILLATION-MAP.md
      CONTEXT-BUDGET.md
    templates/                      # order, report, review, CRITICAL, disposition, handoff
    audit/                          # ICA protocol, templates, milestone requests
    prompts/                        # small role-specific startup prompts
    bin/                            # tested helpers and launchers
    orders/                         # no activated orders in a new installation
    reports/                        # no fabricated reports
    # active is ABSENT at successful new bootstrap
  tests/oap/

STRATEGIC_HOME/
  AGENTS.md                         # controlled full strategic copy
  OAP-COMMUNICATION-strategic.md
  strategic_model_init_material.md
  INITIAL-ROADMAP.md
  SOURCE-REFERENCES.md               # references to canonical plan/architecture/register
  RUNTIME.md
  runtime.env                       # private; activation disabled
  control.fifo / response.fifo
  drafts/ / critical-drafts/
  workorders/                       # timing ledger and strategic handoff
  audit/ / logs/ / bootstrap-backups/
  agent-homes/coding/
  agent-homes/strategic/

Avoid redundant documents that merely inflate the inventory. Shared validation code is preferable to inconsistent parsers. Installed strategic copies are refreshed from their versioned source; the plan, architecture, and CRITICAL remain canonical repository files.

Before writing, inspect canonical paths, types, ownership, symlinks, inherited instructions, Git state/remotes, dirty and untracked work, and existing manifests. Support both ordinary .git directories and worktree .git files. Resolve all three roots and confirm they are distinct and non-nested; handle spaces and Unicode through validation and quoting. Give private configuration and FIFOs appropriate permissions.

The profile requires a no-write dry run, an identical no-op rerun, and an explicit scoped refresh with backups. Preserve real code, active runs, reports, CRITICAL entries, private setup, and history. A reset, clean, stash, broad permission change, unsafe symlink traversal, or force-push must not be used to erase existing work. Conflicting state remains visible until a scoped transition is authorized.

Missing remote configuration does not prevent safe local materialization; it prevents remote-readiness claims. Materialization does not authorize creating a remote repository, choosing public visibility, publishing the real scaffold, changing branch protections, or opening a real PR. It also does not authorize product downloads, inference, implementation, credential manipulation, protected service changes, network exposure, or background auto-start. Disposable Git fixtures are a different test scope. Passwordless local privilege is not authority over valuable host state.

D.3 Durable orders, publication, and notifications

This transport assumes a shared POSIX filesystem, such as Linux or a suitable WSL installation. Local FIFOs do not connect unrelated machines. A different transport needs its own explicit, tested framing, correlation, state, replay, and recovery rules.

REPO_ROOT/oap/orders/<ID>-<slug>.md
REPO_ROOT/oap/reports/<ID>-<slug>.md
REPO_ROOT/oap/active
STRATEGIC_HOME/control.fifo
STRATEGIC_HOME/response.fifo

Strategy owns order text and active-pointer publication; coding includes those exact authorized bytes with the work and owns its report. Published orders and reports are immutable. The pointer changes only through authorized publication, with its history evidenced.

For a new inactive installation the pointer is absent. An existing empty or malformed pointer is an error. A valid pointer contains exactly one valid ID followed by one LF, resolving to exactly one immutable order. Never select an order by newest filename, largest number, timestamp, or directory order.

This profile's ID grammar and suffix range are:

^[0-9]{3}-[a-z]{1,2}$
a, b, ..., z, aa, ab, ..., az, ba, ..., zz

NNN-a creates one objective branch/PR. Later suffixes amend that same branch/PR; an interrupted first round reuses its already-created PR. New strategic requirements after review use the next suffix, while process, context, model, provider, or machine replacement does not. Exhaustion requires an explicit protocol revision, not silent renumbering. Advance to a new objective only after verified merge/acceptance or explicit abandonment with dependency reassessment; abandonment is not acceptance.

Publication consists of two recoverable writes under a lock: publish the complete immutable order, then atomically replace the active pointer. These are not one filesystem transaction. Validate final status, identity, provenance, relevant source identities, PR mode, allowed transition, complete DHA declaration, and absence of unresolved finalization fields before publishing. Draft material marked DRAFT UNTIL STRATEGIC RECONCILIATION is not executable authority. A dry run performs these checks without writing. Complete an identical interrupted unresolved publication when appropriate; never reactivate a historically completed order.

Signal only after the intended durable state exists. Each FIFO notification is exactly two ASCII bytes OK (hex 4f 4b), with no newline. For example, a sender uses printf 'OK' to write the payload to its already validated pipe. This differs from the active pointer's trailing LF. Notifications carry no ID, status, or JSON; durable state provides correlation.

Handle partial reads/writes, EOF, invalid framing, interruptions, duplicate notifications, and sender descriptor closure. Exactly one wrapper consumes the coding control notification before launching the fresh coding invocation. The model must not wait again for a consumed notification. Prevent duplicate wrappers and competing consumers; idle waiting happens outside inference, with no periodic model calls to discover work.

A signal is neither durable truth nor authenticated authority. It cannot override contradictory active-order, report, PR, or remote state. OK means a published handoff is ready for examination, not that implementation succeeded or was accepted.

D.4 PR, report publication and strategic review

The existing implementation-SHA/report-only distinction in §13.3 has the following concrete sequence in this profile:

  1. Reconcile compact governance, the exact active order, and current repository state.
  2. Implement, verify, document, and perform any exact ordered CRITICAL append.
  3. Commit and push all non-report work, preserving authorized order/pointer bytes.
  4. Create or amend the objective PR before composing its final report.
  5. Resolve safe in-scope CI issues and capture the literal full implementation commit ID.
  6. Write the immutable report with the two fields shown below.
  7. Commit only that report, with the implementation commit as first parent, and push it.
  8. Verify remote PR identity, report bytes, current head, parent, and report-only changed-path invariant.
  9. Send the completion notification and stop mutating that round.
Implementation head SHA: <literal full implementation commit ID>
Report publication commit: SELF

SELF denotes the report-containing commit; it avoids pretending that a commit can embed its own future hash. Validate object identities against the repository's actual object format, rather than assuming an abbreviated hash is sufficient.

A report can describe CI already observed at the implementation head. It cannot certify its own future push or future report-head CI. Post-publication checks belong in a separate execution receipt and strategic review, not retrospective edits to the immutable report. Properly published PARTIAL, BLOCKED, and FAILED reports may notify strategy. Failed or unverified report publication must not emit a misleading completion signal.

Strategy independently reviews the diff, relevant rounds, implementation/report provenance, meaningful tests, documentation, judgment debt, and every required check at the exact reviewed current head. A changed head requires renewed review; use expected-head protection when available and verify the actual remote merge result. If the chosen merge method rewrites the default-branch graph, preserve original PR/report-publication evidence instead of pretending those identities survived unchanged.

Before enabling delegated merge, inspect actual merge-triggered automation under §7.3. A permitted development merge must not accidentally deploy to production or widen exposure. Operational configuration cannot supply missing human authority.

D.5 Recovery without replay

This table implements the logical continuity law in §5.2 and Chapter 1; it does not introduce a new objective whenever a process disappears.

Observation Recovery
No active order Stay inactive or wait outside inference; do not invent work.
Control consumed, process died, no final report Reconcile and resume unfinished work in the same order and branch/PR.
First round already created a PR Verify and reuse that PR.
Report pushed, completion notification lost Resume strategic review; do not rerun implementation.
Report local only or remote publication unverified Complete/verify publication without rewriting the report or claiming remote success early.
Order published, pointer update interrupted Complete only the identical unresolved transition; otherwise preserve the conflict for reconciliation.
Duplicate notification Check durable state and prevent duplicate execution.
Process/model/provider/context/machine changed Reconstruct the same logical role and objective without renumbering.
CI pending Wait/recheck evidence; delay is not a new objective.
Human deliberately quit Stop owned activity cleanly; no automatic resurrection.

Private execution metadata can help recovery but cannot override the remote repository and OAP transcript. For diagnosis, find the first reproducibly failing boundary and run the smallest discriminating experiment with a stop condition, as in Chapter 1 §10.7. Preserve observations and explicitly supersede interpretations; do not rewrite historical reports to match a later explanation.

D.6 Mechanical DHA safeguards

The five-condition admission threshold (§8.4), exact NONE/APPEND declarations (§8.5), strategic authorship (§13.3), four human dispositions (§8.7), and selective register loading (§8.9) remain authoritative. The reference profile adds these implementation checks:

  • A new seed contains policy and zero real entries. Keep examples fenced or in separate templates; parsers ignore fenced examples. An existing register and outstanding gates survive materialization unchanged unless a particular append was explicitly authorized.
  • Publication validation rejects missing fields, malformed declarations, mismatched payloads, or absent attestation. It cannot prove that the five conditions are substantively true; strategy remains responsible.
  • Define payload extraction and digest conventions, stable IDs, trusted prior state, duplicate detection, locking, and idempotent identical-retry behavior. Preserve prior bytes. Separate evidence/mitigation appends from admission of a new D1 judgment; neither silently clears a gate.
  • Use actual PR provenance. If a PR number does not yet exist, a safe prerequisite PR and same-PR continuation must establish a complete exact entry before development acceptance of the provisional choice. Coding does not fill strategic placeholders itself.
  • Human attribution needs a recording path distinct from agent append permissions. A Markdown name or checksum alone is insufficient, and unverified attribution remains blocking. This obligation does not prescribe an authentication product.
  • Only the latest attributable human ACCEPTED clears the registered scope. REJECTED, CHANGE REQUIRED, and DEFERRED remain blocking. Mitigation, supersession, ICA, and CI are evidence, not human disposition or separate deployment authorization.

Appendix E: Governance projection and context-budget example

E.1 Traceability and semantic review

The reference profile records three complementary artifacts:

oap/governance/DISTILLATION-MAP.md
oap/governance/CONTEXT-BUDGET.md
oap/governance/MANIFEST.json

The distillation map identifies each full-source path, revision, section, and obligation, then its compact clause or an explicit reason it is not executor-applicable. The following are examples, not evidence that a generated projection has passed review:

Full-source obligation Executor projection Assessment
Coding must never merge or enable auto-merge. C-AUTH-01 Preserve the prohibition's strength.
Strategy authors the exact approved CRITICAL append. C-DHA-02: append exact ordered bytes; report candidates only. Preserve executor duty; strategic admission judgment remains outside coding authority.
Full architecture defines a protected data boundary. A-DATA-01 and actual source requirement reference. Preserve the project's conditions, exceptions, and failure behavior.
Strategy evaluates competing future milestones. No coding clause. Not executor-applicable; retained in full strategic law.
---
config:
  flowchart:
    useMaxWidth: false
---
flowchart TB
    F["Full governing sources"] -->|Deliberate derivation| P["Executor projections"]
    P --> M["Mapping and context checks"]
    P --> S["Semantic review"]
    A["Approved governance changes"] --> R["Controlled refresh"]
    R --> F
    R --> P
    H["Human scope and full architecture"] --> I["Independent Closure Audit"]
    E["Current implementation evidence"] --> I

Scripts can verify identities, references, declared coverage, sizes, and syntax. They cannot prove semantic equivalence, correct D1 classification, genuine human authorization, or audit independence. Semantic review must examine obligation strength, authority, scope, conditions, exceptions, ordering, failure behavior, verification, and escalation. The generator's own second pass is self-review, even if useful; it is not independent review.

E.2 Illustrative budgets and honest measurement

These are illustrative planning defaults from prompt Version 1.0, not a universal OAP standard, a byte-to-token conversion, or a measured performance result:

Component Target model tokens UTF-8 byte ceiling
Root router 400 2,048
Dense coding constitution 2,200 12,000
Compact architecture 3,800 20,000
Compact coding communication 1,800 10,000
Complete routine coding governance set, excluding current order and code 10,000 50,000

Measure the complete transitive set, not just these filenames: include applicable security/testing and inherited instructions, mandatory indirect reads, and repeated injection. Do not assume client deduplication. A compact source cannot hide a requirement to load the full architecture every normal coding turn.

Report exact UTF-8 bytes. Report exact model tokens only with an identified suitable tokenizer and its version/configuration; otherwise record UNMEASURED. Character-count estimates are not exact token measurements. Even exact text tokens do not measure total provider request overhead unless the complete request was measured.

Projects may justify different budgets. Exceeding a target calls for redistillation, restructuring, or explicit adjustment, never truncation of law. Record the actual client discovery/inheritance behavior separately from fake-client invocation tests.

E.3 Four integrity domains

Domain What is checked or preserved
Immutable package sources Original input/package digests, extraction fidelity, snapshot identity.
Current canonical governance and projections Accepted source revision, mapped projection identity, authorized candidate changes, consistency.
Installed strategic copies Correspondence to the versioned source and controlled refresh without erasing private state.
Evolving orchestration and CRITICAL Authorized transitions, append/history integrity, publication evidence, human dispositions; not perpetual equality with a seed.

Define manifest coverage without a circular requirement that the manifest contain its own checksum. A changed expected digest is not authority to change a source. Compare candidate governance against the accepted base and explicit change scope; do not require an authorized candidate to have the old digest. After acceptance, refresh affected installed copies at a quiescent checkpoint while retaining private configuration, drafts, handoffs, and history. A legitimate register append changes its live bytes and must not fail solely for differing from the initial seed.


Appendix F: Bootstrap validation and handoff checklist

This appendix describes checks that an implementation of the reference profile must perform. A documentation build does not execute them, and documenting them is not evidence that a real bootstrap, client, or product has passed.

F.1 Separate readiness and evidence layers

Evidence layer Success establishes It does not establish
Input package checks Coherent inventory, preserved inputs, paths, checksums, links, extraction. Executable helpers or target-machine behavior.
Materialized bootstrap/helper verification Orchestration behaves as tested in declared fixtures. Actual-client behavior, remote permissions, or untested production safety.
Operational activation readiness Required client/model/authentication/remote/runtime setup and authority exist. Product implementation or objective acceptance.
Product/runtime qualification Named behaviors work at tested boundaries and revision. Complete architecture coverage or human release authorization.
Milestone and target-gate acceptance ICA, applicable human judgment, evidence, and authorization satisfy declared scope. Approval for other environments, data classes, or exposure.

A scaffold may pass its installation checks and remain blocked for activation. Report functional completion, evidence confidence, uncertainty reduction, and technical-debt reduction separately where useful. Objective counts, effort, token volume, and setup tests do not measure product completeness.

F.2 Executable verification contract

Use positive and negative tests with disposable repositories, fake agent executables, fake remote/CI interfaces, temporary FIFOs, and isolated terminal sessions. Test timeouts are finite even where operational idle waiting is intentionally indefinite. Cleanup is confined to test-owned resources.

Test group Required profile coverage
Input and filesystem Byte fidelity, inventory, safe extraction, non-nested roots, types/symlinks/ownership, spaces/Unicode, worktrees, existing-state preservation.
Rerun/refresh No-write dry run, identical no-op rerun, backed-up scoped refresh, no hidden activation.
Roles/context Correct routes and homes; unknown/conflicting roles cannot mutate; inspection does not switch role; compact transitive set; full strategic law; stale projections detected.
Orders/signals Refuse drafts and incomplete identity/provenance/DHA; immutable publication; interrupted writes; exact FIFO framing; one consumer; no idle inference; duplicates.
PRs/reports Same-PR corrections and interrupted first-round reuse; suffix progression; literal implementation identity; report-only SELF parent; local/remote distinction; no future CI claims.
CRITICAL/gates Exact ordered appends, prior-byte preservation, duplicate IDs, locks/retries, ignored fenced templates, four dispositions, latest attributable human acceptance and gate scope.
Setup/operation Setup accessible without credentials; operational prerequisites enforced; correct roots/homes; explicit quit; duplicate prevention; owned-resource cleanup.
Recovery/review Lost/consumed signals; local/published reports; no replay/renumbering; current-head checks, changed-head re-review, merge side effects, verified remote result.
ICA/claims Actual architecture/revision requirement matrix, honest classifications and freshness, repeat audit after remediation, no self-review labeled ICA.
Privacy/isolation No secrets/private content in artifacts or logs; no product-service invocation or protected infrastructure changes.

A fake-client fixture proves the configured invocation contract, not actual instruction discovery by every client. Safely qualify the installed client separately, recording its version and behavior. Do not silently select another model/provider or present unrun live checks as successful. Such qualification remains distinct from product behavior.

F.3 Receipt and inactive handoff

The bootstrap writes BOOTSTRAP-RECEIPT.md in the temporary input directory. It records:

  • resolved destinations and source identities;
  • created, unchanged, backed-up, conflicting, and preserved files;
  • projection identities, transitive byte/token measurements, semantic review and its limits;
  • substantive objective drafts and requirement coverage;
  • exact executed commands, outcomes, fixtures, and actual-client qualification;
  • preserved CRITICAL state, outstanding authority/configuration prerequisites, and inactive-state evidence;
  • confirmation that no product work or operational activation occurred.

Use PASSED, FAILED, SKIPPED, NOT RUN, BLOCKED, PENDING, or MISSING truthfully. Only an actually executed successful check is a pass. No fictional PR, remote state, token count, test result, approval, or milestone evidence may fill a gap.

Before handing over a new installation, verify the following; for an existing one, record preserved operational state and its explicitly scoped transition instead of resetting it:

  • Package sources and accepted governance/projections reconcile.
  • Tested helpers, role routing, context measurements, and semantic-review limits are recorded.
  • No active pointer, activated order, fabricated report/review, control signal, or running operational role exists.
  • Configuration gaps remain visible and setup shells remain accessible.
  • Activation requires separate authority plus current source/runtime/remote checks.
  • ICA materials contain project-derived requirements with honest initial states.

The ICA matrix ties each requirement/source to enforcing code/runtime paths, tests including negative paths, limitations, and the exact audited merged revision. Its classifications are IMPLEMENTED, PARTIAL, ABSENT, and UNPROVEN. Record auditor/context provenance and evidence freshness; full source scope governs the audit rather than the draft queue. Reassess relevant later changes and repeat ICA after closure remediation. Neither the generator's self-review nor the bootstrap receipt supplies this milestone acceptance.


References

  1. Janez Perš, Orchestrated Agentic Programming Manual (EN), Version 1.0.1, 2026.
  2. UL FE LMI, slaif-agent-site/CRITICAL.md, operational critical review queue for autonomously merged PRs.
  3. SLAIF weekend concentrated-OAP field transcripts: Agent-Site reaches MVP complete, exported 23 August 2026.
  4. SLAIF weekend concentrated-OAP field transcripts: API Gateway nears SLAIF MVP completion, exported 23 August 2026.
  5. SLAIF weekend concentrated-OAP field transcripts: Context compaction, provider replacement, and process recovery branches, exported 23 August 2026.
  6. Concentrated OAP — Reusable Bootstrap-Package Generator Prompt, Version 1.0. Implementation resource for the optional profile described here; see §17.1 for usage.