quinotospec-worktree

Skill: QuinotoSpec Worktree

Usa esta skill cuando quinotospec.apply solicite USE_WORKTREE=true o cuando el usuario pida aislar una implementación en un worktree Git. La skill es prompt-only: valida y guía las operaciones, pero no debe inventar una API nativa ni ocultar errores del proyecto.

Índice

• Contrato de entrada
• Flujo de decisión
• Project Setup
• Baseline limpia
• Fallback sandbox
• Seguridad y límites
• Integración con Apply

Contrato de entrada

• TASK_ID: tarea canónica ya resuelta por Apply.
• BRANCH_NAME: nombre de branch ya resuelto por Apply.
• BASE_REF: referencia base explícita; no la adivines si el repositorio no la define.
• USE_WORKTREE: booleano; por defecto false.
• WORKTREE_PATH: ruta opcional; si falta, selecciona la primera ubicación segura según la prioridad de este documento.

Valida los valores contra el repositorio antes de usarlos. Rechaza rutas con .., separadores inesperados, saltos de línea, NUL y nombres de branch que no cumplan la convención del proyecto. No uses eval.

Flujo de decisión

Step 0: Detectar aislamiento existente

Desde la raíz del repositorio, ejecuta:

repo_root=$(git rev-parse --show-toplevel)
git_dir=$(git rev-parse --git-dir)
git_common=$(git rev-parse --git-common-dir)

Normaliza las tres rutas a rutas absolutas antes de compararlas. Si GIT_DIR != GIT_COMMON, el checkout ya es un linked worktree: no crees otro, reutiliza el contexto existente y registra la ruta y el branch actuales.

Si el directorio no es un repositorio Git, detén el flujo y reporta el bloqueo.

Step 1: Preferir herramientas nativas

1. Detecta si el IDE o agente expone una herramienta nativa de worktree.
2. Pásale la raíz, TASK_ID, BRANCH_NAME, BASE_REF y la ruta solicitada.
3. Verifica el resultado con git rev-parse --show-toplevel, git status --short, git branch --show-current y la comparación GIT_DIR/GIT_COMMON.
4. Solo continúa si la herramienta devuelve un checkout aislado y verificable.