singularity-forge/docs/adr/README.md
2026-05-06 00:38:36 +02:00

25 lines
836 B
Markdown

# docs/adr/
Accepted architecture decision records (ADRs).
Start with [ADR-0000: SF Is a Purpose-to-Software Compiler](./0000-purpose-to-software-compiler.md). It is the foundational product/architecture decision; later ADRs refine pieces of that contract.
## What belongs here
- Final, accepted architectural decisions that affect the project.
- Decisions that have been promoted from `.sf/DECISIONS.md`.
## What does NOT belong here
- Draft decisions still under discussion.
- Implementation plans (use `docs/plans/`).
- Specifications (use `docs/specs/`).
## Naming convention
`0001-<slug>.md` — zero-padded four digits, auto-numbered by `sf plan promote --to docs/adr`.
`0000-*` is reserved for foundational doctrine that later ADRs depend on.
## See also
- [AGENTS.md#sf-planning-state](../AGENTS.md#sf-planning-state)