Architecture Decision Records
Architecture Decision Records (ADRs) document significant architectural decisions made in the anchorpipe project. Each ADR captures a decision, the reasoning behind it, and the expected consequences.
How ADRs Are Organized
- Numbering: Sequential four-digit IDs (
0001,0002, ...) - Status:
Proposed,Accepted,Deprecated, orSuperseded - Location: ADRs live in
apps/docs/docs/reference/adr/(this directory) and are published automatically to the docs site
Index
| ID | Title | Status | Date |
|---|---|---|---|
| 0001 | Core Backend Stack (MVP BFF via Next.js; Rust/Go for Ingestion/Scoring) | Proposed | 2025-10-21 |
| 0002 | Messaging Selection (RabbitMQ MVP; Kafka/Redpanda Revisit) | Proposed | 2025-10-21 |
| 0003 | Database Sharding Strategy and Timing | Proposed | 2025-10-21 |
| 0004 | ML Serving for MCP (Explainable, Versioned, gRPC-first) | Proposed | 2025-10-21 |
| 0005 | CI Integration Authentication Strategy | Proposed | 2025-10-21 |
| 0006 | Web Entry Bundle Budget <100KB gz | Proposed | 2025-10-21 |
| 0007 | Ingestion Cutover Criteria (Rust/Go on Render) | Proposed | 2025-10-21 |
| 0008 | API Style — REST-first; GraphQL for Aggregates (If Justified) | Proposed | 2025-10-21 |
| 0009 | Search Engine — Postgres FTS + Trigram (MVP) | Proposed | 2025-10-21 |
| 0010 | Product Site CTAs — OSS-first Messaging | Proposed | 2025-10-21 |
| 0011 | Object Storage — S3-Compatible (MinIO Dev, Cloud S3 Prod) | Proposed | 2025-10-21 |
| 0012 | Privacy for failure_details (Redaction & PII Scrub) | Proposed | 2025-10-21 |
| 0013 | Code Organization — Server/Client Separation in Next.js App | Proposed | 2025-11-08 |
| 0014 | Test Database Strategy | Accepted | 2025-11-24 |
| 0015 | Redis-Based Rate Limiting | Accepted | 2025-11-25 |
| 0016 | Idempotency Strategy for Ingestion API | Accepted | 2025-11-28 |
| 0017 | Error Handling Strategy | Accepted | 2025-11-28 |
| 0018 | Observability Strategy | Accepted | 2025-11-28 |
Contributing
To create a new ADR:
- Copy the ADR template to a new file named
NNNN-short-title.md - Fill in status, date, deciders, context, decision, consequences, alternatives, revisit criteria, and references
- Link to related ADRs and issues
- Submit via PR with reviewers from the architecture group
- Update this index and the docs sidebar entry after the ADR is merged