Como usar
- Copie o comando e verifique o pacote antes de instalar no seu ambiente de agente.
- Consulte no original as ferramentas, credenciais e ambientes necessários.
- Descreva os dados de entrada e a entrega esperada; confira a saída com as fontes.
npx skills add https://github.com/venhdev/zenforge --skill sweepAntes de começar
- A instalação não inclui assinatura de modelo, franquia API ou acesso aos seus arquivos.
- Estrelas e instalações indicam atividade, não um teste independente de qualidade ou segurança.
Documento original do Skill
Renderizado do repositório de origem, preservando títulos, exemplos, código, tabelas, links e imagens.
sweep — Workspace Hygiene & Clean-Purge Engine
Operating Invariants
- Pre-Mutation Gate: Stage all candidate deletions in the Canonical Output Contract and halt for affirmative authorization before deleting files.
- Active Work Preservation: Purge exclusively verified completed artifacts; preserve plan dossiers in
.agents/scratch/plans/containing active phases (PLANNED,CLAIMED,IN_PROGRESS,DRIFTED), task collections containingreadyorin-progresstasks, dirty worktrees, and unmerged branches. - Targeted Scope: Confine deletions strictly to
.agents/scratch/, fully completed.agents/tasks/<feature-slug>/directories, and merged.agents/worktree/paths. - Atomic Execution: Execute approved deletions atomically, prune orphaned git administrative metadata via
git worktree prune, and report reclaimed status.
Domain Rubric
1. Reclamation Dimensions
- Scratch & Dossiers: Temporary scripts (
hitl-loop.sh), subagent traces (*-dossier.md), absorbed spike directories, and completed plan dossiers (COMPLETEDorREJECTED) in.agents/scratch/. - Completed Task Collections: Feature directories under
.agents/tasks/<feature-slug>/where all contained tasks haveStatus: done. - Merged Worktrees & Branches: Clean worktrees under
.agents/worktree/and squash-merged local branches verified viascripts/prune-squashed.sh.
2. State
CLEAN: Workspace contains zero uncollected transient artifacts.STAGED: Reclaimable items identified and staged for user approval.DONE: Approved deletions executed and filesystem state verified.UNRESOLVED: Dirty working trees or unverified task states prevent safe deletion.
Canonical Output Contract
markdown
# Sweep Manifest: Workspace Hygiene · <CLEAN | STAGED | DONE | UNRESOLVED>
| Dimension | Target Coordinate | Reclamation Action |
| :--- | :--- | :--- |
| Scratch | .agents/scratch/<file_or_dir> | Delete ephemeral trace / PoC |
| Tasks | .agents/tasks/<feature-slug>/ | Delete completed feature collection |
| Worktree | .agents/worktree/<branch>/ | Remove worktree and prune metadata |
| Branch | <branch_name> | Delete squash-merged local branch |
Summary: <N> items staged for purge.
*(omit if clean)* Gap: <Blocker preventing deletion, e.g. dirty worktree.>Routing
- Workspace is CLEAN, continue development → (via /forge).
- Unfinished tasks detected during audit → (via /track-tasks).
- Ambiguous branch or task ownership → (via /clarify).
Execution Protocol
- Audit: Scan
.agents/scratch/,.agents/tasks/,.agents/worktree/, and local branches. If clean, outputCLEANand halt. - Stage: Group candidate deletions by dimension, verify all safety constraints (zero uncompleted tasks, zero dirty trees), present
STAGEDmanifest, and halt for authorization. - Purge: On approval, delete staged files/directories, run
git worktree prune, executebash scripts/prune-squashed.sh, and reportDONE.