< Prev | Up: Session Overview | Next >

Session 6 — ADRs (Architectural Decision Records)

Goal: Verify all 30 ADRs are still valid. Flag any that need superseding or updating. Estimated time: 60 min

All ADRs live in docs/3-resources/decisions/. No index page exists — this session serves as one. Most are <150 lines.

By Domain

Tenant & Auth (read first)

ADR	Lines	Title
ADR-003	218	Tenant Provisioning
ADR-004	182	Tenant Isolation Strategy
ADR-005	273	Multi-Tenant JWT Session

Commerce & Pricing

ADR	Lines	Title
ADR-001	~100	Boarding Point Strategy
ADR-006	~120	Costing/Pricing Separation
ADR-009	~90	Booking Confirmed Trigger
ADR-010	~110	Input/Output VO Separation
ADR-011	~100	Input Rule Snapshotting
ADR-012	~80	TOMS Tax Deferral
ADR-013	~70	Seat Hold TTL Alignment
ADR-014	~80	Ticket Issuance Trigger
ADR-015	~90	Tax Ledger Entry Cardinality
ADR-030	174	Subscription Tier Gating
ADR-032	334	Collaborative Trip Planning

Operations

ADR	Lines	Title
ADR-007	~110	Crew/Fleet/Subcontracting
ADR-008	~90	Vehicle Maintenance Ownership
ADR-016	~130	Incident Lifecycle State Machine
ADR-017	~140	Offline Sync Protocol
ADR-018	~100	ServiceLeg Creation Ownership
ADR-019	163	Change Events / Audit Trail
ADR-021	135	Customer Intelligence Context

Infrastructure

ADR	Lines	Title
ADR-022	~110	Ubicloud Postgres Cutover
ADR-023	~120	Swarm Quorum Topology
ADR-024	~100	Swarm LB Strategy
ADR-025	~90	Swarm Manager Failover DNS
ADR-027	~130	Cardinality Budget Contract
ADR-028	~110	GDPR TTL Retention
ADR-029	~120	Secrets and Encryption
ADR-031	~140	Immutable Infrastructure Policy

Governance & Comms

ADR	Lines	Title
ADR-020	~150	Agentic Company Governance
ADR-033	388	Communication Decision Engine

🔍 What to Validate

• [ ] ADR-026 is missing (jumps 025 → 027). Was it deleted or never created?
• [ ] ADRs are supposed to be immutable. If any decision has changed, it needs a new ADR that supersedes the old one — check for any that feel outdated.
• [ ] ADR-012 defers TOMS tax to Phase 3. Is that still the plan?
• [ ] ADR-017 (offline sync) — does offline-sync-protocol.md reflect the decision?
• [ ] ADR-020 + ADR-021 describe future contexts — are they still aligned with the current vision?
• [ ] ADR-030 (subscription gating) — does it match PRODUCT_payments-and-billing.md?

🗺️ Mindmap & Path Optimization

Grab your pen and paper:

• [ ] Evaluate ADR Discoverability: If a developer asks "Why did we use JWT instead of sessions?", trace their path to ADR-005.
  • Observation: There is no central index connecting features to the decisions that shaped them.
  • Optimization: Should each schema-*.md file have an "Architectural Decisions" section linking directly to the relevant ADRs for that context?

📝 Findings & Actions

Severity	File / Topic	Issue & Optimization Potential	Action Required

---

< Prev | Up: Session Overview | Next >