Architecture Decision Records — project

This directory contains Architecture Decision Records (ADRs) for project.

Format

Each ADR is a numbered Markdown file: NNNN-short-title.md

Use npx forgecraft-mcp generate_adr (or the generate_adr MCP action) to create a new ADR with automatic sequencing and the standard MADR template.

Status values

• Proposed — under discussion
• Accepted — decision taken, implementation may be pending
• Superseded by ADR-NNNN — replaced by a later decision
• Deprecated — no longer relevant

Why ADRs?

Every non-obvious architectural choice must be recorded with context, alternatives considered, and consequences accepted. Without this record, the team re-litigates the same decisions and AI coding assistants cannot reason about past choices.

---

This README was generated by ForgeCraft scaffold. Replace it with your first ADR.