7.0 KiB
cc-os implementation status — index
Last updated: 2026-07-13. This file is an index with progressive disclosure (see the
index+PD convention ADR): headline timeline entries and per-component one-liners live here;
full per-component detail lives in leaf files under docs/implementation-status/, read on
demand. When a build step completes, add a one-line timeline entry here and put the
detail in (or create) the relevant leaf file; decisions go to docs/adr/ — an ADR is the
durable record, so don't duplicate its content here. Touch CLAUDE.md only if the current
design or conventions changed. (History: moved out of CLAUDE.md 2026-07-08; distilled from
the previous 729-line append-only changelog 2026-07-13, issue #25.)
Status timeline (headlines)
Decisions are recorded in docs/adr/ (see docs/adr/README.md); entries below that only
restated an ADR were removed in the 2026-07-13 distill. Component-level detail for each
entry is in the leaf file named.
- 2026-06-03 — Graphify pivot: replaces the planned Ruby/SQLite tag-index CLI and the
deferred QMD layer (ADR-0010; rationale:
docs/memory-system/06-graphify-evaluation.md). - 2026-06-04 — Core design decisions locked: facet taxonomy, vault reuse, build-first order (ADR-0011/0012/0013).
- 2026-06-05 — Empirical: Graphify is a structure extractor, not a topic clusterer;
hubs/wikilinks must be authored (ADR-0014; findings:
docs/memory-system/07-graph-connectivity-findings.md). - 2026-06-09 — os-vault plugin live; build-plan Steps 1/2a/2b/3/4/5a/6 complete; single global memsearch store decided (ADR-0015). Detail: implementation-status/os-vault.md.
- 2026-06-12 — Plugin source moved into cc-os git; bash→Python deep-module port; symlink cutover (ADR-0016).
- 2026-06-15 — Step 5b vault git sync automated; llf-schema pilot onboarded; all required build steps complete. Detail: os-vault leaf.
- 2026-06-17 — Assessment-first project onboarding +
.graphifyignore(ADR-0017). - 2026-06-30 — SB Content Plan Phase 1 complete (schema reconciliation, templates, design-template skill). Detail: os-vault leaf; Phase 2 (issue #7) open as steady-state epic.
- 2026-07-03 — Plugin renamed
memory→os-vault; marketplace-manifest failure mode found (ADR-0018, runbook in implementation-status/operational-procedures.md). os-doc-hygiene and os-orchestration migrated in from cc-plugins (ADR-0019); os-adr plugin built + migration pilot passed + Eval A/B baselines (ADR-0020/0021). Detail: os-adr / os-doc-hygiene / os-context leaves. - 2026-07-04 — Stale-plugin-cache incident resolved;
bin/refresh-pluginscreated (runbook: operational-procedures leaf). os-adr Eval B wording loop closed the gap (sonnet 8/8, haiku 7/8). Detail: os-adr leaf. - 2026-07-06 — os-status plugin built (ADR-0022); os-vault WS2 + os-orchestration WS1/E1–E3 eval harnesses + baseline grids; os-adr Eval C harness + saturated frozen grid. Detail: os-status / os-vault / os-context / os-adr leaves.
- 2026-07-07/08 — os-vault WS2 wording loop and os-orchestration WS4 economics loop complete and shipped; run-sets AND reserves now contaminated for future wording tuning — next signal is production IRL audits. Detail: os-vault / os-context leaves.
- 2026-07-10 — Multi-machine freshness closed (SessionStart ff-only pull); os-backlog AFK slices shipped + live-verified, planka-api 0.2.0 migration (ADR-0023/0025); first orchestration IRL re-audit done + biweekly audit semi-automated. Detail: os-vault / os-backlog / os-context leaves.
- 2026-07-12 —
/os-status:fixunified setup/update command (ADR-0026) +/os-backlog:route; fix tune-up +.cc-os/state consolidation (ADR-0027); cc-os ADR retrofit — 27-ADR monolith migrated todocs/adr/(ADR-0020 amendment); os-shortcuts plugin +/wrap(ADR-0028); os-backlog card-move + afk-ready-skips-Review (ADR-0029). Detail: os-status / os-backlog / os-adr leaves. - 2026-07-13 — os-orchestration renamed/generalized to os-context prompt composer
(ADR-0031) + three new prompt files;
/readonlydecided as plan-mode convention, no skill (ADR-0030); os-doc-hygienefile_lengthscanner signal shipped (issue #25 part 1); this file distilled to index+PD (issue #25 parts 2–3, ADR-0032). os-backlog slice 7 shipped: SessionStart injection note + /to-issues tracker routing (issue #16); board-id cache via BoardResolver (issue #22); slice 8 — Operations board + tracker-routing rubric category + ADR-0033 canonizing Planka-state/git-issues-spec (issue #17). Detail: os-context / os-doc-hygiene / os-backlog leaves.
Remaining optional items: additional project onboarding (one at a time, per ADR-0013); bulk vault migration; os-adr rollout to pilot projects; os-backlog routing rollout (#14); cross-project filing convention (#27) and wakeup design spike (#28).
Implemented components (one-liners)
Read the leaf file before modifying a component.
- os-vault — vault write/query/reorganize/onboard-project/design-template skills, SessionStart/End hooks, vault + memsearch git sync, WS2 write-behavior eval → implementation-status/os-vault.md
- os-context (ex os-orchestration) — SessionStart prompt composer
(
prompts/session-start/*.md), orchestration rules, audit-sessions skill, E1–E5 eval harness + IRL audit machinery → implementation-status/os-context.md - os-status — aggregated in-process SessionStart checks +
/os-status:fixunified setup/update command → implementation-status/os-status.md - os-doc-hygiene — stale/bloated-doc monitoring; check/clean/status/sweep skills;
deterministic scanner incl.
file_lengthsignal → implementation-status/os-doc-hygiene.md - os-adr — ADR system (Ruby
lib/adr/+ CLIs; create/init/migrate/find skills; Eval A/B/C harnesses; cc-os retrofit done) → implementation-status/os-adr.md - os-backlog — Planka process surface: board lifecycle, capture/list/route skills, card CLI with column-ownership rules, triage/audit agents → implementation-status/os-backlog.md
- os-shortcuts — user-invoked QOL commands, skills only, never hooks (ADR-0028);
resident:
/os-shortcuts:wrapsession-close ritual (shipped 2026-07-12). No leaf file yet — this entry is the full detail. - Graphify / memsearch / vault git sync — external memory infrastructure (versions, paths, sync topology) → implementation-status/memory-infrastructure.md
Operational procedures
Runbooks (plugin rename/move, plugin cache refresh via bin/refresh-plugins) live in
implementation-status/operational-procedures.md
— stable leaf, referenced from CLAUDE.md.