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
- ADR-032 Implementation Overview (Q2 2026) — current MCP policy stack on
main - ADR-032 Building Block View (Q2 2026) — structural decomposition of the MCP policy stack
- ADR-032 Quality Scenarios (Q2 2026) — explicit quality attributes and review scenarios
- ADR-032 Structurizr Workspace (Q2 2026) — bounded architecture-as-code workspace and C4 model
- ADR-032 Obsidian View Layer Recommendations (Q2 2026) — recommended internal view-layer setup
- ADR-032 Documentation Maturity Gap Analysis (Q2 2026) — current-state gap analysis and follow-up posture
- ADR-032 Execution Plan (Q2 2026) — MCP policy/obligation rollout status
- Assay Architecture & Roadmap Gap Analysis (Q2 2026) — repo-wide truth sync and next-step ordering
Active RFCs¶
| RFC | Status | Summary |
|---|---|---|
| RFC-001: DX/UX & Governance | Historical (Wave A/B delivered; Wave C remains data-gated) | Normative DX/refactor invariants and historical execution framing |
| 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 | Closed (O1–O6 merged on main) | Historical closure ledger for the Q1 convergence line |
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 - ADR-032: MCP Policy Enforcement v2 — typed decisions + obligations + evidence
Reference¶
- Code Analysis Report — finding snapshot (remediation tracked in RFCs)
- Assay Architecture & Roadmap Gap Analysis — repo-wide truth sync across architecture and roadmap
- Pipeline Decomposition Plan — run/ci shared pipeline design