cc-os/docs/adr/README.md

5.4 KiB

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 Accepted 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