spec-de-fase
Skill0 starsChanged 3 days agoMITView on GitHub
Inicia a próxima fase do roadmap — encontra a fase pendente em specs/roadmap.md, cria a branch, entrevista o usuário sobre escopo, decisões e contexto e escreve specs/AAAA-MM-DD-nome/ com requirements.md, plan.md e validation.md. Use quando o usuário disser "próxima fase", "especificar a fase", "spec de feature", "vamos começar a fase X" ou invocar /spec-de-fase.
In this repository15 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- adrSkill
- auditar-specsSkill
- changelogSkill
- configurarSkill
- constituicaoSkill
- diagnosticoSkill
- implementar-faseSkill
- iniciar-conversaSkill
- iniciar-sddSkill
- licaoSkill
- replanejar-roadmapSkill
- sessao-gerenteSkill
- validar-faseSkill
The file
Files
Spec de fase
Lê: specs/roadmap.md (a próxima pendente), specs/mission.md, specs/tech-stack.md e as
specs das fases anteriores.
Escreve: specs/AAAA-MM-DD-<nome>/ com requirements.md, plan.md e validation.md; e cria
a branch da fase.
Decide: entrevista antes de escrever. Fase pequena usa o formato curto do AGENTS.md, se
ele existir, em vez de improvisar uma "spec enxuta".
Arquivos de referência
| Ao fazer | Leia |
| a entrevista (passo 3) | references/entrevista.md |
escrever validation.md (passo 5) | references/validacao.md |
Fluxo
1. Achar a fase
grep -n "^## Fase" specs/roadmap.md # a ordem da fila é a ordem das seções
ls specs/ # quais fases já têm pasta de specCada fase é uma seção ## Fase N: Nome, com a marca [ ], [~] ou [x] no título. A próxima é
a primeira seção marcada [ ] que ainda não tem pasta em specs/. O [ ] também marca itens
soltos dentro das seções: não confunda item com fase. Havendo ambiguidade, confirme com o usuário.
Derive do nome da fase o nome em kebab-case.
2. Criar a branch
O nome é fase-<<N>>-<<nome-kebab>> (ex.: fase-3-horarios-livres). Primeiro, veja se há remoto:
git remoteCom remoto (a saída traz
origin): crie a partir daorigin/main, sem trocar para amain. Num worktree, amainjá está aberta na pasta principal e ogit checkout mainfalha.git fetch origin && git switch -c fase-<<N>>-<<nome-kebab>> origin/mainSem remoto (a saída vem vazia): crie a partir da branch atual.
git switch -c fase-<<N>>-<<nome-kebab>>
Se várias conversas trabalham em paralelo, confira antes que o número da fase está livre (roadmap,
git branch -a) e avise a conversa gerente (GER) que a fase começou.
3. Entrevistar, antes de escrever qualquer arquivo
Uma rodada só, agrupada em escopo, decisões e contexto. As perguntas estão em
references/entrevista.md. Se a resposta exigir algo fora de specs/tech-stack.md, pare: isso é
proposta de mudança de stack e precisa de aprovação humana antes de virar spec.
4. Ler a constituição e os precedentes
specs/mission.md, specs/tech-stack.md e as specs das fases anteriores, para repetir padrões já
estabelecidos em vez de inventar novos.
5. Escrever specs/AAAA-MM-DD-<<nome>>/
requirements.md: escopo, fora de escopo, decisões com justificativa e alternativa descartada, contexto, "padrões a seguir" (o arquivo do repositório que serve de modelo), as notas do usuário (com as palavras dele e a data) e o teto de gasto, se houver. Modelo emtemplates/fase/requirements.md, quando o projeto o tiverplan.md: grupos numerados de tarefas, cada grupo implementável e revisável sozinho; o último grupo é sempre verificação. Com o "parar a cada parte" do bloco "Como o Golem trabalha aqui" (AGENTS.md), cada grupo tem o tamanho de um arquivo ou de uma função: é o passo que o usuário aprova. Inclua a tabela vazia "Alterações de escopo durante a fase"validation.md: conformereferences/validacao.md
Fato que sustenta decisão vem com fonte. Cada afirmação sobre o código ou o ambiente leva
arquivo:linha e o commit em que foi lida. Decisão do usuário entra com as palavras dele e a data;
o que ela implica tecnicamente fica "a conferir" até alguém verificar o caminho (o host, a
credencial, o comando). Spec escrita de memória é a origem mais comum de retrabalho.
Se a fase gasta dinheiro (API paga, serviço por uso), o teto entra no requirements.md, na seção
"Teto de gasto", e o usuário o aprova junto com a spec.
6. Fechar
Resuma a spec e pare. A implementação é outro passo, com aprovação explícita do usuário. Termine
a mensagem com o fecho do projeto (Resumo, O que você faz agora, Worktree, Espera; formato em
docs/operacao-das-conversas.md).
Restrições
- Nada de dependência fora de
specs/tech-stack.mdsem aprovação humana - Escopo de uma fase = uma branch mergeável; se não couber, proponha dividir o roadmap
- Critério de validação vago precisa ser reescrito como comando ou passo a passo
- A spec vai à
mainantes do código da fase, quando oAGENTS.mdassim mandar
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

