adr

Architecture Decision Records

Decisions about Tamp's architecture, conventions, and governance live here. Each file is a single decision in MADR format.

Lifecycle

Status	Meaning
Proposed	Drafted, open for discussion. Subject to change before any code depends on it.
Accepted	The decision is current. New code should follow it.
Superseded	A later ADR overrides this one. Cross-link both ways.
Deprecated	No longer applies and has no successor (rare — usually superseded instead).

ADRs are append-only. Don't edit an Accepted ADR's substance after the fact — write a new one that supersedes it. Typo fixes and link repairs are fine.

Index

#	Title	Status
0001	Small core, plugin-driven architecture	Accepted
0002	Package naming convention	Accepted
0006	Repository layout: monorepo for core and first-party modules	Accepted
0007	License — MIT	Accepted
0009	Governance and namespace policy	Accepted
0015	Target framework strategy	Accepted

ADR numbers are stable and gap-allowed — they correspond 1:1 with the YouTrack tracking issues (TAM-N), so a deferred ADR keeps its slot until written.

Authoring a new ADR

1. Pick the next number from the YouTrack ADR list.
2. Copy an existing file as a starting shape; keep MADR section headings.
3. Open as Proposed until accepted; flip to Accepted and merge.
4. Update this index.