Planifica un enfoque de implementación ANTES de escribir cualquier código. Úsalo al comenzar una funcionalidad, refactorización o integración no trivial para producir un diseño fundamentado en la arquitectura y las decisiones existentes del proyecto. Solo lectura y centrado en la planificación.
Revisa el diff actual para verificar la correctitud y la adherencia a las convenciones del proyecto. Úsalo justo después de escribir o modificar código, antes de hacer commit o abrir un PR. Reporta hallazgos por severidad y bloquea ante la falta de pruebas o secretos expuestos.
Reproduce un fallo reportado, aísla su causa raíz y propone la corrección mínima. Úsalo cuando haya una prueba fallida, un error o un reporte de bug que diagnosticar. Corrige solo la causa; no refactoriza más allá de eso.
Mantiene la documentación sincronizada después de un cambio de código. Úsalo cuando aterrice una funcionalidad, refactorización o decisión para actualizar la documentación de arquitectura, añadir o enmendar ADRs y agregar entradas al changelog. No toca el código de producción.
Mapea cómo está organizado el código base y localiza dónde vive el código relevante para un tema dado. Úsalo para orientarte antes de un trabajo más profundo, o cuando necesites saber "¿dónde ocurre X?" Solo lectura; devuelve un mapa conciso, no volcados de archivos.
Revisa un conjunto de cambios frente a la política de seguridad del proyecto en busca de problemas de secretos, autorización, inyección y validación de entradas. Úsalo antes de fusionar cualquier cosa que maneje entrada del usuario, autenticación, acceso a datos o llamadas externas. Solo lectura; señala patrones…
Escribe y amplía pruebas automatizadas siguiendo las convenciones de pruebas del proyecto, y luego ejecuta la suite de pruebas. Úsalo cuando el código nuevo carezca de cobertura o cuando añadas pruebas para una corrección de error o una funcionalidad. Cubre el camino feliz más los casos límite.
Runs before the agent uses a tool for Bash, Write and Edit tool calls, executing git-guardrails.sh and secret-guardrails.sh (2 commands). From brayandiazc/project-starter-template-es-ai.
Revisa los cambios de UI en cuanto a accesibilidad — contraste de color, navegación por teclado, gestión del foco, uso de ARIA y texto alternativo. Úsalo cuando la persona pida una revisión de a11y/accesibilidad, verificar el cumplimiento de WCAG, el soporte de teclado, la compatibilidad con lectores de pantalla o el…
Trae a este proyecto las mejoras que la plantilla de origen recibió después de la instanciación — lee .template-origin, calcula el diff del tooling (skills, hooks, scripts, workflows) contra la plantilla actual y propone aplicarlo. Úsalo cuando la persona quiera actualizar/sincronizar el proyecto con la plantilla (p.…
Actualiza CHANGELOG.md en el formato Keep a Changelog, añadiendo los cambios actuales bajo la sección Unreleased. Úsalo cuando la persona pida actualizar el changelog, añadir una entrada al changelog o registrar lo que cambió para las notas de la versión (p. ej. "añade esto al changelog", "actualiza el CHANGELOG con…
Escribe un mensaje de Conventional Commits para los cambios en stage y crea el commit, incluyendo la línea de coautoría de atribución de IA. Úsalo cuando la persona pida hacer commit, escribir un mensaje de commit o guardar cambios (p. ej. "haz commit de esto", "escribe un mensaje de commit para estos cambios"). No…
Revisa o produce textos visibles para la persona usuaria (texto de UI, encabezados, botones, mensajes de error, marketing) con la voz y el tono del proyecto. Úsalo cuando la persona pida escribir/mejorar textos, corregir la redacción, revisar el tono o redactar microcopy (p. ej. "escribe el texto del estado vacío"…
Audita el código de UI frente al sistema de diseño del proyecto — tokens semánticos, componentes permitidos, estados de interacción requeridos y la línea base de accesibilidad. Úsalo cuando la persona pida auditar/revisar el cumplimiento del sistema de diseño, verificar que se usen tokens en lugar de valores crudos, o…
Verifica la paridad de internacionalización — que cada clave de traducción exista en todos los idiomas y que no haya cadenas visibles para la persona usuaria codificadas de forma fija — siguiendo las convenciones de i18n del proyecto. Úsalo cuando la persona pida revisar las traducciones, verificar la paridad entre…
Instancia esta plantilla en un proyecto real mediante una entrevista guiada — detecta si el proyecto es nuevo o existente, rellena los placeholders, adapta los docs al tipo de proyecto y decide la política de permisos. Úsalo cuando la persona clone/adopte esta plantilla y quiera configurarla para su proyecto (p. ej.…
Revisa una migración de base de datos antes de desplegarla para asegurar que sea segura — reversible, no destructiva y compatible hacia atrás — siguiendo las convenciones de base de datos del proyecto. Úsala siempre que crees, revises o apruebes una migración de esquema o de datos (p. ej. "revisa esta migración", "¿es…
Genera un nuevo Registro de Decisión de Arquitectura (ADR) copiando la plantilla de ADR en el siguiente archivo numerado y registrándolo en el índice de decisiones. Úsalo cuando la persona quiera registrar una decisión de arquitectura, crear/añadir un ADR o documentar una elección técnica (p. ej. "escribe un ADR para…
Genera una nueva especificación de cambio ligera copiando el directorio de plantilla de especificación en una carpeta de especificación con nombre. Úsalo cuando la persona quiera iniciar una especificación, planificar un cambio/funcionalidad o crear un documento de diseño antes de implementar (p. ej. "especifica el…
Redacta y crea un issue de GitHub rellenando la plantilla adecuada de .github/ISSUETEMPLATE/ según el tipo (bug, funcionalidad, documentación, tarea o pregunta). Úsalo cuando la persona pida abrir/crear un issue, reportar un bug o registrar una tarea/petición (p. ej. "abre un issue por este bug", "crea un issue para…
Redacta un pull request para la rama actual rellenando la plantilla de PR del repositorio en función de los cambios de la rama. Úsalo cuando la persona pida abrir/crear un PR, preparar un pull request o escribir la descripción de un PR (p. ej. "abre un PR", "redacta el pull request de esta rama"). No hace merge.
Porta el cambio de la rama actual a las variantes hermanas de esta plantilla (es/en × con-IA/sin-IA) — traduce el contenido, adapta o elimina la capa de IA según el destino y deja cada variante con una rama lista para PR. Úsalo cuando un cambio del template deba replicarse en las otras variantes (p. ej. "porta este…
Mejora la estructura y la legibilidad del código SIN cambiar el comportamiento observable, en pasos pequeños y seguros guiados por las convenciones del proyecto, manteniendo los tests en verde. Úsalo cuando la persona pida refactorizar, limpiar, reestructurar o reducir la duplicación en el código sin añadir…