# cc-os implementation status — index

_Last updated: 2026-07-17. 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](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](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-plugins` created
  (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:fix` unified 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 to `docs/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; `/readonly` decided as plan-mode convention, no
  skill (ADR-0030); os-doc-hygiene `file_length` scanner 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-tickets 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); route inspect
  issue-shape classification + split-by-kind default (issue #26); cross-project filing
  convention + derived global project index (issue #27, ADR-0034); wakeup-polling +
  tmux-convention spike with dry-run pilot (issue #28, ADR-0035/0036). Detail:
  os-context / os-doc-hygiene / os-backlog leaves.
- **2026-07-14** — os-sdlc plugin scaffolded (ADR-0037): new plugin inside cc-os (not a
  separate marketplace) for a harness-driven SDLC lifecycle, adapting Matt Pocock's v1.1
  skill lifecycle and Delta Refinery's multi-level pipeline; registered in local-plugins,
  no skills/agents/hooks implemented yet. Launching-point doc: `plugins/os-sdlc/OVERVIEW.md`;
  full design deferred to a follow-up brainstorming session.
- **2026-07-15** — os-doc-hygiene lifecycle-aware hygiene shipped (ADR-0038–0041): rulebook
  layer, lifetime taxonomy + tier matrix, no-ignore-propagation, conventions.json promotion,
  new `:calibrate` skill; calibration pass #1 (cc-os) passed. Detail: os-doc-hygiene leaf.
- **2026-07-16** — Planka retired (ADR-0042 supersedes ADR-0033): os-backlog reworked to
  git-issues-only via OpenSpec change `retire-planka-git-issues-only` — Planka lib/CLI/agents
  deleted, issue-create/issues helpers added, skills + SessionStart note rewritten, cards
  migrated (cc-os → jared/cc-os issues; philly board → jared/ops + jared/llf-schema;
  strays → new private jared/ops repo), boards snapshotted + pg-dumped (archive:
  ovh-vps `~/planka-final-snapshot-2026-07-16/`). Server decommissioned same day
  (containers/cron/creds removed); planka gem repo archived read-only. Detail:
  os-backlog leaf.
- **2026-07-16** — os-* standards audit vs cc-architect (post Phase B): every plugin got an
  index-style CLAUDE.md, os-doc-hygiene's cc-plugins-era docs reconciled, invariants.md
  added (os-shortcuts, os-vault), naming convention folded into cc-architect references,
  repo-level `bin/test` runner added. Detail:
  [implementation-status/standards-audit.md](implementation-status/standards-audit.md).
- **2026-07-17** — Absolute delegation policy shipped (ADR-0043): `10-orchestration.md`
  rewritten (executive frame, enumerated exemptions, persistent sonnet manager,
  failure-triggered opus escalation); audit rubric + `extract` driver updated to match;
  WS4 eval retired as instrument, kept as template. Detail: os-context leaf.

**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](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](implementation-status/os-context.md)
- **os-status** — aggregated in-process SessionStart checks + `/os-status:fix` unified
  setup/update command →
  [implementation-status/os-status.md](implementation-status/os-status.md)
- **os-doc-hygiene** — stale/bloated-doc monitoring; check/clean/status/sweep skills;
  deterministic scanner incl. `file_length` signal →
  [implementation-status/os-doc-hygiene.md](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](implementation-status/os-adr.md)
- **os-backlog** — git-issues backlog surface (ADR-0042 retired Planka 2026-07-16):
  tracker routing (`forgejo:`/`github:`/`repo:`), issue-create/issues CLI,
  capture/list/route skills, ten-label taxonomy with human-only `next` →
  [implementation-status/os-backlog.md](implementation-status/os-backlog.md)
- **os-shortcuts** — user-invoked QOL commands, skills only, never hooks (ADR-0028);
  resident: `/os-shortcuts:wrap` session-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](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](implementation-status/operational-procedures.md)
— stable leaf, referenced from CLAUDE.md.
