Skip to content

Tutor e nomes dos comandos - #11

Merged
ronifabio merged 2 commits into
mainfrom
tutor-e-nomes-dos-comandos
Sep 3, 2026
Merged

ronifabio merged 2 commits into
mainfrom
tutor-e-nomes-dos-comandos

Conversation

@ronifabio

Copy link
Copy Markdown
Contributor

Closes #

O que este PR faz e por quê

Apontamentos da revisão

Aceitos:

Recusados (com o motivo):

ronifabio and others added 2 commits September 2, 2026 21:52
… Fase 0 e por arquivo

Retorno do primeiro uso real no Antigravity. Três problemas observados:
o aluno não sabe o que dizer para começar; o setup rodou com o
architecture.md não commitado, porque o texto pedia o commit mas nada
verificava; e nada convida o aluno a usar o tutor fora do ciclo de tarefa.

- README ganha "O primeiro prompt": um texto para colar no chat que faz o
  agente recitar as regras, dizer em que fase o projeto está e qual é o
  próximo comando. Serve no primeiro dia e em qualquer retomada, e é também
  o teste de que a configuração da ferramenta carregou.
- /utf-flows, /utf-architecture e /utf-setup passam a PARAR se o documento
  da etapa anterior não estiver commitado (git status --porcelain). Antes,
  só o /utf-backlog exigia isso.
- Tutor na Fase 0: modos novos para prd, flows e architecture (explica o
  documento do aluno, não um exemplo) e para setup (monorepo, as duas
  metades, os arquivos que ele não escreveu, por que a suíte nasce verde).
  Os três primeiros são oferecidos no portão de cada documento; o de setup
  é despachado automaticamente, porque ali o aluno recebe dezenas de
  arquivos que não viu nascer.
- Tutor por arquivo: novo modo `passo`, que lê o diff da tarefa um arquivo
  por vez, esperando o aluno a cada um, com a sintaxe nova nomeada onde ela
  aparece. O /utf-task passa a conduzir essa leitura antes do portão do
  commit, e o aluno pode dispensar. O modo `antes` também passa a prever
  arquivo por arquivo o que vai ser escrito.

Um limite honesto: um subagente que escreve não consegue parar entre
arquivos para ensinar. O que dá para fazer é ensinar entre a escrita e o
commit, no ritmo do aluno — que é o que o modo `passo` faz.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
… ferramentas

No Antigravity o comando é o nome do arquivo em .agents/workflows/, o que foi
confirmado em teste real: ele listava /prd, /user-flows, /ciclo-tarefa e
/utf-workflow, enquanto todos os guias dizem /utf-prd, /utf-flows e /utf-task.

Os oito workflows passam a se chamar utf-prd, utf-flows, utf-backlog,
utf-architecture, utf-setup, utf-issue, utf-task e utf-tutor, e as cascas de
Claude Code, Cursor e OpenCode apontam para os novos caminhos. As notas de "no
Antigravity leia o equivalente" saem do README e do tutorial, porque deixou de
haver equivalente a traduzir.

Os documentos em docs/ não são tocados: prd.md e architecture.md seguem com os
nomes padrão de mercado.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@ronifabio
ronifabio merged commit ab12b9c into main Sep 3, 2026
1 check failed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant