cc-os/docs/adr

Architecture Decision Records

One file per decision, NNNN-kebab-title.md, created via /os-adr:create.

ID	Title	Status	Date
0001	Two memory types, kept as separate systems	Accepted	2026-06-03
0002	memsearch for the episodic layer	Accepted	2026-06-03
0003	Flat vault with namespaced tags, not folders	Accepted	2026-06-03
0004	SQLite + Sequel (Ruby) tag index as the knowledge-layer cache	Superseded	2026-06-03
0005	Structured-first; semantic search over the vault deferred	Superseded	2026-06-03
0006	QMD as the (deferred) semantic-over-knowledge layer	Superseded	2026-06-03
0007	Lazy freshness: write-hook + session-start reconcile, no daemon/cron	Accepted	2026-06-03
0008	Markdown-as-truth; sync the vault, not the indexes	Accepted	2026-06-03
0009	Package as a global Claude Code plugin with skills	Accepted	2026-06-03
0010	Graphify knowledge graph as the knowledge layer (supersedes ADR-004/005/006)	Accepted	2026-06-03
0011	Faceted tag taxonomy: six independent namespaces (refines ADR-003)	Accepted	2026-06-04
0012	Reuse the existing SecondBrain vault as the knowledge vault	Accepted	2026-06-04
0013	Build-first / migrate-incrementally (build-order inversion)	Accepted	2026-06-04
0014	Graph connectivity comes from authored structure; migration scaffolding is a first-class prerequisite	Accepted	2026-06-05
0015	memsearch episodic memory version-controlled in a dedicated private repo, auto-synced via cc-os SessionEnd hook	Accepted	2026-06-09
0016	Memory plugin sourced from cc-os git repo; bash→Python deep-module port; memsearch-sync split; symlink cutover	Accepted	2026-06-12
0017	Project graph onboarding assesses the repo and writes .graphifyignore before extracting	Accepted	2026-06-17
0018	Plugin renames must update the marketplace manifest, not just the directory and settings.json	Accepted	2026-07-03
0019	Global os-orchestration plugin supersedes per-project orchestration text	Superseded	2026-07-03
0020	os-adr plugin built; implementation-time resolutions of the design's open questions	Accepted	2026-07-03
0021	Model-tier skill-execution eval for os-adr (Eval A), run in-session via subagents	Accepted	2026-07-03
0022	os-status plugin: aggregated in-process SessionStart status checks	Accepted	2026-07-06
0023	Backlog process management ships as a new os-backlog plugin (not an os-vault extension)	Accepted	2026-07-10
0024	Apprise replaces Pushover as the notification transport (supersedes the Pushover-direct plan)	Accepted	2026-07-10
0025	Standard Ruby structure for cc-os plugins (lib/ + single-dispatcher bin/, fail-soft, installed-gem-only dependencies)	Accepted	2026-07-10
0026	Unified project setup/update command: /os-status:fix remediates what the os-status checks flag	Accepted	2026-07-12
0027	All cc-os per-project state lives under .cc-os/<plugin>/	Accepted	2026-07-12
0028	os-shortcuts plugin for user-invoked QOL commands, bounded against hook-injection plugins	Accepted	2026-07-12
0029	os-backlog card-move with CLI-enforced column ownership; afk-ready cards skip Review	Accepted	2026-07-12
0030	Read-only work uses Claude Code plan mode; no /readonly shortcut command	Accepted	2026-07-13
0031	os-context prompt-composer plugin supersedes single-file os-orchestration	Accepted	2026-07-13
0032	AI-maintained knowledge files are indexes with progressive disclosure	Accepted	2026-07-13
0033	Tracker routing: Planka is state, git issues are specs	Accepted	2026-07-13
0034	Cross-project filing: file-dont-fix with a derived global project index	Accepted	2026-07-13
0035	Issue-triggered project AI wakeup via polling, not webhooks	Accepted	2026-07-13
0036	tmux session convention for AI-run sessions: cc--	Accepted	2026-07-13