Cómo usar
- Copia el comando y revisa el paquete antes de instalarlo en tu entorno de agente.
- Consulta las herramientas, credenciales y entornos necesarios en el documento original.
- Describe las entradas y el resultado deseado; contrasta la salida con las fuentes.
npx skills add https://github.com/venhdev/zenforge --skill worktreeAntes de empezar
- La instalación no incluye suscripción al modelo, cuota API ni permisos sobre tus archivos.
- Las estrellas e instalaciones reflejan actividad, no una prueba independiente de calidad o seguridad.
Documento original del Skill
Contenido del repositorio de origen con títulos, ejemplos, código, tablas, enlaces e imágenes preservados.
worktree — Isolated Session & Branching Engine
Operating Invariants
- Path Isolation: Confine all branch edits, shell commands, and test executions strictly within
.agents/worktree/<branch>; forbid modifying root repository files from a worktree session. - Dirty Tree Breaker: Verify working tree cleanliness via
git status --porcelainbefore deleting a worktree; forbid deleting worktrees containing uncommitted modifications. - Pre-Mutation Gate: Stage worktree creation or removal in Canonical Changeset format and halt turn immediately; forbid executing worktree mutations on disk without affirmative human authorization.
Domain Rubric
1. Naming & Storage Conventions
<branch>: Strictly format as<type>/<slug>(feat/,fix/,refactor/,chore/,test/).<path>: Dedicated path strictly under.agents/worktree/<branch>.- Privacy Anchor: Root
.gitignoremust contain.agents/worktree/.
2. Supported Worktree Operations
[CREATE]: Add a new worktree branch checked out at target path.[DELETE]: Remove worktree directory and prune git administrative metadata.[LIST]: Inspect active worktrees and associated branches.[PRUNE]: Clean up squash-merged branches safely viascripts/prune-squashed.sh.
Canonical Output Contract
text
# Changeset: Git Worktree <Action>
`-- .agents/worktree/<branch>/
`-- [<ACTION>] <Worktree operation summary>.
Summary: 1 worktree affected (<branch>).Execution Protocol
Phase 1: Pre-flight & Collision Audit
- For create: Inspect
git worktree listand verify no branch or directory collision exists. - For delete: Inspect
git status --porcelaininside target<path>. If dirty, halt immediately and report uncommitted files. - For list: Run
git worktree listand present active worktrees, halting turn immediately.
Phase 2: Staging & Authorization Gate
- Stage the planned worktree modification in Canonical Changeset format.
- Present the staging summary and halt turn immediately for human authorization.
Phase 3: Atomic Execution & Handoff
- On approval, execute the required operation:
- Create:
git worktree add <path> -b <branch> <base_ref> - Delete:
git worktree remove <path> && git worktree prune - Prune:
bash scripts/prune-squashed.sh <target_branch>
- Report operation completed with the absolute workspace path for IDE navigation.