Harness Contract and Lifecycle
Harness Contract and Lifecycle
Fact-check status
Key jargon
| Term | Plain-language meaning |
|---|---|
| Contract | An explicit agreement about inputs, outputs, errors, permissions, and invariants. S1 |
| Lifecycle | The stages from request admission through completion, cancellation, or recovery. S1 |
| Invariant | A condition that must remain true at every relevant stage. S1 |
| Version pin | A recorded dependency, prompt, model, schema, or policy version used for a run. S1 |
Key concepts
- The lifecycle should make every state transition and terminal outcome explicit. S1
- Contracts let evaluation target the complete system instead of treating a fluent response as success. S1
Concept map
flowchart LR
A["Admit validated request"] --> B["Execute versioned lifecycle"]
B --> C["Enforce invariants"]
C --> D["Close with result and evidence"]Diagram semantics verified against S1 and S2 on 2026-09-02.
Lifecycle
- Scope: user, task, harm, data, action, and stop boundaries. S1
- Baseline: representative examples and current non-AI performance. S1
- Prototype: smallest prompt/model/workflow that can test value. S1
- Evaluate: quality, safety, latency, cost, and subgroup behavior. S1
- Harden: permissions, isolation, validation, recovery, and logging. S1
- Pilot: limited users/data/actions with rollback. S1
- Operate: monitoring, incidents, versioning, and human escalation. S1
- Change: regression gates for model, prompt, tool, retrieval, or policy. S1
- Retire: revoke access, handle memory/data, preserve required evidence. S1
Harness contract
Write down purpose, non-goals, owner, users, data classes, models, tools, memory, action inventory, evaluation suite, budgets, approval gates, incident owner, retention, and retirement trigger. S1
Definition of done
A demo that produces a good answer is not production readiness. Done means the system meets a documented contract on representative tests and fails within known boundaries. S1
Dumpster-derived lesson
The local research repeatedly supports artifact-backed, stage-level evaluation: fluent final output must not substitute for trace, state, or effect evidence. S1