Decision log¶
Record decisions that change product behavior, architecture, security, data, money movement, team ownership, or external commitments.
Active decisions¶
| Date | Decision | Status | Owner | Evidence / consequence |
|---|---|---|---|---|
| 2026-08-03 | Use hq.sagio.io as the company operating-system surface, with docs at /docs |
Proposed | Lulzx | Keeps “internal” available; supports company context beyond documentation |
| 2026-08-03 | Use MkDocs Material with an indigo primary palette | Accepted | Lulzx | Fast, searchable, Markdown-native, and maintainable in the repository |
| 2026-08-03 | Generate private GitHub status during the trusted build rather than in the browser | Accepted | Lulzx | Avoids exposing a GitHub token to readers |
| Existing | Keep the x402 facilitator in SagioOfficial/sagio-facilitator |
Accepted | Product owners | Prevents service boundaries from becoming ambiguous |
Decision record template¶
# ADR-NNN: Short decision title
- Status: proposed | accepted | superseded
- Date: YYYY-MM-DD
- Owner: @person
## Context
What is observably true? What constraint or uncertainty requires a decision?
## Decision
What are we choosing?
## Evidence
What supports the choice? What would falsify it?
## Consequences
What becomes easier, harder, or irreversible?
## Revisit when
Name the trigger; do not use a vague calendar reminder.