Architecture decision records
MADR format (Context, Options, Decision, Consequences). Generated by tools/docs/adr_index.py from each ADR's
front matter; don't edit this file by hand. The old docs/decisions/DR-NNN-*.md paths are stubs pointing here.
Proposed (12)
| ADR |
Title |
Date |
Deciders |
Supersedes |
| ADR-0004 |
Hosting growth path, including running AI models |
2026-10-13 |
Atul Jain |
- |
| ADR-0005 |
Move routine panel work to Google Apps Script; free Claude for project roles |
2026-10-14 |
Atul Jain |
- |
| ADR-0006 |
One MMDEP: merge collector with the orchestrator, panel with the inbox, Gemini controller |
2026-10-14 |
Atul Jain |
- |
| ADR-0007 |
Design, Code and Test harnesses; first real Gemini use; on-demand AI and compute vs subscriptions |
2026-10-17 |
Atul Jain |
- |
| ADR-0008 |
Repo-based hand-offs, code preflight and model routing, label review, Claude delegation, code segregation (GitLab first) and satellite repositories |
2026-10-17 |
Atul Jain |
- |
| ADR-0009 |
Open work packages for free agents and gig workers; indicative data class; extending subscriptions on demand |
2026-10-17 |
Atul Jain |
- |
| ADR-0010 |
Low-memory coding models and helpers for old machines; automation triggers for the harness |
2026-10-18 |
Atul Jain |
- |
| ADR-0011 |
GitLab compute minutes for sprint 2, group layout, and the online (machine-down) mode |
2026-10-18 |
Atul Jain |
- |
| ADR-0013 |
API in two lanes (production = high risk, staging = low risk) to double output without slowing other projects |
2026-10-19 |
Atul Jain |
- |
| ADR-0015 |
Worktrees per agent, Fabric for deploy and audit, Aider as a harness engine, Python tool list, and model routing by data class |
2026-10-20 |
Atul Jain |
- |
| ADR-0017 |
Program-level controls: hub-and-spoke with MMDEP as the program hub; cross-project dependencies; impact analysis |
2026-10-20 |
Atul Jain |
- |
| ADR-0018 |
Review of the external vetting (21 Oct): model pool with LiteLLM, server sizing, the cloud harness, and the three harness guardrails |
2026-10-21 |
Atul Jain |
- |
Accepted (6)
| ADR |
Title |
Date |
Deciders |
Supersedes |
| ADR-0001 |
Where the orchestrator's code lives, versus the estate knowledge |
2026-09-28 |
Atul Jain |
- |
| ADR-0002 |
Agent platforms and automation |
2026-10-05 |
Atul Jain |
- |
| ADR-0003 |
Where the MMDEP controller runs (desktop, cloud VM, on-demand compute) |
2026-10-05 |
Atul Jain |
- |
| ADR-0012 |
Three process flows (phone PROCEED, browser attended, terminal unattended) and merging without per-PR approval |
2026-10-19 |
Atul Jain |
- |
| ADR-0014 |
Knowledge recovery from chats, agent memory in the repository, actions from agents, TEA and documentation modules |
2026-10-20 |
Atul Jain |
- |
| ADR-0016 |
Design documentation people and agents can both use (C4-as-code, MADR, rules/skills/MCP layers), and the two delivery workflows with fallbacks |
2026-10-20 |
Atul Jain |
- |