Architecture¶
Assay is a governance and evidence platform for AI agents, built as a Rust workspace.
Structure¶
- Crate Structure — workspace organization and module layout
- Data Flow — trace → gate → evidence pipeline
- Split Refactor Plan (Q1-Q2 2026) — wave-by-wave execution plan
- Split Refactor Report (Q1 2026) — verified closure and LOC outcomes
Active RFCs¶
| RFC | Status | Summary |
|---|---|---|
| RFC-001: DX/UX & Governance | Active (Wave A/B merged, Wave C gated) | Design invariants, debt inventory, execution plan |
| RFC-002: Code Health Remediation | Complete (E1–E4 merged, E5→RFC-003) | Store, metrics, registry, comment cleanup |
| RFC-003: Generate Decomposition | Complete (G1–G6 merged) | generate.rs split into focused modules |
| RFC-004: Open Items Convergence | Active (O1–O5 closed, O6 pending) | Remaining structural items after RFC-002/003 |
Architecture Decision Records¶
See the full ADR index for all accepted and proposed architecture decisions.
Key ADRs: - ADR-003: Gate Semantics — Pass/Fail/Warn/Flaky - ADR-006: Evidence Contract — schema v1 - ADR-014: GitHub Action v2 — CI integration - ADR-015: BYOS Strategy — bring your own storage
Reference¶
- Code Analysis Report — finding snapshot (remediation tracked in RFCs)
- Pipeline Decomposition Plan — run/ci shared pipeline design