137 lines
9.4 KiB
Markdown
137 lines
9.4 KiB
Markdown
# 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.
|