fr-goal
Um ponto de contato do operador, do objetivo ao PR revisado: brainstorming de contexto → UM lote de Perguntas e Respostas → especificação → revisão → fr-plano → revisão → implementação TDD → revisão → PR único. Cada revisão corrige tudo o que encontra; a instrução de autonomia do operador substitui cada pausa de aprovação dos superpoderes por uma passagem de revisão-e-correção. Quando bloqueado: pare, diga o que está bloqueado e o que você tentou, e pergunte — um palpite errado enviado em um PR custa mais do que uma execução pausada.
Anuncie no início: "Estou usando fr-goal para executar este objetivo autonomamente."
O que permanece interativo
| Momento | Por quê |
|---|---|
| O lote de Perguntas e Respostas (uma vez, no brainstorming) | As decisões de design pertencem ao operador — sem resposta = pare, nunca use o padrão |
| Localização do repositório multi-projeto | Pergunta de acesso — somente se o sistema de arquivos não conseguir responder |
| Fases manuais | Segredos, operações de UI, deploys são exclusivamente humanos — veja política de posicionamento |
| Merge do PR | O agente nunca faz auto-merge |
| Plano de Teste pós-merge | Comprova implantação real; precisa do ambiente do operador |
1. Brainstorming com Perguntas e Respostas em lote — em isolamento
Invoque fr-brainstorming (executa fr isolation up primeiro; nenhum perfil devcontainer → pausa para a entrevista fr-init). O isolamento precede TUDO — exploração, medições, operações de cluster incluídas; um operador "comece com X" altera o primeiro item de trabalho, nunca a primeira ação. Explore, colete TODAS as decisões de propriedade do operador, pergunte todas em UMA chamada AskUserQuestion (máx. 4 perguntas, recomendado primeiro). Inclua uma pergunta de Plano de Teste pós-merge SOMENTE quando o entregável for implantado (serviço/bot/infra), nunca código puro. Agrupe perguntas atrasadas. Barreira rígida: uma chamada sem resposta é um sinal de parada — encerre o turno reafirmando as perguntas em aberto e aguarde; nunca substitua os padrões por uma resposta real.
2. Especificação — depois revise-a
Escreva docs/superpowers/specs/<YYYY-MM-DD-slug>-design.md, depois revise-a em relação às respostas das Perguntas e Respostas E à realidade do código (os arquivos/helpers/serviços que ela nomeia existem?). Corrija cada descoberta. Plano de Teste escolhido → a especificação carrega uma seção ## Test Plan com etapas pós-merge.
3. Verificação multi-projeto
Para uma especificação cross-repo (formato owner/repo:path), esta sessão é dona do plano e PR de UM repo. Para cada outro repo: localize sua cópia de trabalho você mesmo (diretórios irmãos, raízes usuais); pergunte por um caminho/clone somente se não encontrado — agrupe nas Perguntas e Respostas. Despache um agente por repo (isolation: "worktree") com a referência da especificação e este pipeline a partir da etapa 4. Um plano, um PR por repo.
4. Plano — fr-plano, depois revise-o
Invoque fr-plan, pulando aprovações seção por seção (a especificação codifica o design). Mantenha o plano v2 como pasta, etapas em formato TDD. Revise: fr plan self-review deve passar e as fases devem corresponder à especificação (todas cobertas). Corrija, implemente.
5. Fases manuais — back-load por padrão
O gate de pureza agentic do fr-plano coleta trabalho manual em fases [manual] dedicadas. O fr-goal adiciona política de posicionamento (uma fase manual no meio do plano trava a execução):
- Back-load por padrão: TODO trabalho manual na ÚLTIMA fase, nenhuma fase agentic dependendo dela. O PR a envia deliberadamente não implementada, marcada para o operador, que implementa e envia para o mesmo PR (
fr plan edit --complete-phase N --note). - Front-load somente quando o trabalho agentic realmente depender dela. Finalize plano + revisão, abra um PR de especificação + plano (as instruções manuais SÃO o entregável), pause; retome SOMENTE com o sinal verde do operador.
- Multi-repo: modele dependências cross-repo —
depends_oné apenas intra-plano, então a ordenação vive na especificação e no sequenciamento de PRs (um segredo em um repo pode bloquear fases de outro).
6. Implemente — fr-execute modo local, TDD, sem subagentes
O workspace de isolamento da etapa 1 é a cópia de trabalho — todo comando através de fr isolation exec. Execute fases via fr-execute no modo LOCAL (diretório-do-plano + fase), NÃO despachado (especificação/plano não estão na main, fr apply --yes recusa). Implemente inline, não via subagentes (o contexto precisa do histórico de Perguntas e Respostas + especificação). TDD por etapa; marque etapas / complete fases via fr plan edit. Nunca uma fase manual.
A camada de implementação envia o branch SOMENTE — nunca abre o PR (inline, ou um builder delegado multi-repo). Abri-lo aqui reordena a entrega (8) antes da revisão (7), permitindo que o operador faça merge antes que as correções existam — elas órfãs em um branch merged (#320, 3×). O orquestrador abre um PR rascunho para visibilidade — sem possibilidade de merge até a etapa 8, seu selo "Rascunho" significa "não faça merge ainda".
7. Revise nos marcos — corrija tudo o que encontrar
Após cada marco (fase completa, ou implementação total para planos pequenos), invoque superpowers:requesting-code-review sobre especificação + plano + código. Corrija cada descoberta imediatamente, com testes; uma factualmente errada recebe raciocínio de refutação (superpowers:receiving-code-review), nunca uma rejeição silenciosa. Mantenha uma lista de descobertas.
8. Entregue — um PR por repo, todos os artefatos a bordo
Verifique primeiro (superpowers:verification-before-completion): saída completa da suíte de testes, auto-revisão aprovada, etapas marcadas. O PR fica com merge possível SOMENTE agora (após as correções da etapa 7): gh pr ready no rascunho — nunca diga "pronto para merge" antes disso. Corpo do PR: resumo + caminhos da especificação/plano; descobertas da revisão e suas correções (mais qualquer descoberta refutada); a fase manual back-load marcada como "não implementada — operador envia para este PR"; o Plano de Teste literal, rotulado "pós-merge — operador executa". Pare; o operador faz o merge.
9. Encerramento pós-merge
Quando o operador reportar o merge: primeiro verifique se a correção chegou na main — execute fr isolation verify-merge --branch <b> (seguro para squash/rebase/merge; saída 1 = não verificado). Não verificado → PARE e recupere (cherry-pick / novo PR). Em seguida, execute o Plano de Teste se presente (agente executa verificações, operador confirma o que não consegue alcançar), confirme fases completas (fr status), fr archive <plan-dir>, faça commit via um PR de housekeeping, fr isolation down.