Argui

Portabilidad

Argui es independiente de la herramienta: es un proceso, no un producto de un proveedor. Esta documentación usa el vocabulario de Claude Code porque es la implementación de referencia — la herramienta donde la metodología se practica y refina. Adaptarla a otra herramienta es un ejercicio mecánico de traducción de conceptos, no un rediseño.

Mapa de conceptos

Concepto Argui En Claude Code (referencia) Equivalente en otras herramientas
Archivo de contexto vivo (F0.1) CLAUDE.md AGENTS.md (estándar abierto bajo la Linux Foundation, adoptado por 20+ herramientas), GEMINI.md (Gemini CLI —Command Line Interface—), reglas de proyecto (Cursor)
Agentes (agentes por rol) Subagentes nativos en .claude/agents/*.md con front matter Modos/agentes personalizados de la herramienta; si no hay subagentes nativos, cada agente es un system prompt por rol que se carga al iniciar la sesión correspondiente
Skills .claude/skills/ + slash commands Comandos/reglas reutilizables de la herramienta; si no existen, el contenido de la skill se incluye en el prompt del agente
MCPs (Model Context Protocol) Configuración MCP de Claude Code MCP es un estándar abierto — la mayoría de herramientas agénticas lo soportan
Tiers de modelo (ver efficiency.md) opus / sonnet / haiku Razonamiento alto / medio / económico del proveedor que sea (p. ej. los tiers equivalentes de GPT o de Gemini)
Ciclo iterativo OpenSpec (multi-herramienta por diseño: instala bindings para cada copiloto) El mismo OpenSpec, u otro framework SDD (Spec-Driven Development) con etapas equivalentes
Guarda de gobernanza por ruta (equipos — ver teams.md) CODEOWNERS + protección de rama del forge (GitHub/GitLab/Gitea) Cualquier forge con code owners; sin esa función, un check de CI (Continuous Integration) que valide aprobador/declaración por ruta

Lo que es invariante

Nada del corazón de la metodología depende de la herramienta:

  • Las 7 fases (0–6) y su orden
  • Los puntos de aprobación humana
  • La separación epistemológica de roles (quien implementa no revisa)
  • El prototipo trazable y la consolidación del design system
  • Los estándares antes que los agentes
  • La asignación de recursos por agente (gates, batch, decisión vs. ejecución)

Lo que requiere traducción

  1. El archivo de contexto: el nombre cambia (CLAUDE.md → AGENTS.md/GEMINI.md), el contenido y las reglas de tamaño/automejora son idénticos.
  2. El mecanismo de subagentes: es la diferencia operativa más grande. Donde no hay subagentes nativos, los agentes se ejecutan como sesiones/perfiles separados — más manual, misma estructura. La identidad (sección Expertise) funciona igual en cualquier LLM (Large Language Model).
  3. La tabla de modelos: traducir los tiers a los del proveedor manteniendo la lógica juicio = capaz, mecánico = económico.

Código vs. responsabilidad: qué se distribuye

No todo lo que Argui necesita en un proyecto se distribuye igual. La distinción evita distribuir scripts frágiles que nadie instala ni mantiene:

  • Los mecanismos que deben correr como código se distribuyen como artefactos que se copian al proyecto — solo cuando tienen que existir como código para funcionar. Ejemplo: el runtime del demo del prototipo (templates/prototype/) corre en el navegador del stakeholder; ningún agente puede “ser” ese runtime, así que se entrega como archivos.
  • Los comportamientos que un agente ya ejecuta se especifican como responsabilidad del agente, no como script. Ejemplo: mantener sincronizado el diagrama de dependencias del backlog es trabajo que el agente de progreso ya hace en cada archive; se define en su Expertise y un LLM lo ejecuta sin un parser acoplado al formato — nada que instalar.

Por qué importa para la portabilidad: un comportamiento especificado viaja a cualquier herramienta (es una instrucción para un agente); un script copiado se acopla a un formato y a un runtime concretos, y arrastra el problema de adopción (que lo copien, lo cableen y lo mantengan). Ante la duda, especificar la responsabilidad envejece mejor que distribuir código. El enforcement duro, cuando se quiera, va en el CI que el proyecto ya monta — no en una herramienta nueva que distribuir.

Regla para esta documentación

Al escribir o actualizar la metodología: los conceptos se nombran de forma genérica (archivo de contexto vivo, agente, skill, tier de modelo) y las rutas/comandos concretos se dan en Claude Code como referencia. Quien use otra herramienta traduce con esta tabla.