Architecture Decisions

Architecture Decisions

Architecture decision records preserve why the project chose a direction and what would justify changing it.

Accepted records

• ADR 0001 — Focus the product on environment failures
• ADR 0002 — Use a pnpm monorepo
• ADR 0003 — Use Next.js and Tauri with shared UI
• ADR 0004 — Begin with modular services and PostgreSQL relationships
• ADR 0005 — Separate AI from authorization and execution
• ADR 0006 — Version Wiki source in the main repository

Record format

Every ADR includes:

• status;
• date;
• context;
• decision;
• consequences;
• alternatives considered;
• conditions that would justify revisiting the decision.

Accepted records are not edited to hide obsolete assumptions. A later ADR supersedes them and links both directions.