Referencia rápida
Esta página agrupa piezas de consulta frecuente.
Piezas del arnés
Sección titulada «Piezas del arnés»| Pieza | Papel | | --- | --- | | Spec | Fuente de verdad para necesidad, criterios, riesgos y plan. | | Spec Author | Agente que redacta specs y tareas ejecutables. | | Implementer | Agente que construye con contexto y guardarraíles. | | Reviewer | Agente que valida contra spec antes de la revisión humana. | | Contexto | Información estable que guía a la IA dentro del proyecto. | | Skill | Procedimiento repetible versionado. | | MCP | Conector hacia una fuente viva del proyecto. | | Guardarraíl | Regla o check que protege calidad durante el desarrollo. | | Gate | Punto de control antes de QA o merge. |
Archivos de contexto
Sección titulada «Archivos de contexto»| Archivo | Papel |
| --- | --- |
| AGENTS.md | Instrucciones de trabajo para la IA dentro del repositorio. |
| docs/Architecture.md | Arquitectura, módulos, límites y patrones. |
| docs/CodeConventions.md | Convenciones de implementación y revisión. |
| docs/Commands.md | Comandos para lanzar, compilar y validar. |
| specs/README.md | Estructura y reglas para specs. |
| Archivo | Responde a |
| --- | --- |
| spec.md | Qué se pide, alcance, criterios y supuestos. |
| design.md | Cómo se resuelve, arquitectura, riesgos y validación. |
| tasks.md | Cómo se ejecuta, estado de tareas y cierre. |
Comandos conceptuales
Sección titulada «Comandos conceptuales»| Comando | Uso |
| --- | --- |
| /spec-plan PROY-123 | Planificar una tarea a partir de necesidad y contexto. |
| /implement PROY-123 | Ejecutar una tarea elegible de la planificación. |
| /review PROY-123 | Revisar implementación contra spec y guardarraíles. |
| /ds-foundations-sync | Sincronizar foundations de Design System. |
| /ds-component-sync componente | Sincronizar un componente del Design System. |
Glosario
Sección titulada «Glosario»Arnés: conjunto de agentes, instrucciones, contexto, skills, MCPs, guardarraíles y gates que hacen la IA más controlada y orientada a calidad.
Calidad aumentada: uso de IA para reducir ambigüedad, defectos y retrabajo, no solo para generar más rápido.
Reconciliación de spec: actualización de la spec cuando aparece nueva información durante la implementación o revisión.