48 lines
2.6 KiB
Markdown
48 lines
2.6 KiB
Markdown
# os-* standards audit vs cc-architect — 2026-07-16
|
||
|
||
One-time audit executed after cc-architect's Phase B migration into cc-os (commit
|
||
3f76755), per the backlog ticket "Audit os-* plugins against cc-architect standards
|
||
(post standards-centralization)". Ran cc-architect's `workflows/audit-plugin.md`
|
||
Phase 1–2 checklist against all eight os-* plugins, then remediated.
|
||
|
||
## Results
|
||
|
||
All eight plugins pass manifest validation (name/version/description, kebab-case,
|
||
semver), have no `name:` fields in SKILL.md frontmatter, and have no `commands/`
|
||
dispatcher directories.
|
||
|
||
Remediation shipped:
|
||
|
||
- **Per-plugin CLAUDE.md indexes** (ADR-0032 index+PD style) created for os-adr,
|
||
os-backlog (minimal — Planka-retirement rework in flight), os-context, os-sdlc,
|
||
os-shortcuts, os-status, os-vault; os-doc-hygiene's stale pre-build cc-plugins-era
|
||
CLAUDE.md rewritten.
|
||
- **os-doc-hygiene cc-plugins references reconciled**: PRD.md target path and
|
||
marketplace naming corrected; broken `../.claude/references/` path and retired
|
||
`/install doc-hygiene@cc-plugins` instructions removed.
|
||
- **invariants.md** added for os-shortcuts (4 invariants) and os-vault (8); already
|
||
existed for os-adr, os-doc-hygiene, os-status. os-backlog deferred (rework in
|
||
flight); os-sdlc/os-context not warranted yet.
|
||
- **ADR-0025 / os-adr**: no action — the ADR itself records the per-verb-`bin/`
|
||
exemption ("grandfathered... until os-adr is next touched for other reasons").
|
||
- **Naming convention** folded into the repo:
|
||
`plugins/cc-architect/references/conventions/cc-os-naming.md` is now canonical;
|
||
the SecondBrain vault note and root CLAUDE.md point to it.
|
||
- **Repo-level test runner**: `bin/test` runs every plugin's minitest
|
||
(`tests/all.rb`) and pytest suite, one pytest invocation per plugin (avoids
|
||
same-named `hook_test.py` module collisions). os-vault's `tests/` is an eval
|
||
harness, deliberately excluded.
|
||
- **os-vault hook wiring documented**: hooks are intentionally wired via user-level
|
||
`~/.claude/settings.json` pointing at repo source scripts, not a plugin
|
||
`hooks/hooks.json`; recorded in os-vault/CLAUDE.md so the absent hooks.json stops
|
||
reading as a defect.
|
||
|
||
## Deferred (filed, not fixed)
|
||
|
||
- os-backlog ADR-0025 deviations (second entry point `bin/wakeup-poll`; no README
|
||
naming gem deps) → Forgejo issue jared/cc-os#74, to be folded into the
|
||
retire-planka-git-issues-only rework.
|
||
- os-context `skills/audit-sessions/SKILL.md` stale Planka references and os-status
|
||
`planka:` tracker-scheme handling — both already being fixed by the in-flight
|
||
ADR-0042 rework on main; not touched here to avoid conflicts.
|