¿Qué hace astro:help — cómo usar la esteira?
La esteira astro: es un conjunto de skills para desarrollar con IA desde el contrato hasta el PR/entrega, con una guarda de código (el gate) que hace cumplir las barreras de seguridad. Cada skill es una fase; úsalas en orden, pero invoca solo lo que necesites.
La esteira de un vistazo
| Fase | Comando | Cuándo usarlo |
|---|---|---|
| 0 · contrato | astro:setup | Al iniciar/retomar un proyecto, antes de escribir código. |
| 1 · planificar | astro:plan | Describiste un cambio y quieres un plan antes de implementar. |
| 2 · ejecutar | astro:exec | Ejecuta el plan completo, una tarea por vez. |
| 3 · cerrar | astro:commit | Generar el mensaje y commitear un cambio lógico. |
| 3 · cerrar | astro:pr | Armar la descripción del Pull Request. |
| 3 · cerrar | astro:answer | Texto de entrega de la tarea para QA/PO (archivo local). |
| gate | astro:gate | Abrir el editor de reglas del gate en el navegador. |
| ayuda | astro:help | Esta guía. |
Flujo típico
astro:setup(una vez por proyecto) — firma el contrato enCLAUDE.md(barreras + estándares), detecta la stack y, en Laravel, descarga la arquitectura y asegura unAGENTS.mdpor dominio. Instala el gate: la mini-appai-gate/(SQLite) genera el.claude/hooks/astro_gate.pyy registra el hook que bloquea comandos prohibidos.astro:plan— describes el cambio; se sitúa, pregunta solo lo que es decisión tuya (AskUserQuestion), propone un plan y, tras tu OK, lo descompone en tareas en la sesión (sin crear archivos en el proyecto).astro:exec— ejecuta el plan, una tarea por vez, implementando solo el alcance, siguiendo el contrato y la arquitectura, con pruebas reales (salida real).astro:commit— mensaje en formatoTIPO: Título+ lista de cambios (es-ES, participio pasado); un commit por cambio lógico.- Cerrar:
astro:pr(descripción del PR) y/oastro:answer(texto de entrega para QA/PO, guardado en un archivo local no commiteable).
El gate (el código garantiza)
El prompt orienta, el gate garantiza: toda ejecución de comando es inspeccionada y bloqueada si contiene texto prohibido (migrate:fresh, rm -rf, git push --force, truncate…). Las reglas son editables:
astro:gate(opython3 ai-gate/app.py) abre la UI (http://127.0.0.1:8787) para añadir/editar/desactivar reglas; Generar gate reescribe el.claude/hooks/astro_gate.py.- El gate generado es autónomo — también funciona como CLI en la VM/CI:
python3 astro_gate.py "$CMD" && eval "$CMD".
Principios que aplican en todas las fases
- Pregunta lo que es decisión tuya; decide el resto (con valor por defecto seguro, avisando la suposición).
- Confirma en la fuente, no inventes API/ruta/columna/versión.
- Cambios pequeños y revisables; pruebas junto; evidencia real, no afirmaciones.
- Nada destructivo, sin secretos, sin subir dependencia — y el gate refuerza esto.