docs/adr/
Accepted architecture decision records (ADRs).
Start with ADR-0000: SF Is a Purpose-to-Software Compiler. 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.