jared
/
cc-os
1
0
Fork 0
Code Issues 18 Pull Requests Packages Projects Releases Wiki Activity
cc-os/docs/implementation-status.md

9.1 KiB
Raw Blame History

cc-os implementation status — index

Last updated: 2026-07-16. 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-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-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); 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.

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:fix unified setup/update command → 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
  • 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 — 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
  • 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

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.