# v0.2 Operating Model

v0.2 turns the foundation into an executable engineering control loop.

```text
Human / lead agent
  -> SDD artifacts
  -> traceability validation
  -> frozen TaskContract + SHA-256 seal
  -> Graphify before snapshot (when available)
  -> worker executor
       - Paseo -> OpenCode (default control-plane mode)
       - Podman -> OpenCode (direct sandbox mode)
  -> deterministic validation registry
  -> structured repair packet on failure
  -> bounded repair attempts
  -> final ValidationReport + run artifact
```

`aeh run TASK-ID` executes that flow. Architecture/requirements remain owned by the lead agent; workers only implement the frozen contract.

## Traceability

A requirement is valid only when its canonical ID appears in `proposal.md`, `spec.md` as an `### ID` heading, `design.md`, `acceptance.feature` as `@ID`, `tasks.yaml`, the TaskContract and at least one known validator reference.

## Executable acceptance

`adapter: bdd` resolves a configured or detected `BddExecutionProvider` and
normalizes runner output. Reqnroll is available only as an optional .NET
compatibility provider; generic Gherkin validation has no `.csproj`, Reqnroll or
`dotnet test` assumption.

## Worker execution

Paseo mode preserves mobile/remote visibility and cross-provider orchestration. Direct Podman mode provides a stronger process boundary but is intentionally a separate execution mode; the harness does not claim Paseo itself is a container security boundary.

Paseo also supports custom provider binaries, so advanced users can point a Paseo provider at their own wrapper/container strategy outside the harness.

## Repairs

Each failed deterministic check becomes a machine-readable repair packet. The worker receives only failing evidence and is asked for the smallest correction. The loop terminates after the configured budget.

## Hard gates

Built-ins: Graphify, Opengrep, Trivy, Playwright, OpenAPI, Pact/custom command and Gherkin. Graphify refresh is not fabricated by the harness: the harness consumes `graphify-out/graph.json`, refreshed through Graphify's skill or a project-specific command.
