msd-core/docs/pt-BR/how-to/handle-quick-and-fast-tasks.md

Como lidar com tarefas rápidas e ágeis

Nem todo trabalho cabe dentro de uma fase. O GSD oferece dois comandos leves para trabalhos que não precisam do ciclo completo de discussão → planejamento → execução → verificação.

Para contexto sobre quando o pipeline completo de fases vale o custo, consulte Engenharia de contexto.

---

Decidindo qual comando usar

Situação	Comando
Corrigir um bug, adicionar uma funcionalidade pequena ou qualquer tarefa que não possa ser resumida como uma única edição trivial	/gsd-quick
Corrigir um erro de digitação, atualizar um valor de configuração, adicionar uma entrada ao .gitignore ou qualquer alteração que toque ≤ 3 arquivos e leve menos de um minuto	/gsd-fast
A tarefa tem incógnitas, precisa de pesquisa ou vai tocar em mais do que um punhado de arquivos	/gsd-quick com --research

A regra prática: se você hesitar por um momento sobre se a tarefa é trivial, use /gsd-quick. O /gsd-fast redireciona automaticamente para /gsd-quick se o escopo parecer não trivial.

---

/gsd-quick — tarefas ad-hoc com garantias GSD

O /gsd-quick executa um planejador e executor com as mesmas garantias de commit atômico e rastreamento no STATE.md que uma fase completa, mas sem o custo de uma fase (sem entrada no ROADMAP, sem fase de discussão, sem coordenação de ondas entre múltiplos planos).

Uso básico

/gsd-quick

O GSD solicita uma descrição da tarefa, então planeja e executa. Os artefatos ficam em .planning/quick/.

Você também pode passar a descrição diretamente:

/gsd-quick "Fix the login button not responding on mobile Safari"

Flags

Adicione flags para incluir mais do pipeline de qualidade quando a tarefa exigir.

Flag	O que adiciona
--discuss	Uma discussão leve de pré-planejamento que revela áreas cinzentas e registra suas decisões em um CONTEXT.md antes de o planejador rodar
--research	Um agente de pesquisa focado investiga abordagens, bibliotecas e armadilhas antes do planejamento
--validate	Verificação do plano (até 2 iterações) mais verificação pós-execução
--full	Tudo o que foi descrito acima — equivalente a --discuss --research --validate

As flags se combinam livremente:

/gsd-quick --research --validate   # research + plan-checking + verification, no discuss
/gsd-quick --discuss               # just surface grey areas before planning
/gsd-quick --full                  # the complete quality pipeline

Quando adicionar flags

• Adicione --research quando não tiver certeza de como abordar uma tarefa ou qual biblioteca usar.
• Adicione --validate quando a tarefa tocar caminhos de código críticos e você quiser que um agente verificador confirme se os requisitos foram atendidos.
• Adicione --discuss quando a tarefa tiver escolhas de design que você quer definir antes de o planejador rodar — por exemplo, quando o comportamento correto de tratamento de erros não é óbvio.
• Use --full quando uma tarefa for genuinamente significativa e você normalmente a planejaria como uma fase, mas ela não pertence ao ROADMAP.

Listando e retomando tarefas rápidas

/gsd-quick list                    # show all quick tasks with status
/gsd-quick status my-task-slug     # show status of a specific task
/gsd-quick resume my-task-slug     # resume an interrupted task

---

/gsd-fast — edições triviais inline

O /gsd-fast faz o trabalho diretamente no contexto atual. Não há subagentes, nenhum PLAN.md e nenhuma pesquisa. É adequado apenas para alterações que você mesmo poderia fazer em menos de um minuto.

/gsd-fast "fix typo in README"
/gsd-fast "add .env to .gitignore"

Se você omitir a descrição, o GSD vai solicitá-la.

O /gsd-fast verifica se a tarefa é realmente trivial antes de prosseguir. Se julgar o escopo muito grande, ele para e redireciona você:

This looks like it needs planning. Use /gsd-quick instead:
  /gsd-quick "your task description"

Após fazer a alteração, o /gsd-fast faz commit atomicamente e, se uma tabela Quick Tasks Completed existir em .planning/STATE.md, acrescenta uma linha a ela.

---

O que o /gsd-quick faz que o /gsd-fast não faz

Capacidade	/gsd-fast	/gsd-quick
Planejador subagente	Não	Sim
Executor subagente	Não	Sim
Agente de pesquisa	Não	Opcional (--research)
Verificação de plano	Não	Opcional (--validate)
Verificação pós-execução	Não	Opcional (--validate)
Fase de discussão	Não	Opcional (--discuss)
Isolamento em worktree	Não	Sim (padrão)
Commits atômicos por tarefa	Commit único	Um por tarefa do plano
Rastreamento no STATE.md	Linha acrescentada se a tabela existir	Sempre atualizado
Artefatos em .planning/quick/	Não	Sim

A distinção principal é o isolamento de subagentes. O /gsd-quick gera um planejador e executor novos em janelas de contexto separadas, o que significa que o trabalho é planejado adequadamente, os commits são atômicos por tarefa e o orquestrador pode verificar os resultados. O /gsd-fast usa apenas a janela de contexto atual e é intencionalmente limitado a alterações triviais o suficiente para não precisar de nada disso.

---

Relacionados

• O ciclo de fases
• Engenharia de contexto
• Comandos
• Índice de documentação