RafaelFerSilva/refinement-agent-skills

Configurar workspace

Escreva a configuração do workspace que /refine-story, /qa-plan, /requirements-discovery e /meeting-minutes pressupõem. Esta é uma skill guiada por conversa, não um script automatizado: explore, apresente descobertas, confirme e só então escreva os arquivos.

Passos

1. Explorar. Inspecione os arquivos existentes antes de fazer suposições: AGENTS.md e CLAUDE.md na raiz, CONTEXT.md, docs/agents/refinement.md e docs/agents/issue-tracker.md (saídas anteriores desta skill), .scratch/ e sinais de código fonte: package.json, pyproject.toml, src/, go.mod ou qualquer coisa que uma equipe compile ou execute. Se docs/agents/issue-tracker.md já existir de outra convenção, preserve-o: verifique apenas se ele especifica onde publicar. Se CLAUDE.md for meramente uma ponte com @AGENTS.md, o arquivo de instrução primário é AGENTS.md. Concluído quando: você souber se o workspace já está configurado, o modo provável, o idioma provável (en-US ou pt-BR), se existe um glossário, se o rastreador existe e qual arquivo de instrução editar.

2. Perguntar, uma seção de cada vez, começando pela resposta recomendada.

   Modo. Recomende com base nas descobertas: se houver código, com-codigo; se ausente, sem-codigo. Explique em uma linha: com código, o agente inspeciona o código fonte antes de perguntar; sem código, o PO é a fonte dos fatos e questões de arquitetura viram questionários para a equipe.

   Idioma. Recomende com base nos arquivos existentes ou en-US por padrão: en-US ou pt-BR. Explique em uma linha: define o idioma do exame, rodadas de perguntas, narrativas, critérios Gherkin e vereditos.

   Itens de trabalho. As Histórias de Usuário têm origem em um rastreador externo? Se sim, qual a URL base e convenção de campo (por exemplo Azure: <ID> para itens de trabalho do Azure DevOps). Toda HU tem origem lá e cada artefato carrega essa linha de ID.

   Glossário do produto. CONTEXT.md já existe? Se não, nenhuma ação é necessária agora: o primeiro exame que resolver um termo de domínio o criará. Declare isso claramente.

   Concluído quando: modo, idioma, convenção de item de trabalho e URL base estiverem confirmados.

3. Confirmar e escrever. Apresente o rascunho de docs/agents/refinement.md baseado em refinement.md, docs/agents/issue-tracker.md baseado em issue-tracker.md (apenas quando ele ainda não existir) e o bloco ## Refinement para o arquivo de instruções do agente. Permita ajustes. Em seguida, escreva os arquivos. Para o arquivo de instruções: se CLAUDE.md existir e importar AGENTS.md (@AGENTS.md), edite AGENTS.md; caso contrário, edite CLAUDE.md se existir; senão, AGENTS.md se existir; se nenhum existir, pergunte qual criar. Se o bloco ## Refinement já existir, atualize-o no lugar sem modificar o resto do arquivo.

   O bloco:

   ## Refinement
   
   Fluxos de refinamento socrático: execute `/which-flow` para selecionar um fluxo. Modo e convenções estão em `docs/agents/refinement.md`; convenções do rastreador em `docs/agents/issue-tracker.md`. Artefatos estão em `.scratch/<slug>/` com `Status:` e ID do item de trabalho.
   

   Concluído quando: refinement.md, o arquivo do rastreador (novo ou preservado) e o bloco de instrução existirem com conteúdo confirmado.

4. Concluir. Confirme que o workspace está configurado, liste os fluxos de trabalho que leem docs/agents/refinement.md e observe que os arquivos podem ser editados manualmente depois; reexecutar esta skill só é necessário para trocar modos, idiomas ou convenções do rastreador.