lukaszbadowski/gerenciar-projetos-de-software-com-ia

Gerenciar Projetos de Software com IA

Transforme entregas vagas assistidas por IA em um sistema de execução controlado para um operador humano. Elicite o quadro, obtenha aprovação consciente da divisão das histórias, execute através de uma pequena fila de tarefas roteadas em arquivos duráveis, verifique com evidências e feche somente após cada critério de sucesso passar por sua verificação de ponta a ponta.

Mantenha o estado durável do projeto neutro em relação ao fornecedor. Alternar entre Codex, Claude Code ou outro agente compatível não deve exigir a conversão dos arquivos pm/.

Início Rápido

1. Inspecione o workspace. Se pm/ existir, leia pm/STATE.md, depois pm/TASKS.md; repare lacunas em vez de regenerar o sistema.
2. Se não houver sistema de projeto, execute CP1: faça as perguntas de elicitação e rascunhe o quadro em pm/PLAN.md.
3. Crie os quatro arquivos canônicos a partir de referências/modelos-de-arquivo.md.
4. Dirija o trabalho através da divisão CP2, fila CP3, o loop de execução e a aceitação final CP4.

Protocolo de Checkpoint do Operador

Cocrie a divisão com o operador. Registre cada aprovação com uma data em pm/PLAN.md ou pm/TASKS.md.

• CP1 — Quadro. Elicite e obtenha aprovação para o objetivo, critérios de sucesso, verificações finais, escopo, restrições e suposições estruturais.
• CP2 — Divisão. Apresente as histórias na linguagem do operador. Dê a cada história critérios de aceitação e faça a ligação com os critérios de sucesso que ela atende. Resolva decisões estruturais abertas com o operador.
• CP3 — Fila. Apresente a fila de tarefas ordenada com níveis de roteamento antes do início da execução.
• CP4 — Aceitação final. Reexecute cada verificação final do CP1 de ponta a ponta, vincule evidências, apresente o relatório de aceitação e obtenha a aprovação final. Tarefas concluídas sozinhas não significam que o projeto está pronto.

Use estas regras permanentes:

• Preencha pequenas lacunas dentro de um quadro aprovado com suposições registradas em pm/DECISIONS.md.
• Retorne mudanças estruturais — escopo, histórias, critérios de sucesso ou barra de aceitação — ao checkpoint relevante e registre a compensação.
• Pergunte no CP1: Que resultado deve existir e para quem? Como o operador o verificará pessoalmente? O que está fora do escopo? Quais restrições são fixas? O que já existe? O que é mais arriscado ou pouco claro? Quanta revisão o operador deseja?
• Em modo de resgate, reconstrua o quadro e a divisão implícitos a partir do workspace, apresente-os para confirmação e depois reconstrua a fila.

Arquivos Canônicos do Projeto

Mantenha quatro arquivos sob pm/:

• pm/PLAN.md — objetivo, critérios de sucesso, escopo, histórias, rastreabilidade, aprovações
• pm/TASKS.md — fila de tarefas ordenada, IDs estáveis, roteamento, verificação, evidências
• pm/STATE.md — estado atual, notas de passagem, registro de sessão
• pm/DECISIONS.md — decisões, suposições, riscos, problemas, registro de alterações

Não crie mais arquivos de controle por padrão. Adicione pm/CONSTRAINTS.md, pm/RELEASE.md ou pm/RESEARCH.md apenas quando o ramo correspondente estiver ativo.

Mantenha o arquivo de entrada específico do produto — como AGENTS.md ou CLAUDE.md — curto e navegacional: aponte para pm/STATE.md, depois pm/TASKS.md, com pm/PLAN.md como escopo aprovado. Espelhe informações duráveis de ferramentas de planejamento locais da sessão em pm/TASKS.md e pm/STATE.md.

Roteie o Trabalho por Capacidade

Atribua um nível Route: neutro em relação ao fornecedor quando cada tarefa entra na fila:

Nível	Use para
heavy	planejamento, decomposição, arquitetura, depuração ambígua, refatorações transversais, revisão arriscada, aceitação final
standard	implementação limitada, testes, alterações de complexidade moderada
light	pesquisa no repositório, resumos, edições mecânicas, documentação, formatação, triagem de logs

Roteie cada tarefa para o nível menos caro que possa concluí-la de forma confiável:

• Mantenha a thread principal capaz o suficiente para dirigir: elaborar briefings, rotear trabalho, julgar evidências e aprovar.
• Escalone um nível após duas tentativas fracassadas ou um resultado de baixa confiança na mesma tarefa; registre o escalonamento.
• Exija que o nível do revisor seja pelo menos o nível do escritor. Dê a alterações arriscadas ou transversais uma revisão heavy com contexto fresco. Nunca permita que um trabalhador light auto-aprove.
• Mantenha nomes de modelos fora de pm/; aliases e preços de produtos mudam enquanto os níveis de capacidade permanecem úteis.
• Leia referências/roteamento-de-agentes.md antes de configurar trabalhadores para Codex, Claude Code ou outro agente.

Construa Contexto Primeiro

• Extraia o objetivo real, usuários, barra de aceitação, dependências e expectativas de lançamento.
• Trate datas, orçamentos, aprovações, cronogramas de fornecedores ou janelas de lançamento como entradas de primeira classe apenas quando explícitos.
• Procure por arquivos pm/ existentes, briefings de tarefas, backlogs, designs, ADRs, estratégias de teste, runbooks, registros de risco e arquivos de instrução de agente antes de inventar novos artefatos.
• Em trabalho de resgate, avalie clareza do objetivo, escopo, dependências, qualidade de aceitação, higiene de risco, legibilidade do contexto, permissões e prontidão para lançamento.

Escolha o Menor Modo de Controle

• Padrão para operador-único: um operador dirigindo agentes de IA.
• Adicione restrição-externa para uma data fixa real, gate de conformidade, aprovação, dependência de fornecedor, cota ou janela de lançamento.
• Adicione feedback-intenso quando descoberta, aprendizado do usuário ou iteração de UX dominar.
• Adicione segurança-de-lançamento quando o envio exigir alternância, reversão, monitoramento ou notas operacionais.

Dimensione Unidades de Execução

• Use histórias para valor visível ao usuário e aceitação. Use marcos apenas para agrupar trabalho. Execute através de tarefas.
• Faça cada tarefa caber em uma execução focada do agente e uma revisão rápida do operador: um subsistema, interface, documento ou superfície de teste e um diff revisável.
• Dê a cada tarefa um ID estável, referência de história, nível de roteamento, escopo, dependência, verificação de conclusão, verificação exata, campo de evidência e ponto de parada explícito.
• Divida antes da execução quando uma tarefa abranger áreas não relacionadas ou várias validações independentes. Mantenha o histórico: tarefas filhas recebem novos IDs; tarefas substituídas tornam-se substituída.
• Após concluir uma tarefa, preencha sua evidência e atualize pm/STATE.md na mesma execução.

Mantenha a Rastreabilidade

• Mapeie cada critério de sucesso para pelo menos uma história e cada história para pelo menos uma tarefa.
• Marque uma história como concluída somente após todas as suas tarefas e critérios de aceitação serem verificados com evidências.
• Marque o projeto como concluído somente após CP4 reverificar cada critério de sucesso de ponta a ponta.

Execute um Loop de Qualidade Primeiro

• Defina a menor prova crível antes da implementação: reprodução com falha, teste automatizado, saída esperada, comparação de captura de tela, verificação de contrato ou procedimento manual exato.
• Use explorar -> planejar -> implementar -> verificar -> revisar -> documentar.
• Registre comandos, resultados, capturas de tela, métricas e notas de revisão em vez de apenas conclusões.
• Declare orçamentos de mudança para tarefas arriscadas: arquivos permitidos, interfaces estáveis, segurança de dados, reversão e gatilhos de escalonamento.
• Pilote alterações repetitivas ou automatizadas em uma fatia representativa estreita antes de escalar.
• Após a mesma falha duas vezes, pare e melhore o ambiente, documentação, regra ou validador; reinicie com contexto limpo.
• Trate falhas repetidas do agente como feedback do sistema. Melhore o processo, não apenas a resposta atual.

Delegue com Segurança

• Delegue apenas trabalho pronto para autonomia e limitado. Mantenha metas, decomposição, síntese e aprovação na thread principal.
• Dê a cada trabalhador um briefing escrito: ID da tarefa, objetivo, escopo, restrições, comandos de verificação, evidência esperada, ponto de parada, gatilho de escalonamento e nível de roteamento.
• Mantenha trabalho pequeno, fortemente acoplado ou altamente interativo na thread principal quando a sobrecarga de delegação exceder seu benefício.
• Prefira validadores determinísticos para regras de tolerância zero, como testes exigidos, restrições de caminho, formatação ou varredura de segredos.
• Imponha privilégio mínimo, limites de confiança, regras de manipulação de segredos e aprovação explícita do operador para ações arriscadas.

Referências

• Leia referências/modelos-de-arquivo.md ao criar ou reparar pm/.
• Leia referências/exemplo-trabalhado.md para um exemplo compacto de ponta a ponta.
• Leia referências/livro-de-regras-do-projeto.md ao auditar ou resgatar um projeto.
• Leia referências/restrições-externas.md apenas para restrições externas reais ou risco de lançamento em produção.
• Leia referências/práticas-de-agente-de-ia.md para orientação mais profunda sobre memória durável, contexto, delegação, avaliações e salvaguardas.
• Leia referências/roteamento-de-agentes.md ao mapear níveis para as capacidades atuais de um produto.
• Leia referências/âncoras-de-fonte.md quando proveniência ou orientação volátil do fornecedor for importante.
• Carregue apenas a menor referência relevante.

Padrões de Saída

• Escreva artefatos concretos e prontos para decisão em forma imperativa.
• Reporte o status do checkpoint primeiro e os IDs das tarefas antes do status em prosa.
• Formate tarefas como: ID da Tarefa, Tarefa, História, Rota, Escopo, Depende de, Concluído quando, Verificar com, Evidência, Parar após, Status.
• Prefira um diff revisável por tarefa.
• Mantenha nomes de modelos fora dos arquivos duráveis do projeto.
• Não adicione planos de data, orçamentos, fluxos de aprovação, cerimônias recorrentes ou portões de estágio a menos que o projeto genuinamente precise deles.
• Verifique alegações atuais de modelo, benchmark, preço ou fluxo de trabalho do fornecedor contra fontes primárias antes de usá-las.