jared
/
cc-os
1
0
Fork 0
Code Issues 18 Pull Requests Packages Projects Releases Wiki Activity
cc-os/plugins/os-doc-hygiene/skills/clean/CONTEXT.md

14 lines
1.5 KiB
Markdown
Raw Normal View History

Align os-doc-hygiene skill naming and invocation with marketplace convention Rename skills to bare verbs (hygiene-check -> check, hygiene-clean -> clean), matching the os-vault/os-orchestration pattern. Remove the commands/hygiene.md dispatcher in favor of two new skills, status and sweep, so all four actions are invoked directly as /os-doc-hygiene:<skill> instead of through a custom subcommand parser that no other plugin in the marketplace uses. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-03 15:23:24 +00:00
# clean/
Migrate os-doc-hygiene plugin into cc-os; record ADR-019 Moves the doc-hygiene plugin from the standalone cc-plugins repo into cc-os as plugins/os-doc-hygiene/, following the same pattern as os-vault and os-orchestration. Also commits the previously-unstaged ADR-019 (global os-orchestration plugin supersedes per-project orchestration text), which documents the prior migration but never made it into a commit. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-03 15:12:31 +00:00
The `clean` skill: documentation cleanup orchestrator. Loads the machine report
Align os-doc-hygiene skill naming and invocation with marketplace convention Rename skills to bare verbs (hygiene-check -> check, hygiene-clean -> clean), matching the os-vault/os-orchestration pattern. Remove the commands/hygiene.md dispatcher in favor of two new skills, status and sweep, so all four actions are invoked directly as /os-doc-hygiene:<skill> instead of through a custom subcommand parser that no other plugin in the marketplace uses. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-03 15:23:24 +00:00
from `/os-doc-hygiene:check`, gates confirm-tier entries, applies deterministic ops
Migrate os-doc-hygiene plugin into cc-os; record ADR-019 Moves the doc-hygiene plugin from the standalone cc-plugins repo into cc-os as plugins/os-doc-hygiene/, following the same pattern as os-vault and os-orchestration. Also commits the previously-unstaged ADR-019 (global os-orchestration plugin supersedes per-project orchestration text), which documents the prior migration but never made it into a commit. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-03 15:12:31 +00:00
via the patch applier, delegates generative distillation to a Sonnet subagent,
produces exactly one cleanup commit, and stamps `last_clean`.
## Contents
| File | Purpose |
|------|---------|
| `SKILL.md` | The complete `clean` workflow. Orchestrates 11 steps: load report → re-validate → filter by scope/category → detect incompatible-ops → partition by safety_tier/op_type → confirm gate (BEFORE mutation) → git preflight (baseline + WIP checkpoint) → apply deterministic ops via `patch_applier.py` → apply generative ops via Sonnet subagent → produce cleanup commit via `git-context` → stamp `last_clean`. Rollback on hard failures; commit what applied on partial success. Invariants #4, #5, #6, #7 (confirm precedes mutation), #8 (mtime guard). LOOP-GUARD: subagent prompt points only to `workflows/distill.md`. |
| `workflows/distill.md` | Self-contained generative workflow for distillation subagent. Defines ops: `distill` (condense, preserve frontmatter, ~40–60% target), `split` (extract to archive), prose-rewrite (`provisional`, `contradicted`). Receives live file contents (no disk I/O), performs the rewrite, returns structured output (`DISTILL_RESULT_START`/`END`, `SPLIT_PRIMARY_START`/`END`, `SPLIT_ARCHIVE_DEST`, `SPLIT_ARCHIVE_START`/`END`, or `DISTILL_ERROR`). No file writes, no git calls, no re-reads. Conservative: prefers keeping content when uncertain. |