Decision Log — Architecture Decision Records

Significant, cross-cutting decisions about the portal and the ecosystem are recorded here as ADRs. ADRs are append-only and immutable once accepted — to change course, add a new ADR that supersedes the old one.

• Template: templates/adr.template.md
• How to add one: update conventions → record a decision
• Numbering: NNNN-kebab-title.md, zero-padded 4-digit, never reused.

What warrants an ADR

• Portal structure / IA / navigation changes
• Naming or slug conventions
• Adding, merging, splitting, or sunsetting a venture
• Cross-repo standards (shared auth, shared data, shared capability ownership)
• Tooling and automation decisions (including the orchestrator)

Index