¿Qué hace Pit-Stop?
Pit-Stop para bases de código: entra, te arreglan, sales más rápido. Una instrucción ejecuta leer → encontrar → corregir → verificar → informar sin preguntas durante la ejecución. El usuario solo dice "adelante"; tú regresas una vez con un informe.
La ejecución (en orden, sin saltos)
- Cargar: lee README/AGENTS.md (o equivalente) +
git status+ puntos calientes de commits recientes. Escribe una línea primero: MODO = qué cuenta como hallazgo aquí, qué se rechaza de plano. ¿Falta un hecho clave? Pregunta UNA VEZ, luego continúa bajo los valores predeterminados más estrictos. - Encontrar: delimita antes de escanear (objetivo nombrado > puntos calientes de git > árbol completo).
Cada hallazgo necesita evidencia
ruta:línea. Omite decisiones registradas a menos que la fricción justifique reabrirlas. Etiqueta cada uno:delete/stdlib/native/yagni/shrink/security/obs, fuerzaStrong/Worth/Speculative. Speculative = solo informar, nunca corregir. ¿No se encontró nada? DiLean already. Ship.— nunca rellenes. - Proponer: solo elementos Strong. Cada uno = síntoma + evidencia + impacto + corrección mínima + costo. Además, una lista de NO-hacer con sus condiciones de activación.
- Corregir: bucle revisión→corrección con un revisor independiente (ángulo diferente supera a los mismos ojos);
detente en limpio o en
--max-rounds(por defecto 3). Registro entre rondas, sin correcciones repetidas. Dos rondas estancadas → escala a "necesita humano", detente. Consultareferences/guardrails.md. - Informar: encabezado
Generado completamente de forma automática por pit-stop. Cuatro bloques: cambiado / verificado (salida de herramienta) / no verificado / restante. Sin afirmación sin salida de herramienta reciente. Redacción de secretos/tokens/PII en todo lo pegado. Consultatemplates/report.md.
Leyes de hierro
- Evidencia antes que afirmaciones, siempre. Sin ejecución de verificación en esta ronda = sin afirmación de éxito.
- El "listo" de un subagente no es listo. Lee su diff antes de informar.
- Puntos difusos degradan, nunca adivines. Escribe "necesita humano", sigue adelante.
- Push/commit nunca automáticos. Los cambios esperan en el directorio de trabajo una palabra explícita.
- Fusible de gasto único: una fase que supere los $20 → detén la fase, escribe el informe.
Detalles: references/phases.md, references/guardrails.md, references/verification.md.