pax-k/build-right

Habilidades independientes del agente que convierten una idea de aplicación difusa en ejecución de IA respaldada por evidencia.

¿Qué es build-right?

Este skill proporciona una metodología rigurosa y agnóstica al agente para ejecutar tareas de desarrollo de software de manera determinista y basada en evidencia. Está diseñado para usarse después de que el trabajo de pre-ejecución haya establecido la verdad del producto, el alcance del MVP, las reglas operativas y una cola de tareas ejecutable. Su utilidad radica en eliminar la ambigüedad típica de las instrucciones vagas, evitando que el agente tome decisiones incorrectas o amplíe el alcance del proyecto sin supervisión. El skill fuerza un ciclo de trabajo de 'una tarea a la vez', donde cada paso incluye la inspección del estado actual, la captura de evidencia de referencia, la implementación de cambios mínimos, la verificación en capas y la actualización de un rastreador. Soporta plataformas como Claude Code y Cursor, y utiliza scripts auxiliares (como `continue-check.ts` y `execution-check.ts`) para resolver el estado del proyecto y guiar la selección de la siguiente tarea, deteniéndose siempre ante compuertas (gates) que requieren intervención humana o dependencias externas.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add pax-k/build-right

Installed? Explore more Investigación y análisis de datos skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Build Right Execution

Usa este skill después de que el trabajo de pre-ejecución haya producido la verdad del producto, el alcance del MVP, las reglas operativas y una cola de tareas ejecutable.

Regla principal:

Haz una tarea.
Prueba el estado actual.
Cambia de forma limitada.
Verifica con la evidencia adecuada.
Actualiza el rastreador.
Luego pasa a la siguiente tarea.

Lectura Requerida

  • Siempre lee references/workflow.md antes de actuar.
  • Lee references/gates.md antes de seleccionar una tarea, después de recibir una tarea, y antes de avanzar a otra tarea.
  • Lee references/review-and-delegation.md solo cuando se apliquen los desencadenantes de revisión, la revisión por subagente sea útil, o se toquen cambios amplios de evidencia/rastreador.
  • Lee references/evidence-contract.md antes de completar o actualizar una tarea.
  • Lee ../build-right-engineering-principles/references/principles.md antes de implementar o revisar cuando una tarea toque límites de arquitectura, APIs públicas, propiedad de paquetes, adaptadores de proveedores, código generado, semántica de errores, pruebas, observabilidad, seguridad o políticas exigibles.
  • Usa assets/templates/task-template.md al crear una tarea faltante o dividir una tarea demasiado amplia.
  • Usa los scripts auxiliares incluidos solo a través de la forma completa del comando de Bun que se muestra a continuación. No dependas de alias de PATH ni invoques nombres cortos como continue-check como comandos de shell.
  • Usa el resolvedor de estado antes de seleccionar una tarea o avanzar a través de una cola. Informa y concilia su decisión antes de continuar.
  • Usa el asistente de ejecución para señales deterministas de tareas, contratos y compuertas. Trata la salida del script como entrada para el juicio, no como autoridad.

Modo de Operación

  1. Ejecuta el resolvedor de estado de solo lectura cuando esté disponible:

    bun <skill-path>/scripts/continue-check.ts --cwd <project> --format markdown --strict
    
  2. Informa los hallazgos del resolvedor antes de seleccionar trabajo:

    Decisión del resolvedor: <decisión>
    Confianza: <confianza>
    Próxima acción: <próxima acción>
    Próxima tarea: <tarea o ninguna>
    Compuertas bloqueantes: <compuertas o ninguna>
    Seguimientos externos: <seguimientos o ninguno>
    
  3. Sigue la decisión del resolvedor antes de seleccionar trabajo:

    • ask-founder: pregunta o informa sobre la compuerta propiedad del fundador; no continúes.
    • wait-external: informa sobre la compuerta de estado externo; no continúes.
    • create-blocker: crea o propone el bloqueador más pequeño propiedad de IA.
    • no-ready-task: detente e informa que ninguna tarea propiedad de IA está lista.
    • invalid-state: detente y concilia el estado contradictorio del rastreador/compuerta.
    • continue-active-task o execute-task: selecciona exactamente esa tarea.
  4. Ejecuta el asistente de ejecución de solo lectura cuando esté disponible:

    bun <skill-path>/scripts/execution-check.ts --cwd <project> --mode next-task --format markdown
    
  5. Lee la tarea, el rastreador de sprint/hito, los documentos de autoridad y las instrucciones locales del agente.

  6. Imprime la recepción de la tarea:

    Tarea activa: <id o ruta de la tarea>
    Listo significa: <criterios de finalización observables>
    No objetivos: <exclusiones explícitas>
    Base de suposición: <reclamada-por-fundador | inferida-por-ia | suposición-de-protipo | respaldada-por-evidencia-repo | respaldada-por-evidencia-pública | respaldada-por-evidencia-cliente>
    Reversibilidad: <fácil | moderada | difícil>
    Gancho de aprendizaje: <cómo esta tarea producirá evidencia>
    Fuente bajo prueba: <ruta-local-del-repo | ruta-instalada | fuente-de-github | etiqueta-de-lanzamiento | n/a>
    Evidencia de referencia: <artefacto o comando>
    Escalera de verificación: <verificaciones de enfoque a amplitud>
    Destino de la evidencia: <archivo de tarea o archivo de evidencia>
    
  7. Ejecuta el asistente de ejecución en modo task-contract o all cuando exista una ruta de tarea, luego concilia cualquier campo faltante antes de editar.

  8. Inspecciona el estado actual del espacio de trabajo antes de editar.

  9. Captura la evidencia de referencia.

  10. Implementa el cambio más pequeño que satisfaga la tarea.

  11. Verifica en capas.

  12. Ejecuta la revisión del subagente cuando se aplique un desencadenante de revisión requerido y las herramientas del subagente estén disponibles. Si no están disponibles o están prohibidas, registra la revisión omitida y sustituye la verificación antes de cerrar.

  13. Registra la evidencia antes de marcar la tarea como completada.

  14. Actualiza solo el rastreador/documentos relevantes.

  15. Ejecuta el comando completo del resolvedor de estado de Bun y el asistente de ejecución en modo stop-gates antes de seleccionar otra tarea.

  16. Informa los hallazgos del resolvedor nuevamente antes de decidir si es seguro seleccionar otra tarea.

  17. Detente en cualquier compuerta de fundador, estado externo, verificación fallida, tarea obsoleta, discrepancia de fuente, conflicto abierto, propietario no-IA o reclamo de lanzamiento. No avances a la siguiente tarea hasta que la compuerta esté resuelta o se convierta explícitamente en una tarea lista propiedad de IA.

  18. Confirma o entrega según el flujo de trabajo del proyecto.

Regla de No Listo

Si faltan documentos de autoridad, alcance del MVP, reglas de ejecución o archivos de tarea, no finjas que la ejecución está lista. Dirige al usuario a /build-right-preflight o crea el bloqueador más pequeño del Sprint 0 necesario para establecer la superficie de ejecución faltante.

Las tareas de prototipo pueden ejecutarse desde suposición-de-protipo solo cuando la reversibilidad, el gancho de aprendizaje y la validación requerida antes de la verdad del producto sean explícitos.

Para lanzamientos/pruebas manuales del skill, registra la fuente exacta bajo prueba. Si el skill instalado o invocado está desactualizado en comparación con la fuente local del repositorio del skill, marca la prueba como parcial-necesita-repetirse y no avances las compuertas de lanzamiento a listo.

Regla de Alcance

No amplíes el alcance en silencio. Si la tarea revela trabajo no relacionado, crea un problema de seguimiento y continúa solo dentro del límite de la tarea seleccionada.

Compuerta de Detener/Preguntar

Después de cada tarea, verifica si el siguiente paso es realmente propiedad de IA y está listo. Detente y pregunta o informa sobre el bloqueador cuando el siguiente paso requiera:

  • decisiones de producto, posicionamiento, comprador/usuario o MVP propiedad del fundador
  • propiedad de tarea lista o activa que no sea IA
  • conflictos abiertos en docs/conflicts.md
  • descubrimiento externo, indexación de búsqueda, publicación, secretos, servicios de pago o acceso a producción
  • verificación fallida, estado de tarea obsoleto, discrepancia de fuente o evidencia ambigua
  • revisión requerida de subagente que se omitió sin un sustituto equivalente

Continuar a través de una cola preparada solo está permitido mientras cada tarea siguiente esté lista, sea propiedad de IA, esté respaldada por evidencia y no esté bloqueada por una de estas compuertas.

Insignia de Estado Visible al Usuario

Termina cada respuesta final con exactamente un bloque de insignia de estado:

✅ [DONE] Estado: DONE
Decisión: <decisión/resultado>
Próxima acción: <próxima acción o ninguna>
Necesita entrada del usuario: <ninguna | solicitud concisa>
Bloqueado por: <ninguno | bloqueador>

Usa este mapa de estado:

  • ✅ [DONE] Estado: DONE para una tarea completada con evidencia, verificación y actualizaciones del rastreador.
  • 🟢 [GREEN] Estado: ALL GREEN para execute-task o continue-active-task antes de que comience la implementación.
  • 🟡 [YELLOW] Estado: NEEDS INPUT para ask-founder.
  • 🟠 [ORANGE] Estado: NEEDS WORK para trabajo de seguimiento propiedad de IA que aún no es una tarea de ejecución lista.
  • 🔵 [BLUE] Estado: WAITING EXTERNAL para wait-external, publicación, indexación, credenciales, servicios de pago, acceso a producción o estado de terceros.
  • 🔴 [RED] Estado: BLOCKED para create-blocker, no-ready-task, invalid-state, conflictos abiertos, verificación fallida, discrepancia de tarea obsoleta/fuente, propiedad de tarea no-IA o revisión requerida omitida sin sustituto.

Skills relacionados