jared/cc-os

Watch

Fork 0

Merge os-status + os-shortcuts into a general 'os' plugin; switch skill naming to noun-first #294

New issue

Closed

opened 2026-08-06 19:34:54 +00:00 by jared · 2 comments

jared commented

2026-08-06 19:34:54 +00:00

Owner

Context

From the 2026-08-06 grill session. os-status and os-shortcuts have drifting charters and verbose invocations (/os-shortcuts:wrap vs /os:wrap). Decision: merge both into one general-purpose 'os' plugin; carve out dedicated plugins later only when a component's size/purpose justifies it (start general, extract on evidence — matches existing extraction discipline). Bundled second decision: change the skill naming convention from verb-first to noun-first kebab-case, because tab completion is left-to-right — the noun is what the user knows ('frontmatter'), the verb is what they forget, so the noun must be the completion prefix (/os:frontmatter-edit not /os:edit-frontmatter).

Tasks

ADR for the plugin boundary change (merging os-status + os-shortcuts; supersedes/amends whatever ADRs established them separately — run /os-adr:find first).
ADR for the noun-first naming convention change, and update the canonical naming doc plugins/cc-architect/references/conventions/cc-os-naming.md to match (this is a locked-convention reversal: task is NOT complete until the superseding ADR exists).
Execute the merge per the rename/cache-refresh runbook in docs/implementation-status/operational-procedures.md: move both plugins' skills+hooks+references into plugins/os/, re-namespace all skills under the new noun-first convention in one migration (one muscle-memory change, not two), update marketplace/hooks manifests, run bin/refresh-plugins.
Update docs/implementation-status.md index + leaf files per ADR-0032/0073 conventions.

Constraints

If #292's hook has already landed in os-status, it moves into 'os' as part of this migration.
Execution order: second of three — after #292, before the frontmatter registry+skill ticket (which is blocked on this ticket's naming ADR and final plugin home).

## Context From the 2026-08-06 grill session. os-status and os-shortcuts have drifting charters and verbose invocations (/os-shortcuts:wrap vs /os:wrap). Decision: merge both into one general-purpose 'os' plugin; carve out dedicated plugins later only when a component's size/purpose justifies it (start general, extract on evidence — matches existing extraction discipline). Bundled second decision: change the skill naming convention from verb-first to noun-first kebab-case, because tab completion is left-to-right — the noun is what the user knows ('frontmatter'), the verb is what they forget, so the noun must be the completion prefix (/os:frontmatter-edit not /os:edit-frontmatter). ## Tasks 1. ADR for the plugin boundary change (merging os-status + os-shortcuts; supersedes/amends whatever ADRs established them separately — run /os-adr:find first). 2. ADR for the noun-first naming convention change, and update the canonical naming doc plugins/cc-architect/references/conventions/cc-os-naming.md to match (this is a locked-convention reversal: task is NOT complete until the superseding ADR exists). 3. Execute the merge per the rename/cache-refresh runbook in docs/implementation-status/operational-procedures.md: move both plugins' skills+hooks+references into plugins/os/, re-namespace all skills under the new noun-first convention in one migration (one muscle-memory change, not two), update marketplace/hooks manifests, run bin/refresh-plugins. 4. Update docs/implementation-status.md index + leaf files per ADR-0032/0073 conventions. ## Constraints - If #292's hook has already landed in os-status, it moves into 'os' as part of this migration. - Execution order: second of three — after #292, before the frontmatter registry+skill ticket (which is blocked on this ticket's naming ADR and final plugin home).

jared added the

ready-for-agent

labels

2026-08-06 19:34:54 +00:00

jared referenced this issue

2026-08-06 19:47:17 +00:00

Add file_locked frontmatter guard hook for hand-tuned files #292

jared commented

2026-08-06 19:52:01 +00:00

Author

Owner

Work started 2026-08-06 on branch main: merging os-status + os-shortcuts into plugins/os with noun-first skill renames, per ticket tasks 1-4.

jared commented

2026-08-06 20:05:57 +00:00

Author

Owner

Resolution

Done: Merged os-status + os-shortcuts into plugins/os with noun-first skill renames (worktree-start/worktree-finish); ADR-0105 supersedes ADR-0028, ADR-0106 records noun-first naming; naming doc, marketplace manifests, settings, symlinks, status index+leaf updated; caches refreshed

Evidence: commit e98c263 on main; 111 tests passing; claude plugin details os@local-plugins shows 4 skills + 2 hooks

Follow-ups: Stale prose mentions in os-sdlc/os-aidd-lint reference docs captured as issue #295

## Resolution **Done:** Merged os-status + os-shortcuts into plugins/os with noun-first skill renames (worktree-start/worktree-finish); ADR-0105 supersedes ADR-0028, ADR-0106 records noun-first naming; naming doc, marketplace manifests, settings, symlinks, status index+leaf updated; caches refreshed **Evidence:** commit e98c263 on main; 111 tests passing; claude plugin details os@local-plugins shows 4 skills + 2 hooks **Follow-ups:** Stale prose mentions in os-sdlc/os-aidd-lint reference docs captured as issue #295

jared closed this issue

2026-08-06 20:05:57 +00:00

jared referenced this issue from a commit

2026-08-07 10:59:06 +00:00

os: merge os-status + os-shortcuts into general-purpose os plugin, noun-first skill naming (#294)

No milestone

No project

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference

jared/cc-os#294

No description provided.

Rows
Columns