Skip to content

Architecture decisions

Each decision is recorded once, with its context, the options considered and its consequences. A decision is changed only by a new record that supersedes it.

Record Decision Status
0001 One engine in Rust, thin adapters Accepted
0002 The issue tracker is the database of the plan Accepted
0003 An append-only, hash-chained ledger written by the engine Accepted
0004 No embeddings in the product Accepted
0005 English source, documentation in English and Italian Accepted
0006 Synchronous pure core, asynchronous runtime Accepted
0007 Files as the source, SQLite as a derived index Accepted
0008 Identifiers and traceability between artifacts Accepted
0009 Contract guidelines: envelope, errors and versioning Accepted
0010 One configuration file with layered precedence Accepted
0011 Executors behind an interface; no model calls in the core Proposed
0012 Approval gates are tracker states, not chat prompts Proposed
0013 One worktree per issue; lanes as the unit of parallelism Proposed
0014 Living specifications by capability with change deltas Proposed
0015 Index: tree-sitter symbols and SQLite full-text search Proposed
0016 Expert council: independent first round and structured report Proposed
0017 Generated issues are idempotent by stable identifiers Proposed
0018 Bindings through one JSON boundary Proposed
0019 Distribution channels and versioning Proposed
0020 Plugins and skills generated from one source Proposed
0021 Benchmark methodology Proposed
0022 Threat model: content is data, executors have least privilege Proposed
0023 Stability policy for 1.0 Proposed
0024 Tool definitions for agents: MCP and function calling from one source Accepted
0025 API executor for steps that do not edit code Proposed
0026 Process policy as registries, rules in the core and a ledger of results Proposed
0027 One standard and one source for skills, agents and hooks Proposed
0028 One contract on every channel, translation adapters and a channel reconciler Accepted
0029 Merge of small changes waived by policy, recorded as a waiver Accepted
0030 Contracts generated from Rust types, versioned snapshots with a history Accepted