Trabalhando com agentes

Esta é a parte mais mal lida do Eidos, geralmente como uma limitação esperando para ser removida. É a restrição sobre a qual o resto é construído. Uma spec é uma verificação do código, e uma verificação só é uma verificação se vier de outro lugar. Por quê →

O que um agente faz

Formata. Gera o frontmatter a partir da tabela de propriedades, aplica o template (o modelo), mantém nomes e links na convenção.
Pergunta. Onde você é vago, ele pergunta. Ele não preenche a lacuna com prosa plausível. A resposta certa a uma pergunta de esclarecimento é uma resposta, não “você decide”.
Pressiona o escopo. Com mais força nos non-goals.
Valida. O frontmatter contra a sua tabela de propriedades, as seções contra a variant (variante) do Blueprint, sem campos de acompanhamento de trabalho.
Remodela. Um despejo de ideias no template, mantendo as suas palavras e sem acrescentar nada.
Fala as suas palavras. Você não precisa conhecer o padrão Eidos. Um agente coloca algo novo por conta própria e diz onde, fala spec ou receita em vez de variant ou template, começa com as seções obrigatórias e adiciona o resto só quando o trabalho pede.
Registra o que decidiu. Onde a raiz guarda as decisões como um tipo de registro, uma escolha que o agente fez por conta própria enquanto trabalhava é registrada como uma decisão assinada por ele mesmo (eidos records add <blueprint> decision … --as <alias>), esperando você confirmar. Ele nunca confirma as suas.

Apontando um agente para a CLI

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

Isso escreve uma nota curta: antes de tocar em um Blueprint ou no Framework (a estrutura), rode eidos instructions overview e siga. Os guias encaminham cada passo mecânico a um comando e deixam as decisões com você:

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

Um agente que os segue lê o Framework antes de assumir qualquer coisa (eidos framework), lê quem está na cadeira (eidos whoami), monta o esqueleto com eidos new em vez de montar o frontmatter à mão, muda um valor com eidos property set, muda o Framework com eidos configure:*, valida com eidos check e reconstrói o índice com eidos index. A prosa ele escreve no arquivo, com você. --json nos comandos de leitura dá campos estáveis para scripts.

Deixar o Claude Code executar o eidos

O Claude Code pergunta antes de cada comando para o qual não tem uma regra, e não adiciona uma regra para si mesmo. O Eidos adiciona Bash(eidos:*) a permissions.allow por você, em dois lugares, e cada um mostra antes exatamente o que escreve:

Ao preparar uma raiz nova no app para desktop: com o Claude Code como IA, Let Claude Code run eidos here no passo de IA escreve a regra em .claude/settings.json quando a raiz já existe.
Para o Agente de IA: Permitir os comandos do eidos em Claude Code, na página do plugin Agente de IA, visível enquanto a regra falta, escreve a regra em .claude/settings.local.json dentro da raiz. O Agente de IA inicia o Claude Code na raiz, e o Claude Code lê suas permissões da pasta .claude/ de onde é iniciado e de nenhuma acima, então a regra tem que estar na raiz. Esse arquivo é local: só neste computador, fora do Git, e a página diz qual arquivo permite a regra quando algum permite.

O arquivo da preparação fica no topo do repositório (fora de um, ao lado da raiz). Qualquer um dos dois é criado quando não existe. Todas as outras chaves e regras ficam como estavam, uma regra que já está lá não é adicionada duas vezes, um arquivo que não é JSON válido não é tocado e nada é removido. O arquivo da preparação é compartilhado: faça commit dele e todos os agentes iniciados no topo do repositório podem executar o eidos. A regra cobre um comando que começa com eidos, então o eidos tem que estar no PATH (Help > Put eidos on the PATH no app para desktop, ou npm install -g eidosmd); npx eidos, node …/cli.js e uma linha como cd docs && eidos list continuam perguntando. Uma configuração que a página de um plugin muda também tem seu comando do eidos (eidos plugin set, ou os comandos configure: do plugin), então essa única regra cobre tudo o que o agente faz na raiz. Nenhum comando o escreve e o eidos install nunca mexe nele, então um agente não consegue ampliar as próprias permissões.

Para o Claude Code e o Claude Desktop, um plugin de skills carrega as partes que exigem julgamento e chama a CLI para o resto. Skills do Claude →

Obtendo bons resultados

Defina o seu me.md. Dois minutos com eidos whoami mudam toda resposta depois. Papéis →
Responda às perguntas. Quando ele pergunta se retomar entre contas está no escopo, a resposta é sim ou não.
Traga o pensamento; deixe que ele traga a estrutura. Fale sobre a unidade do jeito que falaria com um colega. Bruto serve.
Corrija quando ele desviar. O trabalho dele é sustentar a sua intenção, não melhorá-la.