mohamedzhioua/agentpace

O que agentpace faz?

Use quando alguém perguntar quanto tempo o trabalho de software vai levar, ou mencionar um prazo em dias, semanas ou meses para trabalho que agentes farão.

Produz uma faixa medida P50/P80/P90 com seu caminho crítico, a parte humana em sua própria linha, e qualquer prazo citado mostrado ao lado como não verificado.

Responda "quanto tempo isso vai levar?" com faixas medidas de execuções reais de agentes, e declare a parte humana separadamente. Não cite prazos de equipes humanas e nunca dê um único número.

Esta skill é acionada por perguntas em linguagem natural. /pace-estimate é o comando explícito para um plano dado.

Verificar a ferramenta

Execute agentpace --version. Se falhar, informe ao usuário o comando de instalação e pare. Não instale nada sem ser solicitado:

uv tool install agentpace

Se o usuário não quiser instalar nada, use assets/portable-prompt.md como alternativa.

Estimar

1. Presuma que agentes farão a implementação, a menos que o usuário diga o contrário. Se não estiver claro e a resposta mudar, pergunte uma vez.
2. Divida o trabalho em tarefas que um agente executaria como execuções separadas.
3. Atribua a cada tarefa um id, um kind e um risk, além de depends_on quando ela precisar esperar por outra tarefa. Defina agent_cap como o número de agentes que executarão ao mesmo tempo.
4. Escreva o plano em um arquivo e execute o estimador.

{
  "agent_cap": 3,
  "model": "claude-opus-5-5",
  "tasks": [
    { "id": "schema", "kind": "feature", "risk": "normal" },
    { "id": "api", "kind": "feature", "risk": "normal", "depends_on": ["schema"] },
    { "id": "review", "kind": "review", "risk": "low", "depends_on": ["api"] }
  ]
}

agentpace estimate plan.json

Tipos: feature, bugfix, refactor, migration, tests, docs, review, other. Riscos: low, normal, high. Use risk: high para migrações e para trabalho difícil de reverter. model é opcional.

Re-responder a um prazo humano

Quando a conversa já contém um prazo em dias, semanas ou meses, vindo do usuário, de um documento ou de uma resposta anterior, estime o plano da mesma forma e passe o prazo literalmente, nas palavras em que foi dado:

agentpace estimate plan.json --quoted "3 meses"

A saída então terá uma linha Citado: abaixo do total, marcando o prazo como tempo de calendário, citado e não verificado. Transmita essa linha conforme impressa, ao lado da faixa medida. Nunca converta o prazo em tempo de agente, nunca divida ou multiplique por uma constante, e nunca compare com a faixa ou forneça uma razão entre eles: o único tempo de agente é a faixa medida, e a parte humana permanece em sua própria linha. Nunca diga qual é a diferença entre o prazo e a faixa, e nunca a chame de parte humana: isso derivaria a parte humana do tempo de agente. Nunca diga o que o prazo conta, também: nada o verificou.

Se o usuário quiser ver depois qual número se manteve, ofereça o mesmo comando com --record adicionado. Uma vez que o trabalho estiver concluído, agentpace score <id> --session <ref> compara ambos com o que os agentes realmente levaram.

Relatar o resultado

• Comece com o total do plano como uma faixa: P50, P80 e P90, no relógio da sessão. Recomende P80 para planejamento.
• Transmita a linha do relógio da sessão e a linha da parte humana conforme a CLI as imprime. A primeira diz que as lacunas entre execuções contam para o total até o limite ocioso, então pequenas esperas do usuário ficam dentro dele. Não medida, a linha da parte humana diz que nenhuma margem para revisão, testes, decisões e espera entre turnos de agente é adicionada. Medida por agentpace turns, ela cita a própria espera do usuário por turno humano, a partir do histórico local. De qualquer forma, não derive um número para isso a partir do tempo de agente, e não multiplique a espera por turno por um número estimado de turnos. Se o usuário fornecer seu próprio valor, repita-o e rotule-o como dele. Se ele declarar sua capacidade de revisão, como "4 PRs por dia", passe-o literalmente com --review-capacity "<figura>", transmita a linha Capacidade de revisão: conforme impressa, e nunca transforme em um prazo.
• Nomeie o caminho crítico e o paralelismo efetivo.
• Transmita todos os avisos. Um aviso significa que uma célula teve poucas execuções, então essa faixa se baseia em dados mais amplos.
• Não declare um único número, mesmo quando pressionado. Se alguém precisar de um valor para planejar, dê o P80 e chame-o de P80.

Limites a declarar quando relevantes

• Os dados iniciais são o fluxo de trabalho de uma pessoa, então podem não se assemelhar ao do usuário. agentpace ingest combina as próprias execuções do usuário com eles; --data ~/.agentpace/runs.jsonl usa apenas as do usuário. Os adaptadores para CLI do Gemini, OpenCode e Cline são experimentais, ainda não verificados em sessões reais, então diga isso quando uma estimativa se basear em linhas deles.
• Sem ler prompts, metadados não conseguem separar features de correções de bugs ou refatorações, então esses tipos podem compartilhar dados.
• size é ignorado a menos que --use-size seja passado, porque o tamanho armazenado é medido após uma execução. Não o passe a menos que o usuário peça.

Consulte references/method.md para saber como a estimativa funciona.