Skip to content

background

Claude edited this page Sep 23, 2026 · 3 revisions

Background and key decisions

Canonical records: docs/adrs/ and .agents/DECISIONS.md. This page is a pointer.

Why a golden path existed

ADR 0001 needed an executable typed Database → API → Web journey without inventing a product domain. That app still exists. It is no longer the shape of new work.

Why the root is a control plane

ADR 0002 put contracts, risk, leases, and evidence in-repo instead of a custom service.

Why capsules are two levels deep

ADR 0005 groups products by compliance context. Domain folders own no code.

Why extraction is the proof

ADR 0006 rejected "root-managed runtime for every capsule" and "one repo per project with no control plane".

Migration from abyss-monorepo

Selective copy, never lift-and-shift (decision 2026-08-11). .env from the old tree is never read. Lessons: .agents/knowledge/12_LESSONS.md.

Related

Clone this wiki locally