Kit de trabajo/v0.4.0-beta
Las plantillas, listas para copiar.
La metodología te dice qué hacer y por qué; el kit es con lo que lo haces. Son los31 archivos que se copian al proyecto: los documentos que cada fase pide por escrito, los comandos, el andamiaje del prototipo y la configuración del entorno.
Cómo se usa
- Empieza por el CLAUDE.md y elregistro de decisiones: son los dos archivos que el proyecto necesita desde el primer día.
- Copia cada plantilla al proyecto cuando su fase la pida, y rellena los
[corchetes]. El orden lo marcanlas 7 fases. - Instala el aislamiento del entorno antes de dejar trabajar al asistente, y el delta de OpenSpec antes de entrar al ciclo iterativo.
Cada pieza se puede leer completa, copiar o descargar como archivo. Todo el kit se genera desde la misma fuente que la documentación, así que corresponde exactamente a la versión v0.4.0-beta.
Documentos del proceso
Se copian al proyecto y se rellenan en su fase. Son los entregables que el workflow pide por escrito.
- CLAUDE.mdCLAUDE.md.templateEl archivo vivo del proyecto: el contexto permanente que toda sesión de IA lee antes de trabajar. Se reemplaza, no se anexa, y no lleva historia.
- Documento de Entendimientoentendimiento.md.templateEntregable de la fase 1 (F1.2): la síntesis del problema, no de la solución. Sin requisitos ni specs.
- PRD inicialprd-v1.md.templateEntregable de la fase 2: un solo documento que el prototipo materializa y que se itera con él.
- PRD de negocioprd-business.md.templateLa mitad no técnica, al partir el PRD inicial en F3.4 con el prototipo ya aprobado. Los IDs de requisito se conservan.
- PRD técnicoprd-technical.md.templateLa mitad técnica: arquitectura, modelo de datos y declaración de datos sensibles. Es la base del trabajo del arquitecto.
- Backlogbacklog.md.templateEl backlog priorizado que cierra la fase 4, con sus IDs de item y el orden de construcción.
- Artefacto de QAqa-artifact.md.templateDirige la fase qa del ciclo: datos verificados en la base, verificaciones automatizadas y bloques manuales de rol × flujo.
- Registro de decisionesdecisiones.md.templateLog append-only de qué se decidió y por qué. El registro liviano de Argui, en vez de procesos pesados tipo ADR.
- Auditoríaauditoria.md.templateEl artefacto de la auditoría periódica: cuatro focos de revisión más las métricas de entrega. Inmutable una vez cerrada.
- Índice de archivadosarchive-index.md.templateUna fila por change archivado: dónde está la historia de cada capability y qué regla dejó aprendida.
- Inventario de flujosinventario-flujos.md.templateLa matriz rol × flujo × paso del refinamiento (F3.5). De ella salen el backlog, el estimado y el guion de la sesión.
Comandos
Aceleradores para el asistente. La metodología funciona sin ellos; con ellos ahorras trabajo repetido.
- Índice de comandosREADME.mdQué comando y qué skill se usa en cada fase, y cuáles son propios de Argui frente a los que trae el asistente.
- auditoriaauditoria.mdCorre la auditoría periódica —specs, tokens, suite, seguridad— y emite el artefacto fechado.
- prototype-adjustprototype-adjust.mdCiclo de ajuste único al prototipo: al confirmar, propaga el cambio al design system y al PRD.
- recuperar-zonarecuperar-zona.mdArqueología puntual sobre un módulo brownfield antes de tocarlo: completa su spec y corrige el PRD técnico.
- metapromptmetaprompt.mdConvierte una intención en un prompt estructurado y exhaustivo, preguntando lo que falte.
Aislamiento del entorno
Confina al asistente al repositorio —lectura y escritura acotadas, red default-deny— y deja fuera del historial lo confidencial.
- Cómo se instalaREADME.mdQué confina el Nivel 1, qué no cubre y cuándo hace falta el Nivel 2 (contenedor).
- Guía de configuraciónSETTINGS.mdNivel por nivel: qué permite y qué no, con los errores reales de una configuración ingenua, su causa y su arreglo.
- settings.jsonsettings.jsonLa línea base de seguridad del proyecto. Se versiona: todo el equipo la hereda al clonar.
- settings.local.jsonsettings.local.jsonLo específico de cada máquina —toolchains, carpetas externas, dominios propios—, fuera del repositorio.
- .gitignore de partidagitignore.templateLo que no debe entrar al historial se pone el primer día: material de stakeholders, archivos de entorno y volcados de base de datos.
Andamiaje del prototipo
Convierte un HTML estático en el prototipo trazable de la fase 3: insignias por ID de requisito, modo prototipo y feedback por bloque.
- Cómo se usaREADME.mdCómo se cablea el andamiaje en un prototipo: los atributos de trazabilidad, los modos y el export de feedback.
- argui-prototipo.cssargui-prototipo.cssEstilos del marco y del modo prototipo: barra, insignias, notas de aclaración y panel de feedback.
- argui-prototipo.jsargui-prototipo.jsEl runtime: switch de modo, vista limpia, controles de rol/fase/escenario y comentario por bloque.
- check-consistency.mjscheck-consistency.mjsValida que cada ID de requisito citado en el prototipo exista en un PRD, y avisa de los requisitos sin ancla.
- SKILL.mdSKILL.mdLa skill que enseña al asistente a construir e iterar el prototipo con este andamiaje.
Delta sobre OpenSpec
Lo que Argui agrega al schema de OpenSpec. Se aplica sobre un fork generado contra tu versión instalada, no sobre una copia congelada.
- Cómo se aplica el deltaREADME.mdPor qué Argui distribuye un delta y no una copia del schema, y en qué orden se aplica sobre tu fork.
- Stage qaqa-stage.snippet.yamlEl stage que Argui agrega al ciclo, con el protocolo de QA de tres pasos en su instruction.
- Instrucciones de orquestacióninstructions.snippet.yamlLa prosa que dirige a la IA en apply, verify y archive: dónde vive el cuándo se invoca cada agente.
Setup de equipo
Los controles que se instalan una sola vez cuando varios desarrolladores comparten el proyecto.