2026-07-13 13:18:23 +00:00
|
|
|
|
# cc-os implementation status — index
|
|
|
|
|
|
|
2026-07-16 19:34:41 +00:00
|
|
|
|
_Last updated: 2026-07-16. This file is an **index with progressive disclosure** (see the
|
2026-07-13 13:18:23 +00:00
|
|
|
|
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-issues tracker routing (issue #16); board-id
|
2026-07-13 14:00:36 +00:00
|
|
|
|
cache via BoardResolver (issue #22); slice 8 — Operations board + tracker-routing rubric
|
2026-07-13 14:32:58 +00:00
|
|
|
|
category + ADR-0033 canonizing Planka-state/git-issues-spec (issue #17); route inspect
|
2026-07-13 14:48:19 +00:00
|
|
|
|
issue-shape classification + split-by-kind default (issue #26); cross-project filing
|
2026-07-13 15:02:44 +00:00
|
|
|
|
convention + derived global project index (issue #27, ADR-0034); wakeup-polling +
|
|
|
|
|
|
tmux-convention spike with dry-run pilot (issue #28, ADR-0035/0036). Detail:
|
2026-07-13 14:00:36 +00:00
|
|
|
|
os-context / os-doc-hygiene / os-backlog leaves.
|
2026-07-15 11:41:59 +00:00
|
|
|
|
- **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.
|
Retire Planka: os-backlog reworked to git-issues-only (ADR-0042)
Executes OpenSpec change retire-planka-git-issues-only (archived, 25/25 tasks):
- os-backlog v0.3.0: Planka lib/CLI/agents deleted; issue-create/issues
helpers (tea/gh/repo-file dispatch); ten-label taxonomy, human-only next
- planka: rejected fail-soft citing ADR-0042 in tracker grammar,
config-write, and the os-status check
- Skills, SessionStart note (~687 -> ~444 tokens), /to-issues, os-status fix
rewritten to the single-tracker model
- All boards snapshotted + pg-dumped (ovh-vps ~/planka-final-snapshot-2026-07-16);
cards migrated to jared/cc-os#61-70, jared/ops#1-21, jared/llf-schema#7-10
- Planka server decommissioned; planka gem repo archived read-only
- Delta specs synced to openspec/specs/ (issue-backlog, issue-state-labels)
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014HWNfGWoWnhrub4EJa1M1Y
2026-07-16 19:48:40 +00:00
|
|
|
|
- **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 19:34:41 +00:00
|
|
|
|
- **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-13 13:18:23 +00:00
|
|
|
|
|
|
|
|
|
|
**Remaining optional items:** additional project onboarding (one at a time, per ADR-0013);
|
2026-07-13 14:00:36 +00:00
|
|
|
|
bulk vault migration; os-adr rollout to pilot projects; os-backlog routing rollout (#14);
|
|
|
|
|
|
cross-project filing convention (#27) and wakeup design spike (#28).
|
2026-07-13 13:18:23 +00:00
|
|
|
|
|
|
|
|
|
|
## 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)
|
Retire Planka: os-backlog reworked to git-issues-only (ADR-0042)
Executes OpenSpec change retire-planka-git-issues-only (archived, 25/25 tasks):
- os-backlog v0.3.0: Planka lib/CLI/agents deleted; issue-create/issues
helpers (tea/gh/repo-file dispatch); ten-label taxonomy, human-only next
- planka: rejected fail-soft citing ADR-0042 in tracker grammar,
config-write, and the os-status check
- Skills, SessionStart note (~687 -> ~444 tokens), /to-issues, os-status fix
rewritten to the single-tracker model
- All boards snapshotted + pg-dumped (ovh-vps ~/planka-final-snapshot-2026-07-16);
cards migrated to jared/cc-os#61-70, jared/ops#1-21, jared/llf-schema#7-10
- Planka server decommissioned; planka gem repo archived read-only
- Delta specs synced to openspec/specs/ (issue-backlog, issue-state-labels)
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014HWNfGWoWnhrub4EJa1M1Y
2026-07-16 19:48:40 +00:00
|
|
|
|
- **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` →
|
2026-07-13 13:18:23 +00:00
|
|
|
|
[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)
|
2026-07-12 22:53:07 +00:00
|
|
|
|
|
2026-07-08 17:36:16 +00:00
|
|
|
|
## Operational procedures
|
|
|
|
|
|
|
2026-07-13 13:18:23 +00:00
|
|
|
|
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.
|
