Audit os-* plugins against cc-architect standards (post standards-centralization) #70

New Issue

Open

opened 2026-07-16 18:44:13 +00:00 by jared · 0 comments

jared commented

2026-07-16 18:44:13 +00:00

Owner

Context: cc-architect (the plugin-standards meta-plugin) is now globally installed and portable; cc-os now has its own committed .claude-plugin/marketplace.json (all 8 plugins pass structural validation: ruby <cc-plugins>/cc-architect/scripts/validate_marketplaces.rb /home/jared/dev/cc-os — run it to confirm). This ticket is the deeper standards audit, owned by cc-os, to be executed after cc-architect's planned migration into cc-os (Phase B) completes.

Scope: run cc-architect's audit-plugin workflow against each os-* plugin and remediate. Known gaps to address (from a 2026-07-16 survey):

Per-plugin docs wildly uneven: only os-doc-hygiene has CLAUDE.md + CONTEXT.md indexes; os-backlog, os-context, os-sdlc, os-shortcuts, os-status have neither.
invariants.md exists only for os-adr, os-doc-hygiene, os-status.
ADR-0025's Ruby structure standard (lib/ + single dispatcher bin/os-, minitest) — os-adr itself is non-compliant ("grandfathered"); decide whether to retrofit or record the exemption.
os-doc-hygiene retains stale cc-plugins-era references (PRD.md target path says cc-plugins; CLAUDE.md sections titled "per cc-plugins conventions") never reconciled after its 2026-07-03 migration.
The naming convention lives only in an external vault note (~/Documents/SecondBrain/cc-os-plugin-skill-naming-convention.md) — consider folding it into cc-architect's references once migrated.
No test-runner wiring across the mixed pytest/minitest suites; consider a repo-level runner.

Explicitly deferred: this is NOT blocking Phase A/B of the centralization effort.

Discoverer: cc-plugins, session 492d17ff-7fe1-4702-b7a8-7a0be35936cd, 2026-07-16. Surfaced during cc-plugins' Phase A of the standards-centralization effort while confirming cc-os's marketplace.json validates.

Migrated 2026-07-16 from Planka board cc-os, column Backlog (ADR-0042, change retire-planka-git-issues-only).

Context: cc-architect (the plugin-standards meta-plugin) is now globally installed and portable; cc-os now has its own committed `.claude-plugin/marketplace.json` (all 8 plugins pass structural validation: `ruby <cc-plugins>/cc-architect/scripts/validate_marketplaces.rb /home/jared/dev/cc-os` — run it to confirm). This ticket is the deeper standards audit, owned by cc-os, to be executed after cc-architect's planned migration into cc-os (Phase B) completes. Scope: run cc-architect's audit-plugin workflow against each os-* plugin and remediate. Known gaps to address (from a 2026-07-16 survey): - Per-plugin docs wildly uneven: only os-doc-hygiene has CLAUDE.md + CONTEXT.md indexes; os-backlog, os-context, os-sdlc, os-shortcuts, os-status have neither. - invariants.md exists only for os-adr, os-doc-hygiene, os-status. - ADR-0025's Ruby structure standard (lib/ + single dispatcher bin/os-<domain>, minitest) — os-adr itself is non-compliant ("grandfathered"); decide whether to retrofit or record the exemption. - os-doc-hygiene retains stale cc-plugins-era references (PRD.md target path says cc-plugins; CLAUDE.md sections titled "per cc-plugins conventions") never reconciled after its 2026-07-03 migration. - The naming convention lives only in an external vault note (~/Documents/SecondBrain/cc-os-plugin-skill-naming-convention.md) — consider folding it into cc-architect's references once migrated. - No test-runner wiring across the mixed pytest/minitest suites; consider a repo-level runner. Explicitly deferred: this is NOT blocking Phase A/B of the centralization effort. Related PRD: https://github.com/jaredswanson/cc-plugins/issues/13 -------- **Discoverer:** cc-plugins, session 492d17ff-7fe1-4702-b7a8-7a0be35936cd, 2026-07-16. Surfaced during cc-plugins' Phase A of the standards-centralization effort while confirming cc-os's marketplace.json validates. --- Migrated 2026-07-16 from Planka board cc-os, column Backlog (ADR-0042, change retire-planka-git-issues-only).