Architecture Decision Records
An Architecture Decision Record (ADR) captures one significant decision — the context, the choice made, and its consequences — so the reasoning lives in the repo alongside the code. Decisions are immutable once accepted: to change one, add a new ADR that supersedes it.
Creating an ADR
Section titled “Creating an ADR”docslime add adr <short-slug>This creates the next-numbered record, e.g. 0001-<short-slug>.md. Fill it in, then add a row to the log below.
Status values
Section titled “Status values”- Proposed — under discussion.
- Accepted — decided and in effect.
- Superseded by ADR-NNNN — replaced by a later decision.
- Deprecated — no longer relevant.
Decision log
Section titled “Decision log”| ADR | Title | Status | Date |
|---|---|---|---|
| 0001 | Docs-first feeling context | Accepted | 2026-07-21 |
| 0002 | Skill source copied to provider directories | Accepted | 2026-07-21 |