Architecture Decision Records for KLMS. Each ADR captures a binding design or governance choice.
| ID | Title | Status | Date | Supersedes |
|---|---|---|---|---|
| ADR-0001 | Agents are Markdown subagents | Accepted | 2026-05-30 | — |
| ADR-0002 | Versioned preservation archive (first/latest/milestones + checksums) | Accepted | 2026-05-30 | — |
| ADR-0003 | Two entry points only (ideation spec / direct chat) | Accepted | 2026-05-30 | — |
| ADR-0004 | Parallel, integrated money + AI-usage ledgers | Accepted | 2026-05-30 | — |
| ADR-0005 | Promote the working branch to main |
Accepted | 2026-05-30 | — |
| ADR-0006 | Intranet as a lean static portal (Astro, local-first) | Superseded by ADR-0008 | 2026-05-30 | — |
| ADR-0007 | Tool the Archivist with GitHub (least privilege) | Accepted | 2026-05-30 | — |
| ADR-0008 | Deploy the intranet to Vercel behind single-user auth | Accepted | 2026-05-30 | ADR-0006 |
| ADR-0009 | Limit Vercel deployments | Accepted (amended by ADR-0022) | 2026-05-30 | — |
| ADR-0010 | This repository is the template; ventures are created in clones | Superseded by ADR-0011 | 2026-05-30 | — |
| ADR-0011 | This repository is a real instantiated project (KLMS) | Accepted | 2026-05-30 | ADR-0010 |
| ADR-0012 | Solo-owner merge policy: zero required approvals | Accepted | 2026-05-31 | — |
| ADR-0013 | Learning platform frontend stack (Next.js 15 + shadcn/ui) | Accepted | 2026-05-31 | — |
| ADR-0014 | Neon + Drizzle as the shared data layer | Accepted | 2026-05-31 | — |
| ADR-0015 | Slack live chatter feed — Events API + Neon + client polling | Accepted | 2026-05-31 | — |
| ADR-0016 | Data-layer policy — when to use .md files vs. Neon | Accepted | 2026-05-31 | — |
| ADR-0017 | Slack chatter retention policy — Neon row lifecycle | Accepted | 2026-05-31 | — |
| ADR-0018 | Slack outbound agent posting — mechanism, channel allowlist, and guardrails | Accepted | 2026-05-31 | — |
| ADR-0019 | Slack autonomous agent routing — bidirectional conversation and multi-turn dispatch | Backlogged | 2026-06-02 | — |
| ADR-0020 | Icebox the venture (channel + learning platform) | Accepted | 2026-06-02 | — |
| ADR-0021 | KLMS is a live project and the canonical template source | Accepted | 2026-06-02 | — |
| ADR-0022 | Production-branch deploy gate — production branch only |
Accepted | 2026-06-08 | ADR-0009 |
New ADRs: copy ADR-0000-template.md, assign the next sequential ID, and add a row here.