Architecture decision register
CA-A1 architecture record. Updated: 2026-10-05. Stable CA-AD identifiers for architectural decisions already supported by accepted CA-R2/CA-R3 evidence. No database/framework/deployment technology is chosen.
| ID | Decision | Rationale | Evidence/Reqs | Consequences | Rejected/deferred | Reversibility |
|---|---|---|---|---|---|---|
| CA-AD-001 | Cicada Assemblies owns the governed lifecycle/record spine | the unserved layer identified in CA-R3 is exactly this; all institutions need it | CA-REQ-001/002; CICADA-GAPS | Cicada is system of record; external tools are channels | coordinator-of-platforms posture (Composition C) | high — record portability preserved by export |
| CA-AD-002 | Selection algorithms are external-first, not rebuilt | published peer-reviewed engine exists; no evidence for a new one | SELECTION-TECHNOLOGY; SRC-0145 | GPL-3.0 boundary must be architected; engine is replaceable behind CA-CONTRACT-SEL-001 | build-own-engine | moderate — adapter seam isolates |
| CA-AD-003 | Selection = governance spec → deterministic execution → witness bundle | corpus evidence: the ceremony is the institution, the maths is a component | CA-REQ-010–015; SRC-0083 | three artefacts always; engine pluggable | single-run-monolith model | structural, foundational |
| CA-AD-004 | Technical permission and institutional authority are separate objects | facilitator-can-edit ≠ may-set-agenda; corpus capture risk | CA-REQ-080–084 | every consequential write carries dual attribution | merged role model | structural |
| CA-AD-005 | Consequential events require dual attribution (actor + authority artefact) | makes authority gaps visible rather than silent | CA-REQ-080–083 | audit events heavier; divergence flagging built-in | single-attribution | structural |
| CA-AD-006 | Person and membership are distinct records | same person may serve multiple bodies/terms; privacy separation | CA-REQ-025/029 | two object classes; joins explicit | person-with-flags model | moderate |
| CA-AD-007 | Closed recommendations are immutable | receiving authority must not edit the record it answers | CA-REQ-055 | amendments are new versions | editable-with-history | structural |
| CA-AD-008 | Recommendation/response/acceptance/implementation are distinct objects and states | conflation is the corpus’s main accountability failure | CA-REQ-061–065 | four objects, visible non-response | merged “outcome” field | structural |
| CA-AD-009 | Non-selected respondent data gets stronger minimisation/retention | most sensitive silent data, no public role | CA-REQ-019; privacy classes | tightest retention class; deletion events recorded | uniform retention | policy-tunable |
| CA-AD-010 | Offline acts produce equivalent canonical events | digital exclusion is structural; corpus parity requirement | CA-REQ-071 | all event types have offline provenance path | online-only UX | structural |
| CA-AD-011 | External platforms are replaceable seams, not canonical owners | corpus landscape is fragmented; coupling risk real | CA-R3 compositions A–E | all external content arrives via cited imports w/ digest | canonical-in-external | moderate per-seam |
| CA-AD-012 | AI outputs are advisory/derivative; never institutional authority | CA-D007; authority-laundering risk | CA-REQ-084; INFOSCOPE-BOUNDARY | ai_artefact flag; no write path to canonical records | AI-assisted authority paths | structural |
| CA-AD-013 | Registers/frame data stay external by default | electoral data custody is a liability + legitimacy boundary | POPULATION-AND-INVITATION | Cicada holds descriptors/digests; imports are explicit per-field decisions | canonical-register model | per-deployment |
| CA-AD-014 | Institution/cycle/session are three distinct object classes | permanent-rotating institutions exist; cohort ≠ institution | CA-OBJ-001/003/018 | all lifecycle concepts attach at correct level | single “assembly” object | structural |
| CA-AD-015 | Multi-level membership arrives via uniform transition events | delegation and fresh draw are different provenance, same object | CA-REQ-090–092; SYNTHETIC-E | delegated vs drawn members distinguishable; representativeness not composed | separate objects per mechanism | moderate |
Conventions
CA-ADIDs are permanent — never renumbered; superseded decisions get asuperseded-bylink, not deletion.- New decisions append after CA-AD-015.
- Decisions marked
structuralare costly to reverse;moderate/policy-tunable/per-deploymentcan vary safely.