Team-shared ADRs for the ultimate-pi harness live under .pi/harness/docs/adrs/.
| ADR | Title | Status |
|---|---|---|
| 0001 | Harness constitution | Accepted |
| 0002 | HarnessRunRecord canonical trace | Accepted |
| 0003 | Eval promotion gates | Accepted |
| 0004 | Defer CI agent smoke | Accepted (deferred) |
| 0005 | Defer PostHog analyst skill | Accepted (deferred) |
| 0006 | Sentrux dual-layer trust | Accepted |
| 0007 | Interactive drift monitor | Accepted |
| 0008 | Harness PostHog telemetry | Accepted |
| 0009 | Sentrux rules.toml lifecycle | Accepted |
| 0030 | In-house VCC compaction (vendored pi-vcc) | Accepted |
| 0031 | Harness active run context | Accepted |
| 0032 | Harness commands as agent orchestrators | Accepted |
| 0033 | Parent-orchestrated harness planning | Accepted |
| 0034 | Darwin plan research pipeline | Accepted |
| 0035 | Plan-phase Review Gate | Accepted |
| 0036 | Implementation research and selective debate | Accepted |
| 0037 | Subagent submit tools (subprocess extension) | Accepted |
| 0038 | Budget caps telemetry-only by default | Accepted |
| 0039 | /harness-review master post-run gate |
Accepted |
| 0040 | Practice-grounded orchestration & team topology | Accepted |
| 0045 | Harness-lens minimal contract (edit safety, LSP, deferred format) | Accepted |
| 0041 | Intelligent planning reconnaissance (tools over tool-scouts) | Accepted |
| 0042 | Agent-native orchestration (lakes, plan-verify probes, synthesizer) | Accepted |
| 0043 | Path-first harness tool contracts | Accepted |
| 0044 | Post-run steer loop (repair vs plan revise) | Accepted |
| 0045 | Phase-scoped harness agent directories | Accepted |
| 0046 | AGT policy engine + subagent identity | Accepted |
| 0047 | AGT layered security (rings, prompt defense, CI) | Accepted |
| 0048 | tool_call hook interaction matrix | Accepted |
| 0049 | agents.policy.yaml SSOT + native discovery | Accepted |
| 0050 | Agentic Web Retrieval Stack (WRS) | Accepted |
| 0051 | Hash-anchored read/edit (Dirac-inspired) | Accepted |
| 0052 | Sentrux structured repair (OSS diagnostics) | Accepted |
| 0052 | ls-lint naming lifecycle | Accepted |
| 0053 | Plan-phase task clarification gate | Accepted |
| 0054 | Harness-native ask_user + Glimpse presenters | Accepted |
| 0055 | Auto-commit co-author + message format lifecycle | Accepted |
| 0056 | Agent-native speed wiring | Accepted |
| 0057 | Fast steer completion (split verdict, hygiene, burst) | Accepted |
Phase-to-practice mapping for slash commands: practice-map.md.
Use template.md for new ADRs. Number sequentially (0010-...).