cc-os/plugins/os-doc-hygiene/skills/sweep/SKILL.md

26 lines
1.1 KiB
Markdown
Raw Normal View History

---
description: Run doc-hygiene check then clean in sequence — a convenience wrapper. The confirm gate in `clean` still applies; sweep never auto-approves confirm-tier or generative entries. Invoked by `/os-doc-hygiene:sweep [--scope <glob-or-path>] [--category <class|subtype>]`.
---
# Sweep Skill
`sweep` is check-then-clean: a convenience that runs both skills in sequence,
passing the same `--scope` and `--category` through to each.
## Workflow
1. **First**, invoke the **`check`** skill (Skill tool, `skill: "check"`),
passing `--scope` and `--category` verbatim. Surface the check summary to
the user.
2. **Then**, invoke the **`clean`** skill (Skill tool, `skill: "clean"`),
passing the same `--scope` and `--category` verbatim.
The confirm gate in `clean` applies identically under `sweep` — sweep does
**not** auto-approve any confirm-tier or generative entries (invariant #7).
The user will still be prompted to approve any entries that require it before
any file mutation occurs.
`sweep` produces at most one cleanup commit (the clean step); the check step
writes only to the gitignored `.dochygiene/` and does not commit.