3bb2f8f1c5
* chore: wire docs/agents config into AGENTS.md Agent skills section
Add the `## Agent skills` discovery block pointing the engineering
skills at the existing docs/agents/{issue-tracker,triage-labels,domain}.md
files (issue tracker, triage label mapping, single-context domain docs).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
* docs: rebrand to GSD Core and restructure docs with Diataxis
Reorganise the root README and docs/ around the Diataxis framework
(tutorials, how-to guides, reference, explanation), add new how-to
guides and schema references (STATE.md / CONTEXT.md / PLAN.md /
planning artifacts), and cross-link the whole set. Update the lone
legacy gsd-build reference to open-gsd; keep internal get-shit-done/
filesystem paths unchanged (directory rename tracked separately in
open-gsd/gsd-core#604). Regenerate the ja-JP, ko-KR, pt-BR and zh-CN
localised trees to mirror the new structure.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
* docs: backfill changeset PR number (#605)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
122 lines
5.6 KiB
Markdown
122 lines
5.6 KiB
Markdown
# 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](../explanation/context-engineering.md).
|
|
|
|
---
|
|
|
|
## 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
|
|
|
|
```bash
|
|
/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:
|
|
|
|
```bash
|
|
/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:
|
|
|
|
```bash
|
|
/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
|
|
|
|
```bash
|
|
/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.
|
|
|
|
```bash
|
|
/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ê:
|
|
|
|
```text
|
|
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](../explanation/the-phase-loop.md)
|
|
- [Engenharia de contexto](../explanation/context-engineering.md)
|
|
- [Comandos](../COMMANDS.md)
|
|
- [Índice de documentação](../README.md)
|