Architecture decisions
Index of Templiqx Architecture Decision Records (ADRs) — one record per significant, hard-to-reverse design choice, with its status and rationale.
Architecture Decision Records (ADRs) capture the significant, hard-to-reverse design choices behind Templiqx: what was decided, why, the alternatives weighed, and the current status. Each record is immutable once accepted — a later decision supersedes an earlier one rather than editing it. These are kept separate from the architecture pages, which describe the system as it is; ADRs explain why it is that way.
| ADR | Status | Summary |
|---|---|---|
| Package trust v1 | Accepted (2026-07-12) | Manifest signing model and the host-owned key handoff |
| Tool-contract references | Accepted (2026-07-12, design only) | Package-level tool_contracts table with compile-time $ref resolution |
Streaming RuntimeAdapter port |
Implemented (2026-07-12) | execute_streaming port method, StreamEvent contracts, deterministic mock replay |
| ODT compatibility | Accepted (2026-07-13, detect-only) | OpenDocument Text detection and migration scope; no render adapter in this slice |
| Document conversion | Proposed (2026-07-14) | PDF/converter adapters are host-constructed; entry criteria before implementation |
| Compiled-artifact cache | Proposed (2026-07-14) | Cache only after benchmark evidence; host/store-backed keys |
| Legacy template import | Proposed (2026-07-14) | Safe-subset legacy imports; helpers and dynamic partials unsupported |
| HTTP server release artifact | Accepted (2026-07-16) | Operations HTTP binary is local/demo only — not Cosign-signed |
| High-complexity Rust modules | Accepted (2026-07-16) | Track qlty monolith splits; no mass rewrite in readiness wave |
Conventions
- One file per decision, named for the decision (
package-trust.md), not for a ticket. - Status is explicit:
Proposed→Accepted/Implemented→Superseded by …. - Scope is stated up front — several ADRs here are design-only (accepted direction, implementation deferred). The status line says so.
See the POC architecture and capability map for the current system these decisions produced.