Relatório de progresso
Relatar é uma projeção determinística. Nunca crie, retenha, envie mensagens ou consulte um agente apenas para mantê-lo. Registre apenas fatos ausentes de atribuição, decisão ou bloqueador.
Execute a CLI a partir da raiz do repositório: progress abaixo significa python <diretório da skill>/scripts/progress.py
(.claude/skills/progress-report, .agents/skills/progress-report, ou $CLAUDE_PLUGIN_ROOT/skills/progress-report).
Digite o comando completo a cada vez. Verbos imprimem uma linha (refresh não imprime nada); retransmita-a.
Quando usar
- Um arquivo de plano (Markdown com itens
- [ ]/- [x]) orienta o trabalho: modo plano, sem necessidade de Spec Kit. - Uma funcionalidade do Spec Kit tem
specs/<feature>/tasks.md: modo funcionalidade; arquivos de Workflow são coletados quando presentes.
Início rápido no modo plano
progress hooks install --host claude(oucodex; adicione--scope userpara uma instalação de plugin) uma vez, para modelo, esforço, contexto e agentes filhos. Pule e as tarefas ainda serão rastreadas.progress init --plan docs/plan.mdcria.progress/plan/(veja--name,--dir) e imprimebind=<nonce>; o próximo hook vincula (hooks installimprime um se um relatório existir).- Marque itens no arquivo de plano; o relatório acompanha. Progress nunca escreve no plano.
progress statusfornece o estado em uma linha; a visualização está em.progress/plan/.view/index.html.
Itens mantêm um id escrito (T001); outros recebem ids estáveis P001... Com um plano ou funcionalidade ativa, nenhuma flag de destino é necessária; caso contrário, passe --plan NOME ou --feature DIR.
Verbos
| Necessidade | Comando |
|---|---|
| Criar um relatório | progress init --plan CAMINHO [--name N] [--dir D] ou progress init (Spec Kit) |
| Estado em uma linha | progress status |
| Atribuir uma lane | progress lane L1 --tasks P001-P004 --owner ID --harness H --model M --effort E |
| Fechar uma lane | progress lane L1 --close |
| Bloqueador | progress block P007 --by L2 (ou P003, ext:"texto"); progress unblock B4 |
| Decisão | progress decide ask "pergunta" --options a,b; progress decide made D2 b --by usuario |
| Nota | progress note "texto" --target P005 |
| Exportar | progress export --format md |
| Hooks | `progress hooks install |
Regras
- Registre uma lane ao atribuir trabalho (
L#; hosts filhosC#aparecem por conta própria). Inícios, conclusões e tentativas não precisam de comando. - Nunca coloque segredos, caminhos absolutos ou texto de transcrição em uma nota (no máximo 200 caracteres).
- Valores desconhecidos permanecem desconhecidos. Não estime modelo, esforço, contexto ou tempo.
- Erros lêem
progress: error CÓDIGO; corrija a causa, não tente novamente em um loop.
Detalhes: references/verbs.md; contrato docs/contracts.md; flags docs/commands.md.