| 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 |
Superseded |
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 |
| 0037 |
os-sdlc lives inside cc-os as a new plugin, not a separate cc-sdlc marketplace |
Accepted |
2026-07-14 |
| 0038 |
Per-project doc-hygiene rulebook override lives at repo-root .dochygiene-rules.json, not in .cc-os/ |
Accepted |
2026-07-14 |
| 0039 |
Doc-hygiene deletion autonomy is tiered on evidence quality and recoverability, not file type |
Accepted |
2026-07-14 |
| 0040 |
Doc-hygiene rules never write other tools' ignore surfaces (no propagate_ignore) |
Accepted |
2026-07-14 |
| 0041 |
Determinism promotion: hygiene nudges projects toward structurally-obvious completion conventions |
Accepted |
2026-07-14 |
| 0042 |
Retire Planka: git issues are the single tracker for state and specs |
Accepted |
2026-07-16 |
| 0043 |
Absolute delegation policy: main loop as executive with enumerated exemptions |
Accepted |
2026-07-17 |