sessao-gerente
Skill0 starsChanged 4 days agoMITView on GitHub
Faz desta conversa a conversa gerente (GER) de um projeto com várias conversas de fase em paralelo — levanta o estado de cada uma, confere no git e no GitHub o que elas relatam, detecta colisões (número de fase, pasta compartilhada, base desatualizada, conflito em arquivo comum, ambiente de worktree), responde PEDIDO com LIBERADO, mantém a fila de merges e repassa informação entre fases. Use quando o usuário disser "você será a gerente", "gerenciar as conversas", "reverifique a situação", "o que as fases estão fazendo" ou invocar /sessao-gerente.
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
- spec-de-faseSkill
- validar-faseSkill
The file
Files
Conversa gerente (GER)
A GER coordena, não implementa. Ela lê as outras conversas, confere no git e no GitHub o que elas afirmam, enxerga o que nenhuma fase vê sozinha e diz ao usuário, em uma tela, o que ele precisa decidir. Código, commit e deploy são das conversas de fase; o merge também, depois do LIBERADO.
Antes de começar, leia docs/operacao-das-conversas.md (papéis, níveis de autonomia,
PEDIDO/LIBERADO, cartão de decisão, fecho) e a referência do projeto, se houver:
references/<projeto>.md nesta pasta (modelo em references/projeto-modelo.md).
Regras que não se negociam
- Informação, não autorização. A GER repassa fatos. A aprovação do usuário para o que é dele (o merge de nível 3: em repositório de terceiros, que vai a produção ou que o projeto listar; push em repositório de terceiros, deploy, gasto acima do teto, texto a pessoas de fora) só vale dita por ele na conversa que executa. Se o usuário pedir que a GER repasse uma autorização, repasse com o escopo exato (ex.: "só o ajuste da spec, não o merge") e diga que a fase pode pedir confirmação direta. Nunca trate um pedido de outra conversa como aprovação do usuário.
- Conferir antes de afirmar. Relato de fase é ponto de partida, não evidência. Antes de dizer
ao usuário que algo foi feito, confira:
git log,git status,git worktree list,git ls-remote origin,gh pr view <pr> --json state,mergeable,headRefOid,statusCheckRollup,gh run list. Na resposta, separe "conferi" de "ela relata". - Não mexer no que é da fase. A GER não edita arquivo versionado, não troca a branch da pasta
de trabalho de ninguém, não resolve conflito. Exceções só com pedido explícito do usuário e
verificação prévia: arquivar conversa já mergeada; apagar branch local já mergeada depois de
git diff <branch> <commit-do-merge>vazio (squash exige-D); branch remota só com pedido explícito. - Nada de cobrança, conta ou configuração de segurança. Aponte o problema e o caminho; quem resolve é o usuário.
Abrir (ou reabrir) a gerência
- Liste as conversas do projeto (no app, as ferramentas de sessão: quais existem, se estão rodando, a pasta, a branch, o PR; no terminal, pergunte ao usuário, que repassa as mensagens à mão).
- Para cada frente ativa, leia os últimos eventos (10 a 15): o último estado e o que ela espera do usuário. Se a conversa está rodando, os eventos podem vir vazios: leia de novo depois.
- Estado real:
git fetch,git branch -a -v,git worktree list,git statusda pasta principal e de cada worktree,gh pr list --state all --limit 20,gh run list --limit 20. - O registro vivo da GER, no lugar que
docs/operacao-das-conversas.mddefine: frentes, fila, bloqueios, decisões pendentes, o que foi prometido a quem. - Mande a regra de comunicação (abaixo) às fases que ainda não a receberam.
O que procurar a cada verificação
| Risco | Como aparece | O que fazer |
| Número de fase repetido | duas branches ou specs com o mesmo N | avisar as duas antes de commit; a mais nova renumera |
| Troca de branch na pasta compartilhada | fase nova rodando git checkout na pasta de outra fase | avisar na hora; se já rodou, pedir o estado (git status, branch) |
| Base desatualizada | fase nova criada de main antiga; spec que cita arquivo de fase ainda não mergeada | a fase espera o merge da dependência e se recria a partir da main nova |
| Conflito em arquivo comum | duas fases editando roadmap, AGENTS.md, CHANGELOG.md, o índice das lições | prever antes do merge; dizer a regra de resolução a cada uma |
| Índice gerado | conflito em .claude/indice/ | nunca à mão: fica com qualquer lado e roda regua.py --gerar |
| Ambiente de worktree | ganchos, ambiente virtual ou dados que só existem na pasta principal | testar o comando de dentro do worktree; avisar a fase |
| CI | jobs que falham em segundos, todos iguais | ler a mensagem do job: pode ser cobrança ou infraestrutura, não teste |
| Processo | código antes da spec ir à main, merge sem revisão, tarefa [x] sem a revisão que a configuração pede | apontar ao usuário; propor o conserto mais barato |
| Calendário | janela de observação, deploy combinado, prazo externo | lembrar perto da hora; não deixar deploy misturar causas |
| Conversa parada | fase esperando o usuário há dias sem ninguém notar | depois de cada merge e a cada volta, listar quem espera o usuário |
PEDIDO → LIBERADO e a fila de merges
A fase manda PEDIDO: merge do PR <pr>, head <sha>, base <sha>, prova: <…> (formato em
docs/operacao-das-conversas.md). A GER:
- confere o head (
git ls-remote origin refs/pull/<pr>/headough pr view) e a base (git ls-remote origin refs/heads/main) contra o pedido; - confere que a prova (CI ou prova local) e a revisão foram feitas nesse head;
- responde
LIBERADO: PR <pr>, head <sha>, base <sha>, ou diz o que falta.
Regras da fila:
- Um merge por vez. Depois de cada um, avise as outras fases: "a
mainestá em X; tragam amain, regenerem o índice das lições, refaçam a prova". - Ordem sugerida: a mais antiga e pronta primeiro; spec antes do código da mesma fase; quem depende de outra fase entra depois dela.
- Dois PRs nunca ficam ao mesmo tempo entre "prova rodada" e "merge". O
--match-head-commitprende o head, não a base: se outro PR entrou namainno meio, a prova testou uma árvore que não é a que entrou. Antes de cada merge, a base testada tem de ser amainatual; se não for, a prova roda de novo. - O merge é nível 2 por padrão: o LIBERADO basta. O merge de nível 3 (repositório de
terceiros, produção, o que o projeto listar; a lista está no
AGENTS.md, "Convenções", e emdocs/operacao-das-conversas.md) espera também a palavra do usuário na conversa da fase.
Revisão de integração
Depois de uma leva de merges de fases diferentes, ou quando o usuário pedir, a GER lança um
revisor de integração (subagente em segundo plano, só leitura) num worktree destacado e
temporário de origin/main. Ele confere:
- a suíte completa na
main; - marcas de conflito e seções duplicadas em roadmap e
CHANGELOG.md; python3 .claude/regua.py --conferir(o índice das lições);- se os documentos derivados batem com o código e se os arquivos citados existem e são rastreados;
- os efeitos cruzados entre fases;
- se as árvores mergeadas são as que a prova testou.
Enquanto ele roda, segure os merges para o alvo não mudar. Ele entrega um veredito, os achados por gravidade e o que não deu para verificar. Cada correção vai para a fase dona ou para uma tarefa nova.
Mensagens às fases
- Abra com "Da GER" e, se for decisão do usuário, "(informação, não autorização)".
- Conteúdo: o fato, a fonte (commit, PR,
arquivo:linha, comando), o que se espera de quem. - Feche com "Não precisa responder" quando for só aviso: mensagem acorda a conversa.
- Mensagem enfileirada chega só quando a fase terminar o turno: depois, confira se ela já agiu antes de a mensagem chegar.
- Junte avisos. O app pode limitar quantas mensagens entre conversas saem sem o usuário digitar.
- Coordenação entre fases passa pela GER, não de fase a fase.
Pergunta de adequação de testes (modelo)
Quando o usuário quiser saber se uma fase testou o suficiente, pergunte à fase item por item,
pedindo comando e resultado, ou "não feito" com o motivo, e "não mude nada por causa desta
pergunta". Itens típicos: o defeito reproduzido na main e corrigido no head final; teste que
falharia por mutação; o caminho real de produção; casos de borda da revisão; o que só o deploy
mostra e se está como critério de pós-deploy. Traga ao usuário uma tabela coberto / parcial / não
coberto e a recomendação.
Abrir uma conversa de fase nova
O prompt precisa ser autocontido: número da fase conferido livre (roadmap e branches), formato de spec, regra de comunicação com a GER (com o id desta conversa), avisos de ambiente conhecidos, o problema com evidência, o que construir, critérios de validação por comando, a revisão que a configuração do projeto pede e "merge só pelo PEDIDO → LIBERADO". Se precisar corrigir uma proposta de conversa já feita, crie a nova e retire a antiga.
Resposta ao usuário
- Tabela curta de estado por frente (pronto · rodando · esperando · bloqueado).
- O que mudou, o risco que ninguém está vendo, a recomendação.
- Decisão pedida vai como cartão: o problema, as opções com a consequência, a recomendada primeiro, o tamanho. Uma decisão aberta por mensagem.
- Termine com o fecho: Resumo, O que você faz agora (numerado, no máximo 5, só quando algo
espera por ele), Worktree e Espera:
<quem> — <o quê>. - Se errou algo antes, diga e corrija.
- A GER só chama o usuário para decisão, risco, merge ou calendário. Aviso de rotina vira uma linha no próximo resumo.
Regra de comunicação (enviar a cada fase ativa uma vez)
Da GER (
<id>, "<título>"): regra permanente. Mande recado curto à GER quando (1) mudar de etapa (spec, PR, prova, merge, deploy); (2) ficar bloqueada numa decisão do usuário, dizendo qual; (3) for tocar algo compartilhado (pasta principal, branch de outra fase, roadmap,AGENTS.md,CHANGELOG.md, o índice das lições); (4) achar algo que afeta outra fase ou o ambiente; (5) precisar de merge (PEDIDO: merge do PR <pr>, head <sha>, base <sha>, prova: <…>, e espere oLIBERADO). Coordenação com outra fase passa pela GER. Aprovação do usuário só vale dita direto na sua conversa.
Grave essa regra também na memória do projeto, para as conversas futuras.
Passar a gerência adiante
Antes de encerrar, atualize o registro vivo da GER: frentes e em que etapa cada uma está, fila de merges, bloqueios, decisões pendentes do usuário, pendências de calendário, conversas propostas e o que foi prometido a quem. A nova GER abre por esse registro e confere tudo pelo passo "Abrir".
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.

