jared
/
cc-os
1
0
Fork 0
Code Issues 18 Pull Requests Packages Projects Releases Wiki Activity
cc-os/docs/adr
History
jared f9a81a17c5 os-backlog: cross-project filing convention + derived global project index (issue #27, ADR-0034) 
Backlog::ProjectIndex at ~/.cc-os/projects.json, upserted fail-soft by
config-write, queried via new 'projects' subcommand. Discoverer template +
filing mechanics reference doc; CROSS-PROJECT rule line in the SessionStart
note. ADR-0034 Accepted. Suite 112/233/0.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01CLeMz48rvG3s9XpAsDxeho
 		2026-07-13 10:48:19 -04:00
..
0001-two-memory-types-kept-as-separate-systems.md Migrate ADR log to docs/adr/, one file per decision 2026-07-12 18:10:31 -04:00
0002-memsearch-for-the-episodic-layer.md Migrate ADR log to docs/adr/, one file per decision 2026-07-12 18:10:31 -04:00
0003-flat-vault-with-namespaced-tags-not-folders.md Migrate ADR log to docs/adr/, one file per decision 2026-07-12 18:10:31 -04:00
0004-sqlite-sequel-ruby-tag-index-as-the-knowledge-layer-cache.md Migrate ADR log to docs/adr/, one file per decision 2026-07-12 18:10:31 -04:00
0005-structured-first-semantic-search-over-the-vault-deferred.md Migrate ADR log to docs/adr/, one file per decision 2026-07-12 18:10:31 -04:00
0006-qmd-as-the-deferred-semantic-over-knowledge-layer.md Migrate ADR log to docs/adr/, one file per decision 2026-07-12 18:10:31 -04:00
0007-lazy-freshness-write-hook-session-start-reconcile-no-daemon-cron.md Migrate ADR log to docs/adr/, one file per decision 2026-07-12 18:10:31 -04:00
0008-markdown-as-truth-sync-the-vault-not-the-indexes.md Migrate ADR log to docs/adr/, one file per decision 2026-07-12 18:10:31 -04:00
0009-package-as-a-global-claude-code-plugin-with-skills.md Migrate ADR log to docs/adr/, one file per decision 2026-07-12 18:10:31 -04:00
0010-graphify-knowledge-graph-as-the-knowledge-layer-supersedes-adr-004-005-006.md Migrate ADR log to docs/adr/, one file per decision 2026-07-12 18:10:31 -04:00
0011-faceted-tag-taxonomy-six-independent-namespaces-refines-adr-003.md Migrate ADR log to docs/adr/, one file per decision 2026-07-12 18:10:31 -04:00
0012-reuse-the-existing-secondbrain-vault-as-the-knowledge-vault.md Migrate ADR log to docs/adr/, one file per decision 2026-07-12 18:10:31 -04:00
0013-build-first-migrate-incrementally-build-order-inversion.md Migrate ADR log to docs/adr/, one file per decision 2026-07-12 18:10:31 -04:00
0014-graph-connectivity-comes-from-authored-structure-migration-scaffolding-is-a-first-class-prerequisite.md Migrate ADR log to docs/adr/, one file per decision 2026-07-12 18:10:31 -04:00
0015-memsearch-episodic-memory-version-controlled-in-a-dedicated-private-repo-auto-synced-via-cc-os-sessionend-hook.md Migrate ADR log to docs/adr/, one file per decision 2026-07-12 18:10:31 -04:00
0016-memory-plugin-sourced-from-cc-os-git-repo-bash-python-deep-module-port-memsearch-sync-split-symlink-cutover.md Migrate ADR log to docs/adr/, one file per decision 2026-07-12 18:10:31 -04:00
0017-project-graph-onboarding-assesses-the-repo-and-writes-graphifyignore-before-extracting.md Migrate ADR log to docs/adr/, one file per decision 2026-07-12 18:10:31 -04:00
0018-plugin-renames-must-update-the-marketplace-manifest-not-just-the-directory-and-settings-json.md Migrate ADR log to docs/adr/, one file per decision 2026-07-12 18:10:31 -04:00
0019-global-os-orchestration-plugin-supersedes-per-project-orchestration-text.md os-context: prompt-composer plugin supersedes os-orchestration; prompt files authored (ADR-031) 2026-07-13 08:06:48 -04:00
0020-os-adr-plugin-built-implementation-time-resolutions-of-the-design-s-open-questions.md Migrate ADR log to docs/adr/, one file per decision 2026-07-12 18:10:31 -04:00
0021-model-tier-skill-execution-eval-for-os-adr-eval-a-run-in-session-via-subagents.md Migrate ADR log to docs/adr/, one file per decision 2026-07-12 18:10:31 -04:00
0022-os-status-plugin-aggregated-in-process-sessionstart-status-checks.md Migrate ADR log to docs/adr/, one file per decision 2026-07-12 18:10:31 -04:00
0023-backlog-process-management-ships-as-a-new-os-backlog-plugin-not-an-os-vault-extension.md Migrate ADR log to docs/adr/, one file per decision 2026-07-12 18:10:31 -04:00
0024-apprise-replaces-pushover-as-the-notification-transport-supersedes-the-pushover-direct-plan.md Migrate ADR log to docs/adr/, one file per decision 2026-07-12 18:10:31 -04:00
0025-standard-ruby-structure-for-cc-os-plugins-lib-single-dispatcher-bin-fail-soft-installed-gem-only-dependencies.md Migrate ADR log to docs/adr/, one file per decision 2026-07-12 18:10:31 -04:00
0026-unified-project-setup-update-command-os-status-fix-remediates-what-the-os-status-checks-flag.md Migrate ADR log to docs/adr/, one file per decision 2026-07-12 18:10:31 -04:00
0027-all-cc-os-per-project-state-lives-under-cc-os-plugin.md Migrate ADR log to docs/adr/, one file per decision 2026-07-12 18:10:31 -04:00
0028-os-shortcuts-plugin-for-user-invoked-qol-commands-bounded-against-hook-injection-plugins.md os-shortcuts: new plugin + /wrap session-close skill (ADR-028) 2026-07-12 18:53:07 -04:00
0029-os-backlog-card-move-with-cli-enforced-column-ownership-afk-ready-cards-skip-review.md os-backlog: card-move with CLI-enforced column ownership (ADR-029) 2026-07-12 19:11:49 -04:00
0030-read-only-work-uses-claude-code-plan-mode-no-readonly-shortcut-command.md ADR-030: read-only work uses plan mode; no /readonly shortcut 2026-07-13 08:06:48 -04:00
0031-os-context-prompt-composer-plugin-supersedes-single-file-os-orchestration.md os-context: prompt-composer plugin supersedes os-orchestration; prompt files authored (ADR-031) 2026-07-13 08:06:48 -04:00
0032-ai-maintained-knowledge-files-are-indexes-with-progressive-disclosure.md docs: distill implementation-status.md to index+PD; ADR-0032 records the convention (issue #25 parts 2-3) 2026-07-13 09:18:23 -04:00
0033-tracker-routing-planka-is-state-git-issues-are-specs.md os-backlog slice 8: Operations board + tracker-routing rubric + ADR-0033 (issue #17) 2026-07-13 10:00:36 -04:00
0034-cross-project-filing-file-dont-fix-with-a-derived-global-project-index.md os-backlog: cross-project filing convention + derived global project index (issue #27, ADR-0034) 2026-07-13 10:48:19 -04:00
README.md os-backlog: cross-project filing convention + derived global project index (issue #27, ADR-0034) 2026-07-13 10:48:19 -04:00
migration-report.md Migrate ADR log to docs/adr/, one file per decision 2026-07-12 18:10:31 -04:00

README.md

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 Proposed 2026-07-13