Dependencias externas
Argui no se instala —se adopta como proceso— pero orquesta herramientas que sí se instalan. Esta es la lista completa, por nivel. El criterio que las separa no es “qué tan útil es” sino qué pasa si falta o si cambia de versión.
Niveles
1. Núcleo (requerida y estructural)
OpenSpec — motor del ciclo iterativo (fase 5). Es la única dependencia estructural: el
ciclo se construye sobre su schema y sus comandos (/opsx:*), así que un cambio incompatible
rompe la mecánica de forma silenciosa y en proyectos ya andando. Por eso es la única con versión
fijada y disciplina anti-obsolescencia completa.
- Se inicializa en la fase 0 (con versión fijada, nunca
@latest) y se personaliza en la fase 4. - Detalle, personalización y mantenimiento: openspec.md.
2. Aceleradores de la herramienta (recomendados, no requeridos)
Específicos del asistente (Claude Code y su ecosistema de skills). No son requisito: por el principio de portabilidad, si la herramienta no soporta skills, el contenido de la skill se incluye en el prompt del agente (ver portability.md). Aceleran, no habilitan.
find-skills (vercel-labs) — meta-skill que descubre e instala otras skills del
ecosistema abierto. Es el mecanismo con el que se hace el descubrimiento de skills de la fase 4
(F4.1 y F4.5). Se instala temprano, en la fase 0, porque es la herramienta con la que
luego se consiguen las demás.
npx skills add https://github.com/vercel-labs/skills --skill find-skillsEl comando puede cambiar con el ecosistema
npx skills; verifica el actual en el repo de la skill. No se fija la versión: es una dependencia de arranque, su radio de daño es la sintaxis del comando (falla a la vista, se arregla en el momento), no el ciclo en marcha ni las skills ya instaladas. Esa asimetría con OpenSpec es deliberada.
Skills de dominio (p. ej. frontend-design) — las que cada agente declara y usa siempre
para tareas que lo justifiquen (ver agents.md, efficiency.md). Se
descubren e instalan con find-skills en la fase 4.
metaprompt (genérico) — comando que ayuda a redactar prompts de calidad: las secciones
Expertise/description de los agentes, los instruction de los stages de OpenSpec y la prosa
de las skills (ver agents.md). Argui lo entrega en
templates/commands/metaprompt.md. No es específico ni
estructural; su radio de daño es nulo (mejora un texto que de todos modos revisas).
El catálogo de comandos y skills que Argui entrega o recomienda, mapeado a su fase, está en templates/commands/.
3. Opcionales por fase
Se instalan solo si el proyecto las usa; todas tienen alternativa o son condicionales.
| Herramienta | Para qué | Fase | Nota |
|---|---|---|---|
| Formspree | Feedback del prototipo que llega por correo | 3 | Opcional: alternativa = export Markdown/JSON del andamiaje (templates/prototype/) |
| Playwright | Automatizar QA (Quality Assurance) de frontend | 5 | Solo cuando el gate de costo lo justifica; nunca reemplaza la validación humana (efficiency.md) |
| Node.js 18+ | Correr los scripts del andamiaje del prototipo | 3 | Solo si se usa ese andamiaje |
| UptimeRobot (u otro monitor de uptime) | Disponibilidad: chequeo externo al /health |
5/6 | Gratis; el /health debe responder a HEAD (standards.md §9) |
| Sentry (u otro error tracker) | Errores en runtime → candidatos de Fase 6 | 5/6 | Free 5.000 errores/mes; etiquetar release/git SHA (el hash del commit) |
| GoatCounter (u otra analítica privacy-first) | Uso/tráfico, respetuosa de la privacidad | 5/6 | Open source; gratis no-comercial o self-host |
| bubblewrap + socat | Sandbox nativo del asistente — aislamiento del entorno de IA, Nivel 1 | 0 | Solo Linux; ver operations.md → Aislamiento del entorno de IA |
| Docker | Contenedor de aislamiento duro del asistente, Nivel 2 | 0 | Solo para autonomía total / código no confiable; referencia = devcontainer oficial de Anthropic |
4. Catálogos de referencia (no se instalan)
Se consultan, no se agregan al proyecto.
- context7.com — documentación al día de librerías/APIs (Application Programming Interface)/CLIs (Command Line Interface). Se usa para verificar herramientas externas antes de asumir.
- skills.sh — catálogo y leaderboard de skills; es lo que find-skills consulta por debajo.
Cómo se relaciona con el versionado
Cada release declara en el CHANGELOG contra qué versión de OpenSpec fue validada —es la única que lo necesita, por ser estructural—. Para el resto, una sintaxis de comando que quede vieja es documentación desactualizada, no ruptura del ciclo.