Informar progresso geral
Esta skill responde onde o projeto está e qual é o próximo passo. O relatório
é uma projeção de specs/<estado>/*/spec.md, nunca uma segunda fonte de
estado: nada é editado durante a consulta.
Pronto quando
- O relatório traz os denominadores de specs, gates, tarefas e itens de
checklist, calculados pelos scripts.
- Cada spec que exige atenção aparece com seu blocker e a skill responsável.
- Pendências de contexto e de documentação foram projetadas pelos checks.
- O próximo trabalho foi indicado e, quando acionável, a transição automática
foi executada.
Preparação obrigatória
Antes de executar esta skill, carregue obrigatoriamente $specsfy-setup na
raiz do projeto. Em handoff automático, carregue-o de novo antes desta etapa.
Reutilize a raiz confirmada na conversa e não prossiga se o setup apontar uma
pendência.
Modo de interação
Modo de interação: sem perguntas.
Não formule perguntas nesta skill. Apresente a projeção observada e o próximo
handoff aplicável.
Orquestrar a conversa
Siga a seção Orquestração conversacional de .specsfy/Spec.md. Resumo:
- Pendência dentro do escopo: anuncie
Pendência detectada: <descrição> — ação: resolvendo nesta etapa e resolva.
- Troca de responsabilidade: anuncie
Transição automática: $specsfy-progress → $<destino> — motivo: <motivo> — resultado esperado: <resultado> e carregue imediatamente a skill de destino, sem pedir
confirmação nem repetir o comando. Continue na mesma conversa.
- Correção concluída: anuncie
Retomada automática: $<destino> → $specsfy-progress — pendência resolvida: <resultado> e retome.
Reavalie o estado depois de cada handoff para não entrar em ciclo. O handoff
dispensa confirmação; ações sensíveis continuam exigindo autorização
específica.
Executar
Na raiz do projeto, os comandos abaixo são independentes e podem rodar em
paralelo.
| Objetivo |
Comando |
| progresso geral |
node .agents/skills/specsfy-progress/scripts/progress.mjs . |
| dados para automação |
node .agents/skills/specsfy-progress/scripts/progress.mjs . --json |
| uma única spec |
node .agents/skills/specsfy-progress/scripts/progress.mjs . --slug <slug> |
| custo de contexto de uma spec |
node .agents/skills/specsfy-progress/scripts/analyze_context.mjs specs/<estado>/<NNNN>-<slug>/spec.md --json |
| contexto persistente |
node .agents/skills/specsfy-setup/scripts/monitor_context.mjs --project . --check |
| documentação técnica |
node .agents/skills/specsfy-documentator/scripts/build_documentation.mjs --project . --check |
PENDING no monitor de contexto é blocker da entrega: anuncie o handoff
indicado pelo monitor e retome depois que a auxiliar atualizar o documento
ou que a avaliação sem impacto estiver registrada e reconhecida.
- Documentação ausente ou desatualizada no segundo check leva a
$specsfy-documentator; retome a projeção depois da reconstrução de docs/.
- Sem
--usage-json, o custo de contexto sai rotulado estimated e descreve
a heurística. Só métricas fornecidas explicitamente são measured; não
apresente estimativa como uso real.
Interpretar
- Informe os denominadores de specs, gates, tarefas e itens de checklist.
- Mostre o ato atual e a próxima skill responsável, ambos derivados do
Status.
- Separe spec concluída, trabalho em progresso e blocker real.
- Mostre o próximo par
TNNN/ITEM pronto quando existir.
- Classifique como blocker: gate
Failed, inconsistência de checklist,
dependência sem caminho pronto, documentação obrigatória apontada por
monitor_context.mjs (mesmo com todos os checkboxes marcados) e docs/
ausente ou desatualizado segundo $specsfy-documentator. Um gate
In Progress isolado não é falha.
- Se uma spec existente exigir mudança de comportamento ou de plano, anuncie a
pendência e carregue automaticamente
$specsfy-update-spec. Retome a
projeção depois que a atualização percorrer os atos invalidados.
- Sem nenhuma spec, preserve o código de saída 2. Capturas em
specs/inbox/ e
itens em specs/backlog/ não contam como progresso normativo. Se o pedido
também exigir avançar uma captura, carregue $specsfy-02-backlog; se já
houver intenção e definição suficientes, carregue $specsfy-03-specify.
Preservar a fonte
- Não edite specs, checkboxes, testes ou código durante a consulta.
- A descoberta é exatamente
specs/<estado>/*/spec.md; não conte spec.md
dentro de research/.
- Não deduza progresso de commits, arquivos soltos ou memória do chat.
- Para mudar estado, anuncie e carregue a skill responsável na mesma conversa
e retome o progresso depois.
Relatar
Entregue primeiro o resumo global, depois as specs que exigem atenção, os
blockers e o próximo trabalho. Quando houver etapa acionável, anuncie e
execute a transição automaticamente. Se o usuário pedir automação ou dados
estruturados, use a saída JSON sem renomear campos.
Especialistas sob demanda
Leia references/specialists.md somente para
propor contexto para a próxima tarefa. Carregue automaticamente a skill base
ou o especialista já instalado que seja responsável; instalação exige
autorização específica.
1---2name: specsfy-progress3description: "Projeta, sem escrever nada, o progresso de todas as specs do projeto: denominadores de specs, gates, tarefas e checklists, ato atual, blockers reais e próximo par TNNN/ITEM pronto. Use quando o usuário pedir progresso geral, status das especificações, percentual concluído, quanto falta, bloqueios ou próximo trabalho, ou quando uma transição automática pedir a projeção final ou o roteamento pelo estado observado. Não use para alterar spec, gates ou checkboxes (use a skill responsável, como specsfy-07-implement ou specsfy-update-spec)."4metadata:5 source: https://skillmd.com/skills/promovaweb/specsfy-progress6---78# Informar progresso geral910Esta skill responde onde o projeto está e qual é o próximo passo. O relatório11é uma projeção de `specs/<estado>/*/spec.md`, nunca uma segunda fonte de12estado: nada é editado durante a consulta.1314## Pronto quando1516- O relatório traz os denominadores de specs, gates, tarefas e itens de17 checklist, calculados pelos scripts.18- Cada spec que exige atenção aparece com seu blocker e a skill responsável.19- Pendências de contexto e de documentação foram projetadas pelos checks.20- O próximo trabalho foi indicado e, quando acionável, a transição automática21 foi executada.2223## Preparação obrigatória2425Antes de executar esta skill, carregue obrigatoriamente `$specsfy-setup` na26raiz do projeto. Em handoff automático, carregue-o de novo antes desta etapa.27Reutilize a raiz confirmada na conversa e não prossiga se o setup apontar uma28pendência.2930## Modo de interação3132Modo de interação: `sem perguntas`.33Não formule perguntas nesta skill. Apresente a projeção observada e o próximo34handoff aplicável.3536## Orquestrar a conversa3738Siga a seção `Orquestração conversacional` de `.specsfy/Spec.md`. Resumo:3940- Pendência dentro do escopo: anuncie41 `Pendência detectada: <descrição> — ação: resolvendo nesta etapa` e resolva.42- Troca de responsabilidade: anuncie `Transição automática:43 $specsfy-progress → $<destino> — motivo: <motivo> — resultado esperado:44 <resultado>` e carregue imediatamente a skill de destino, sem pedir45 confirmação nem repetir o comando. Continue na mesma conversa.46- Correção concluída: anuncie `Retomada automática: $<destino> →47 $specsfy-progress — pendência resolvida: <resultado>` e retome.4849Reavalie o estado depois de cada handoff para não entrar em ciclo. O handoff50dispensa confirmação; ações sensíveis continuam exigindo autorização51específica.5253## Executar5455Na raiz do projeto, os comandos abaixo são independentes e podem rodar em56paralelo.5758| Objetivo | Comando |59| --- | --- |60| progresso geral | `node .agents/skills/specsfy-progress/scripts/progress.mjs .` |61| dados para automação | `node .agents/skills/specsfy-progress/scripts/progress.mjs . --json` |62| uma única spec | `node .agents/skills/specsfy-progress/scripts/progress.mjs . --slug <slug>` |63| custo de contexto de uma spec | `node .agents/skills/specsfy-progress/scripts/analyze_context.mjs specs/<estado>/<NNNN>-<slug>/spec.md --json` |64| contexto persistente | `node .agents/skills/specsfy-setup/scripts/monitor_context.mjs --project . --check` |65| documentação técnica | `node .agents/skills/specsfy-documentator/scripts/build_documentation.mjs --project . --check` |6667- `PENDING` no monitor de contexto é blocker da entrega: anuncie o handoff68 indicado pelo monitor e retome depois que a auxiliar atualizar o documento69 ou que a avaliação sem impacto estiver registrada e reconhecida.70- Documentação ausente ou desatualizada no segundo check leva a71 `$specsfy-documentator`; retome a projeção depois da reconstrução de `docs/`.72- Sem `--usage-json`, o custo de contexto sai rotulado `estimated` e descreve73 a heurística. Só métricas fornecidas explicitamente são `measured`; não74 apresente estimativa como uso real.7576## Interpretar77781. Informe os denominadores de specs, gates, tarefas e itens de checklist.792. Mostre o ato atual e a próxima skill responsável, ambos derivados do80 `Status`.813. Separe spec concluída, trabalho em progresso e blocker real.824. Mostre o próximo par `TNNN/ITEM` pronto quando existir.835. Classifique como blocker: gate `Failed`, inconsistência de checklist,84 dependência sem caminho pronto, documentação obrigatória apontada por85 `monitor_context.mjs` (mesmo com todos os checkboxes marcados) e `docs/`86 ausente ou desatualizado segundo `$specsfy-documentator`. Um gate87 `In Progress` isolado não é falha.886. Se uma spec existente exigir mudança de comportamento ou de plano, anuncie a89 pendência e carregue automaticamente `$specsfy-update-spec`. Retome a90 projeção depois que a atualização percorrer os atos invalidados.917. Sem nenhuma spec, preserve o código de saída 2. Capturas em `specs/inbox/` e92 itens em `specs/backlog/` não contam como progresso normativo. Se o pedido93 também exigir avançar uma captura, carregue `$specsfy-02-backlog`; se já94 houver intenção e definição suficientes, carregue `$specsfy-03-specify`.9596## Preservar a fonte9798- Não edite specs, checkboxes, testes ou código durante a consulta.99- A descoberta é exatamente `specs/<estado>/*/spec.md`; não conte `spec.md`100 dentro de `research/`.101- Não deduza progresso de commits, arquivos soltos ou memória do chat.102- Para mudar estado, anuncie e carregue a skill responsável na mesma conversa103 e retome o progresso depois.104105## Relatar106107Entregue primeiro o resumo global, depois as specs que exigem atenção, os108blockers e o próximo trabalho. Quando houver etapa acionável, anuncie e109execute a transição automaticamente. Se o usuário pedir automação ou dados110estruturados, use a saída JSON sem renomear campos.111112## Especialistas sob demanda113114Leia [references/specialists.md](references/specialists.md) somente para115propor contexto para a próxima tarefa. Carregue automaticamente a skill base116ou o especialista já instalado que seja responsável; instalação exige117autorização específica.