Skip to content

Architecture decisions

These records explain lasting choices whose rationale is established in repository history. They complement the current contract in SPEC.md, the architecture overview, and the project evolution.

Decision Status Effective date
Use Claude Code plugins as the source model Accepted 2026-02-03
Convert through a target-neutral IR Accepted 2026-02-12
Allow target-native files to override generated output Accepted 2026-05-29
Emit Codex plugin packages instead of loose files Accepted 2026-07-17
Require proven ownership for destructive cleanup Accepted 2026-07-26
Separate sync observation, planning, and application Accepted 2026-07-29
Materialize shared plugin resources into generated skills Accepted 2026-08-20
Bound sync convergence across prerequisite and conversion stages Accepted 2026-08-21

Retrospective records use the date the decision entered main, not the date this index was written.