Decisions

Each record explains one architectural decision: the context, what was decided, its consequences and the alternatives turned down. Records are not edited to follow the code; a changed decision gets a new record that supersedes the old one.

Decision	Status	Date
0001. One shared workflow, thin host adapters	Accepted	2026-10-21
0002. One user config file; host files rendered at install	Accepted	2026-10-21
0003. The installer owns only what it records	Accepted	2026-10-21
0004. One isolated worktree per task, run by ibni	Superseded by 0014	2026-10-21
0005. npm run verify is each repository's deterministic contract	Superseded by 0010	2026-10-21
0006. Rules stay rules; deterministic layers back them up	Accepted	2026-10-21
0007. Implementers implement, reviewers judge	Accepted	2026-10-21
0008. Jev triage runs in shadow, from metadata only	Accepted	2026-10-21
0009. Docs are generated from the files they describe	Accepted	2026-10-21
0010. Each repository names its verify command	Superseded by 0014	2026-10-22
0011. segwi: an opt-in launcher for mexxi runs, with a web app and MCP	Accepted; its "Strict permissions" point is superseded by 0012 and then 0016	2026-10-22
0012. segwi: three permissions modes, auto by default	Superseded by 0016	2026-10-23
0013. segwi: a browser and extra hosts for a run's checks, without loosening the sandbox	Accepted; its browser launcher, allowed hosts and smoke check are superseded by 0016	2026-10-23
0014. ibni installs dependencies and runs the verify command	Accepted; its deferred setup for a launcher with a sandbox is superseded by 0016; extended by 0017, 0018 and 0019	2026-10-23
0015. Every test names the break it catches	Accepted	2026-10-23
0016. segwi runs are trusted like your own sessions	Accepted	2026-10-24
0017. Each workspace gets a block of ports, and ibni hands it to setup and verify	Accepted	2026-10-25
0018. Setup and verify wait for one of a few machine-wide slots	Accepted	2026-10-25
0019. Setup and verify run in a systemd scope where one can start	Accepted	2026-10-25
0020. segwi serves local extensions behind its own sign-in	Accepted	2026-10-25