cérebro-para-documentos

Quando Usar

• Use quando o usuário quiser extrair a visão, decisões ou preferências do projeto em documentos duráveis.
• Use quando README e ADRs devem ser construídos através de uma entrevista de ida e volta.

O propósito inteiro: extrair o máximo possível do gosto, julgamento, conhecimento, visão, preferências e decisões do usuário em texto — salvo como documentos markdown claros e concisos para o projeto. README contém a visão; docs/adr/ contém as decisões.

O loop

1. Verifique os documentos primeiro, sempre. Leia docs/adr/ (e README.md) antes de fazer qualquer coisa — outros agentes e pessoas adicionam/editam ADRs constantemente.
2. Faça um pequeno conjunto de perguntas focadas através da interface de perguntas suportada pelo host ou texto simples — padrão de 2–3 a menos que o usuário peça um número diferente. Faça-as de alta variedade: um espectro criativo amplo de ângulos únicos, não todos do mesmo tipo (por exemplo, não todos "tech stack" ou todos "produto" ou todos "monetização"). Exceção: se o usuário pedir uma área de foco específica, siga-a. O usuário responde o que achar mais útil.
3. Integre as respostas confirmadas nos documentos autorizados. Preserve as perguntas não respondidas e distinga as ideias tentadoras das decisões aceitas. Você decide se atualiza README.md ou se torna um novo ADR — o que fizer sentido.
4. Repita até que o usuário diga "terminamos" (ou similar).

Regras

• Todas as respostas e réplicas durante este processo de "cérebro para documentos" devem ser MUITO CONCISAS, todas as frases devem ser CURTAS, e tudo deve ser escrito na linguagem solicitada pelo usuário.
• ADRs: curtos, numerados NNNN-slug.md, Status + Contexto + Decisão + Consequências.
• README: preserve as seções existentes de instalação, uso e contribuidor. Adicione a visão onde couber; decisões detalhadas vão para os ADRs.
• Não desafie o pensamento do usuário a menos que ele peça, ou ele esteja cometendo um erro grave.

Exemplo

Solicitação do usuário:

Extrair a visão, decisões ou preferências do projeto em documentos duráveis.

Limitações

• Adaptado de davidondrej/skills; verifique caminhos locais, ferramentas, credenciais e recursos do agente antes de agir.
• Para comandos, acesso remoto, agendamento, automação de navegador ou fluxos de trabalho de alteração de arquivos, obtenha aprovação explícita do usuário e confirme o ambiente de destino primeiro.