Trabajar con agentes

Esta es la parte peor leída de Eidos, normalmente como una limitación esperando a levantarse. Es la restricción sobre la que se construye el resto. Una spec es un control sobre el código, y un control solo es un control si viene de otro sitio. Por qué →

Qué hace un agente

Da formato. Genera el frontmatter a partir de la tabla de propiedades, aplica el template (la plantilla), mantiene nombres y enlaces en la convención.
Pregunta. Donde eres vago, pregunta. No rellena el hueco con prosa plausible. La respuesta correcta a una pregunta aclaratoria es una respuesta, no «decide tú».
Presiona sobre el alcance. Con más dureza en los non-goals.
Valida. El frontmatter contra tu tabla de propiedades, las secciones contra la variant (variante) del Blueprint, sin campos de seguimiento de trabajo.
Remodela. Un volcado de ideas en el template, conservando tus palabras y sin añadir nada.
Habla tus palabras. No necesitas conocer el estándar Eidos. Un agente coloca algo nuevo por su cuenta y te dice dónde, dice spec o receta en lugar de variant o template, lo empieza con las secciones obligatorias y añade el resto solo cuando el trabajo lo pide.
Registra lo que decidió. Donde la raíz guarda las decisiones como un tipo de registro, una elección que el agente hizo por su cuenta mientras trabajaba queda registrada como una decisión firmada por él mismo (eidos records add <blueprint> decision … --as <alias>), en espera de que tú la confirmes. Nunca confirma las suyas.

Apuntar un agente a la CLI

eidos agents --write                # AGENTS.md
eidos agents --write --file CLAUDE.md

Esto escribe una nota breve: antes de tocar un Blueprint o el Framework (el marco), ejecuta eidos instructions overview y síguelo. Las guías dirigen cada paso mecánico a un comando y dejan las decisiones contigo:

eidos instructions overview         # required first read
eidos instructions authoring        # before creating or editing a blueprint
eidos instructions validating       # before reviewing a blueprint or a root
eidos instructions configuring      # before changing the framework
eidos instructions init-required    # when there is no root yet

Un agente que las sigue lee el Framework antes de dar nada por supuesto (eidos framework), lee quién ocupa el asiento (eidos whoami), levanta la estructura con eidos new en lugar de montar el frontmatter a mano, cambia un valor con eidos property set, cambia el Framework con eidos configure:*, valida con eidos check y reconstruye el índice con eidos index. La prosa la escribe en el archivo, contigo. --json en los comandos de lectura da campos estables para scripts.

Dejar que Claude Code ejecute eidos

Claude Code pregunta antes de cada comando para el que no tiene una regla, y no se añade una regla a sí mismo. Eidos añade Bash(eidos:*) a permissions.allow por ti, en dos sitios, y cada uno muestra antes exactamente lo que escribe:

Al preparar una raíz nueva en la app de escritorio: con Claude Code como IA, Let Claude Code run eidos here en el paso de IA la escribe en .claude/settings.json cuando la raíz ya existe.
Para el Agente de IA: Permitir los comandos de eidos en Claude Code, en la página del plugin Agente de IA, visible mientras falta la regla, la escribe en .claude/settings.local.json dentro de la raíz. El Agente de IA inicia Claude Code en la raíz, y Claude Code lee sus permisos de la carpeta .claude/ de donde se inicia y de ninguna superior, así que la regla tiene que estar en la raíz. Ese archivo es local: solo en este equipo, fuera de Git, y la página dice qué archivo permite la regla cuando alguno lo hace.

El archivo de la preparación va en la carpeta superior del repositorio (fuera de uno, junto a la raíz). Cualquiera de los dos se crea si no existe. Todas las demás claves y reglas quedan como estaban, una regla que ya está no se añade dos veces, un archivo que no es JSON válido no se toca y nunca se quita nada. El archivo de la preparación es compartido: haz commit de él y todos los agentes iniciados en la carpeta superior del repositorio podrán ejecutar eidos. La regla cubre un comando que empieza por eidos, así que eidos tiene que estar en el PATH (Help > Put eidos on the PATH en la app de escritorio, o npm install -g eidosmd); npx eidos, node …/cli.js y una línea como cd docs && eidos list siguen preguntando. Un ajuste que cambia la página de un plugin también tiene su comando de eidos (eidos plugin set, o los comandos configure: del plugin), así que esa única regla cubre todo lo que el agente hace en la raíz. Ningún comando lo escribe y eidos install nunca lo toca, así que un agente no puede ampliar sus propios permisos.

Para Claude Code y Claude Desktop, un plugin de skills lleva las partes que exigen criterio y llama a la CLI para el resto. Skills de Claude →

Obtener buenos resultados

Configura tu me.md. Dos minutos con eidos whoami cambian cada respuesta posterior. Roles →
Responde a las preguntas. Cuando pregunta si reanudar entre cuentas entra en el alcance, la respuesta es sí o no.
Pon tú el pensamiento; deja que él ponga la estructura. Habla de la unidad como lo harías con un colega. En bruto está bien.
Corrígelo cuando se desvíe. Su trabajo es sostener tu intención, no mejorarla.