vault: session notes 2026-07-06

cc-os-hub.md

@@ -0,0 +1,76 @@
+---
+type: hub
+title: cc-os — personal cross-project memory system for Claude Code
+summary: Navigation hub for cc-os, the personal cross-project memory system for Claude Code (episodic memsearch + semantic SecondBrain vault via Graphify) and its family of global plugins (os-vault, os-adr, os-orchestration, os-doc-hygiene) — design, conventions, and eval results.
+tags:
+  - type/hub
+  - project/cc-os
+  - domain/knowledge-graphs
+  - domain/llm-evaluation
+  - tool/graphify
+  - tool/claude-code
+scope: global
+last_updated: 2026-07-06
+date: 2026-07-06
+source: cc-os
+---
+
+# cc-os
+
+`cc-os` (`/home/jared/dev/cc-os`) is a design-and-implementation repo for a personal,
+cross-project memory system for Claude Code, built for a multi-client freelancer. It splits
+memory into two systems — **episodic** (memsearch, "what happened, when") and
+**semantic/knowledge** (this vault, "how do we…", queried via Graphify) — and ships a family of
+global Claude Code plugins (`os-vault`, `os-adr`, `os-orchestration`, `os-doc-hygiene`) that
+operationalize conventions across every project, not just cc-os itself.
+
+## Design & decisions
+
+- [[2026-06-09-claude-code-memory-system-design]] — the two-layer architecture (episodic +
+  semantic), hook-injected retrieval, freshness model.
+- [[2026-06-09-claude-code-memory-system-adrs]] — the 14-decision ADR log behind that design.
+- [[2026-06-09-graphify-evaluation-as-knowledge-layer]] — why Graphify was adopted as the
+  knowledge-layer engine.
+- [[vault-conventions]] — the vault's frontmatter contract, note types, and tag taxonomy (single
+  source of truth; don't duplicate it elsewhere).
+- [[cc-os-plugin-skill-naming-convention]] — `os-[domain]` plugin naming, verb-first skills, and
+  the `name:`-field-in-SKILL.md registration gotcha.
+- [[vault-backlog-pilot-plan]] / [[backlog-system-options-research]] — the cross-project backlog
+  decision (Planka CE + thin Ruby CLI) adjacent to the vault's knowledge-layer role.
+
+## Graphify handbook
+
+The verified reference handbook behind cc-os's chosen knowledge-graph engine:
+[[2026-06-08-graphify-conceptual-model]] (mental model) ·
+[[2026-06-08-graphify-installation-setup]] ·
+[[2026-06-08-graphify-overview-concepts]] ·
+[[2026-06-08-graphify-ingesting-code-ast]] ·
+[[2026-06-08-graphify-ingesting-docs-knowledge]] ·
+[[2026-06-08-graphify-extraction-model-options]] ·
+[[2026-06-08-graphify-local-models-backends]] ·
+[[2026-06-08-graphify-querying-god-nodes]] ·
+[[2026-06-08-graphify-token-economics-updates]] ·
+[[2026-06-08-graphify-workflows-use-cases]] ·
+[[2026-06-08-graphify-best-practices-checklist]].
+
+## Eval methodology and results
+
+cc-os plugins are validated by held-out, unprompted-behavior evals rather than prompted demos.
+Start at [[eval-methodology-hub]] for the general methodology (ladder design, wording-loop
+procedure, production feedback loop). Concrete results:
+
+- **os-adr:** [[2026-07-03-os-adr-eval-b-grid-results-and-observations]] (2026-07-03 baseline;
+  note: a duplicate slug-only file `os-adr-eval-b-grid-results-and-observations.md` also exists
+  and is empty — likely a stale rename artifact, flagged here but not fixed as out of scope) →
+  [[os-adr-eval-b-wording-experiment-hypotheses]] (wording loop, sonnet 8/8 / haiku 7/8) →
+  [[os-adr-eval-c-frozen-grid-results]] (frozen ambiguity-ladder grid, 12/12 cells pass).
+- **os-orchestration:** [[os-orchestration-ws1-session-audit-results]] (10-session IRL audit;
+  found the `CLAUDE_CODE_SUBAGENT_MODEL` env override) → [[os-orchestration-eval-baseline-grid-results]]
+  (E1–E3 baseline grid).
+- **os-vault:** write-skill discrimination eval planned, not yet run — see
+  `docs/plans/ws2-os-vault-write-eval.md` in the cc-os repo.
+
+## Related
+
+- [[eval-methodology-hub]] — general evaluation methodology (not cc-os-specific, but built on
+  and by cc-os plugin work).

cc-os-plugin-skill-naming-convention.md

@@ -13,6 +13,7 @@ date: 2026-07-02
 related:
   - vault-conventions
   - CLAUDE
+  - cc-os-hub
 ---
 
 # cc-os Plugin and Skill Naming Convention