The decisions

Every decision has its roadmap inside (## Roadmap). The record of what is done and what is coming lives in the guide feed. This is the index: number, title, date, status and phases.

flowchart TD
  g["/guia/<br/>the feed: ideas and facts"] -->|"phase"| r["the ADR's roadmap"]
  a["docs/adr/…<br/>the ADR"] --> r
  r --> f["the open phases"]
  f --> i["docs/adr/roadmap.md<br/>the phase index"]

ADR	Decision	Date	Status	Phases
0001	Clean-room, with cc.json as the boundary	2026-10-20	accepted	applies to M0
0002	Core-first monorepo	2026-10-20	accepted	applies to M0, M1
0003	TypeScript first, Rust when a benchmark demands it	2026-10-20	accepted	M1
0004	The wedge: PR/CI + MCP	2026-10-20	accepted	applies to M2, M3
0005	2D first, 3D as a lens	2026-10-20	accepted	M0
0006	Nodes are files, ready for symbols	2026-10-20	accepted	applies to M0
0007	The name: CodArch	2026-10-20	accepted	applies to M0
0008	2D map design	2026-10-20	accepted	M5, M5.1
0009	Churn from git, without breaking determinism	2026-10-20	accepted	applies to M2
0010	Diff between snapshots and a stable report	2026-10-20	accepted	M2
0011	Architecture rules in .codarch.yml	2026-10-20	accepted	applies to M2, M9
0012	GitHub Action for PRs	2026-10-20	accepted	applies to M2
0013	Read-only MCP server	2026-10-20	accepted	applies to M3
0014	CLI distribution as a single npm package	2026-10-20	accepted	M3
0015	Separate public action	2026-10-20	accepted	applies to M3
0016	Migration lens v1	2026-10-20	accepted	M4
0017	Local server codarch serve	2026-10-20	accepted	applies to M5, M5.1
0018	View state in the URL and loading by URL	2026-10-21	accepted	applies to M5, M5.1
0019	Map level of detail	2026-10-21	accepted	applies to M5, M5.1
0020	Analysis in the browser with the same grammar as the CLI	2026-10-21	accepted	M6
0021	Desktop app (Electron) with its own interface	2026-10-21	accepted	M7 · shared UI in 0043
0022	Migration, where it was still missing	2026-10-21	accepted	M8
0023	Domain lens, step by step	2026-10-21	accepted	M9
0024	Time evolution: heat and history	2026-10-21	accepted	M10
0025	The symbols lens: looking inside the file	2026-10-21	accepted	M11
0026	The life of a symbol: the chain that survives renaming	2026-10-21	accepted	M12
0027	Settings: one place to configure everything	2026-10-21	accepted	M13
0028	Plugins: pieces of the repo that are switched on	2026-10-21	accepted	M14, M15
0029	Addons: declarative knowledge	2026-10-22	accepted	M16
0030	Installing and removing: plugins and addons	2026-10-22	accepted	M17
0031	Documents: every decision with its roadmap	2026-10-22	accepted	M18, M19, M20
0032	Versions and updates	2026-10-22	accepted	M21
0033	Opening the repo: what must be in place first	2026-10-22	accepted	M22
0034	The project website	2026-10-22	accepted	M23
0035	The guide reads like a changelog	2026-10-22	accepted	M23.6–M23.9
0036	The roadmap lives in the ADR, the changelog next to it	2026-10-22	accepted · 0047	M23, M24
0037	Cycles: runtime, not type	2026-10-23	accepted	applies to M2, M9
0038	The analysis scope is declared in .codarch.yml	2026-10-23	accepted	applies to M2, M5
0039	Searching for a chain: symbols, not nodes	2026-10-23	accepted	applies to M12
0040	Complexity counts the whole body	2026-10-23	accepted	applies to M0, M11
0041	Every version is declared once	2026-10-23	accepted	applies to the whole repo
0042	Delivery is automated	2026-10-23	accepted	M25
0043	The UI is shared as a package	2026-10-23	accepted	M26
0044	The web app in a local container	2026-10-23	accepted	M27
0045	The desktop installs and updates better	2026-10-23	accepted	M28
0046	Documents are published with Starlight	2026-10-23	accepted	M29
0047	The changelog is the guide	2026-10-23	accepted	M30
0048	The desktop persists in the repo’s .codarch/	2026-10-24	accepted	M32
0049	The orchestration is shared, the platform adapts	2026-10-24	accepted	M33

The folders

They go in blocks of ten: the number says when it was decided and the title says the topic.

• 0001-0010: 0001, 0002, 0003, 0004, 0005, 0006, 0007, 0008, 0009, 0010
• 0011-0020: 0011, 0012, 0013, 0014, 0015, 0016, 0017, 0018, 0019, 0020
• 0021-0030: 0021, 0022, 0023, 0024, 0025, 0026, 0027, 0028, 0029, 0030
• 0031-0040: 0031, 0032, 0033, 0034, 0035, 0036, 0037, 0038, 0039, 0040
• 0041-0050: 0041, 0042, 0043, 0044, 0045, 0046, 0047, 0048, 0049

The full roadmap, with one line per phase, is in roadmap.md.