Switchain Services — Decisions

Store longer-lived architectural and product decisions in this directory.

What Belongs Here

• Architecture decision records.
• Durable trade-off decisions that affect multiple bounded contexts or apps.
• Decisions that need historical context, rationale, and consequences.

Naming

Use the same ADR naming pattern as nodo:

• Prefix every ADR with a zero-padded numeric sequence.
• Follow the number with a short kebab-case slug.
• Keep the numbering monotonic and repository-wide.

Format:

NNN-short-decision-name.md

Examples:

• 001-some-decision.md
• 002-another-decision.md

Recommended title format inside the document:

# ADR-NNN: Title

Index

• ADR-001: Canonical Documentation and Agent Structure
• ADR-002: System Documentation Layout (Centralized)

Related Docs

• Documentation Root
• Conventions
• Development