Architecture Decision Records¶
Formal records of significant design decisions made during ExecutionKit's development. Records follow the MADR template.
Records¶
| ADR | Decision | Status | Date |
|---|---|---|---|
| ADR-001 | Structural protocols over ABC | Accepted | 2026-05-11 |
| ADR-002 | Flat package layout over src/ | Accepted | 2026-05-11 |
| ADR-003 | Single OpenAI-compatible Provider over adapter matrix | Accepted | 2026-05-11 |
| ADR-004 | Zero runtime dependencies; httpx as optional extra | Accepted | 2026-05-11 |
| ADR-005 | Caller-supplied cost rates over built-in price table | Accepted | 2026-05-22 |
| ADR-006 | Curated failure-corpus eval methodology | Accepted | 2026-06-08 |
| ADR-007 | Async-first design with sync wrappers | Accepted | 2026-05-22 |
| ADR-008 | Caller-supplied checkpoint function for workflow resume | Accepted | 2026-06-18 |
| ADR-009 | Three-option timeout policy for ApprovalGate | Accepted | 2026-06-18 |
| ADR-010 | importlib probe for optional OpenTelemetry integration | Accepted | 2026-06-18 |
| ADR-011 | gather_strict map phase with single reduce call | Accepted | 2026-06-18 |
| ADR-012 | Stdlib-only stdio MCP server inside the package | Accepted | 2026-07-02 |
| ADR-013 | Claude-in-CI eval tier via headless CLI | Accepted | 2026-07-02 |
| ADR-014 | Anthropic Message Batches fan-out via stdlib HTTP | Accepted | 2026-07-03 |
| ADR-015 | react_loop tool-execution sandbox contract | Accepted | 2026-07-03 |
Format¶
Each ADR file is named NNN-short-title.md and follows the
MADR template. Status values:
Proposed -> Accepted / Deprecated / Superseded.