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 |