complete codex docs

docs/decisions/README.md

@@ -0,0 +1,21 @@
+# Decisions
+
+This folder holds permanent architecture decisions and a small set of preserved investigation reports that informed those decisions.
+
+## Decision Records
+
+- `0001-screen-vs-tmux.md`
+- `0002-status-detection.md`
+- `0003-companion-programs.md`
+- `0004-workshop-system.md`
+- `0005-control-path-layout.md`
+- `0006-installers.md`
+
+## Preserved Reports
+
+- `COMPANION_PROGRAMS_DESIGN.md`
+- `SCHEDULER_ACTIONS_DESIGN.md`
+- `STEAM_WORKSHOP_DESIGN.md`
+
+Use the numbered decision files for long-term design rules. Use the report files for the investigative context that led to those decisions.
+