70-docs/60-decisions/README.md

Architecture Decision Records (ADRs)

Each major technical or product decision is captured as a single ADR using a lightly adapted Michael Nygard template: Status · Context · Decision · Alternatives · Consequences · Revisit-at-scale.

ADR numbers map 1:1 to the original D-NNN entries that lived in the legacy 70-docs/decisions.md (now split into individual files for easier review, citation, and supersession tracking).

Index

#	Title	Status
ADR-001	Vertical slice scope, not full platform	Locked
ADR-002	Health as the v1 vertical category	Locked
ADR-003	Curated corpus over user-uploads	Locked (partially superseded by ADR-044)
ADR-004	Hybrid structured + vector retrieval	Locked
ADR-005	Next.js 14 + FastAPI (superseded original Streamlit pick)	Locked (revised)
ADR-006	Sarvam-first STT/TTS/LLM defaults	Partially superseded by ADR-019
ADR-007	Illustrative pricing, not real-time quotes	Locked
ADR-008	Consultative-advisor persona	Locked
ADR-009	19 insurers × all health policies; 48-field schema	Locked (historical scope; current 21/148)
ADR-010	Secret handling: .env chmod 600, gitignored	Locked
ADR-011	Local BGE-small embeddings (Voyage was original)	Locked
ADR-012	Render → HF Space migration	Superseded
ADR-013	Tailwind CSS + shadcn/ui	Locked
ADR-014	Groq Llama-3.3-70B grader	Superseded by ADR-019
ADR-015	REST + openapi-typescript codegen	Locked
ADR-016	Hybrid brain router (Sarvam + fallback)	Superseded by ADR-019
ADR-017	IRDAI regulatory corpus deferred → Playwright rescue	Locked
ADR-018	Chunk-size sweep deferred; 800/120 baseline	Deferred to v2
ADR-019	NVIDIA NIM as single non-Sarvam provider	Locked
ADR-020	Code in Space repo, data in companion HF Dataset	Locked
ADR-021	View-aware system prompt (D-020-frontend copilot)	Locked
ADR-022	Conversational profile updates via LLM extractor	Locked
ADR-023	Admin panel IP-gated; surfaced as in-app tab	Locked
ADR-024	Triple-mirror: HF + GitHub + local for both code and data	Locked

How to add a new ADR

1. Pick the next number (ADR-025).
2. Copy the template from any existing ADR (Status / Context / Decision / Alternatives / Consequences / Revisit-at-scale).
3. Status starts at Proposed; flip to Locked when implemented, Superseded when replaced.
4. Add a row to this index.
5. If superseding an older ADR, edit that ADR's status to Superseded by ADR-NNN.

Why split this from decisions.md?

The legacy 32 KB decisions.md accumulated decisions chronologically. As the project grew, reviewers couldn't find the current state for a given concern without reading every entry in order. Per-decision files give each ADR a permanent URL, allow supersession tracking, and let new decisions land without merge conflicts in a giant monolithic file.