Decisions
One file per decision: what was decided, by whom, why, and what was rejected. A decision is replaced only by a new one that says so. Status: accepted, concept (an idea grown into a concept with specifications of its own, not yet scheduled), proposed, replaced by NNNN.
| ADR | Decision | Status |
|---|---|---|
| 0001 | Plugin-first: almost every component is an interface | accepted |
| 0002 | A plugin is a crate built into the local build, selected in config | accepted, amended by 0015 |
| 0003 | API-key auth shipped; no subscription login shipped | accepted |
| 0004 | Platform behind interfaces; a WebAssembly build of the CLI on the site | accepted |
| 0005 | A new, self-contained repository; the memory backend is carried over | accepted |
| 0006 | Anthropic API, OpenAI-compatible and local models from v1 | accepted |
| 0007 | After the MVP: proof, memory-based context, rewind and branches, agent mesh | accepted |
| 0008 | The name is harness-multitool | accepted |
| 0009 | Callbacks are triggers: notification, skill, journal | accepted, amended by 0015 |
| 0010 | Hook runs are events, and frontends show every one | accepted |
| 0011 | Mind maps and flowcharts are separate tools | accepted |
| 0012 | Flowcharts are live: flowstate_update callbacks, runs, run history | accepted, open to additions |
| 0013 | Step-debug mode: charts, callbacks and a debug router the agent builds in the target project | accepted, open to additions |
| 0014 | Reliability-monitoring mode: metrics, SLOs and a response policy per event | concept |
| 0015 | Callback handlers are plugins: one interface for the standard and custom types, plugged in through the TUI's settings | accepted |
| 0021 | How the agent behaves: plan first, then the mode the work needs | accepted |
| 0022 | Moving a Claude Code conversation onto the harness | accepted |
| 0023 | The log is the conversation; each provider's form is written from it | accepted |
| 0024 | Conversations live in the daemon | accepted |
| 0025 | One conversation in every form | accepted |
| 0026 | Profiles: every setting, and each window's sign-in | accepted |
| 0027 | Windows talk to the daemon over a local socket | accepted |
| 0020 | Claude Code as a delegate agent, in the default build | accepted (Q-33 settled, 2026-11-19) |
| 0019 | A subscription sign-in ships where the vendor documents it for other apps | accepted |
| 0016 | Plan mode: the classic plan mode with the accent on the journal, mind maps and flowcharts | accepted |
| 0017 | Project initialization (docs tree + .harness/); documentation mirrors the journal, mind maps and flowcharts | accepted |
| 0018 | Generated documentation like rustdoc: a linked HTML site and a PDF from the docs, maps and charts | proposed (an idea) |
| 0028 | Journal todos become issues in a tracker, GitHub first, per project | accepted (journal#971); built: journal#990, journal#993 |
| 0029 | Games between agents on the daemon, Texas hold'em first, with a dashboard | accepted (journal#971); built: journal#995, journal#998 |
| 0030 | Skills of the harness's own (.harness/skills), the same on every adapter | accepted (the owner's standing approval, journal#971) |
| 0031 | Custom callbacks are project handlers: Rust programs in .harness/callbacks, per conversation | accepted (the owner, 2026-11-19) |