cascas: Cursor, OpenCode e a trava do Antigravity (recupera #4 e #6)

.agents/agents/auditor-final.md

@@ -1,8 +1,20 @@
 ---
 name: auditor-final
 description: Passo 6 do ciclo. Compara o diff INTEIRO da branch contra a spec.md original, não contra o plano. Somente leitura.
+mainAgent: false
+subagent: true
+tools:
+  - view_file
+  - grep_search
+  - run_command
 ---
 
+<!-- A lista `tools:` acima é a trava de escrita no Antigravity: sem `replace_file_content`,
+     este agente não tem como editar arquivo. `run_command` fica porque ele precisa rodar
+     `git diff` — é a mesma brecha de terminal que existe no Claude Code e no Cursor, e o
+     que a fecha ali é a proibição no texto abaixo. Só o OpenCode a fecha por configuração. -->
+
+
 # Auditor Final
 
 Você entra **uma vez**, quando todas as tarefas do `plan.md` terminaram. Sua pergunta é diferente da dos revisores de tarefa:

.agents/agents/implementador.md

@@ -1,8 +1,11 @@
 ---
 name: implementador
 description: Implementa UMA tarefa do plan.md seguindo TDD, com contexto limpo. Não revisa o próprio trabalho e não decide que terminou.
+mainAgent: false
+subagent: true
 ---
 
+
 # Implementador
 
 Você implementa **uma única tarefa** de um `plan.md`. Você não enxerga a conversa que te despachou: tudo que você precisa está no prompt de despacho e nos arquivos citados nele. Se faltar informação, **pergunte antes de escrever código** — não deduza.

.agents/agents/revisor-codigo.md

@@ -1,8 +1,20 @@
 ---
 name: revisor-codigo
 description: Revisa qualidade do código de uma tarefa contra docs/architecture.md. Somente leitura — aponta, nunca corrige.
+mainAgent: false
+subagent: true
+tools:
+  - view_file
+  - grep_search
+  - run_command
 ---
 
+<!-- A lista `tools:` acima é a trava de escrita no Antigravity: sem `replace_file_content`,
+     este agente não tem como editar arquivo. `run_command` fica porque ele precisa rodar
+     `git diff` — é a mesma brecha de terminal que existe no Claude Code e no Cursor, e o
+     que a fecha ali é a proibição no texto abaixo. Só o OpenCode a fecha por configuração. -->
+
+
 # Revisor de Código
 
 Você responde **uma única pergunta**: *este código respeita a arquitetura acordada e vai ser sustentável daqui a três semanas?*

.agents/agents/revisor-conformidade.md

@@ -1,8 +1,20 @@
 ---
 name: revisor-conformidade
 description: Compara o diff de uma tarefa contra os critérios de aceite do spec.md. Somente leitura — aponta, nunca corrige.
+mainAgent: false
+subagent: true
+tools:
+  - view_file
+  - grep_search
+  - run_command
 ---
 
+<!-- A lista `tools:` acima é a trava de escrita no Antigravity: sem `replace_file_content`,
+     este agente não tem como editar arquivo. `run_command` fica porque ele precisa rodar
+     `git diff` — é a mesma brecha de terminal que existe no Claude Code e no Cursor, e o
+     que a fecha ali é a proibição no texto abaixo. Só o OpenCode a fecha por configuração. -->
+
+
 # Revisor de Conformidade
 
 Você responde **uma única pergunta**: *o que foi implementado atende ao que a `spec.md` pediu?*

.agents/agents/tutor.md

@@ -1,8 +1,20 @@
 ---
 name: tutor
 description: Ensina o aluno, em nível bem didático, o que uma tarefa vai construir (antes) ou o que o diff construiu (depois). Não escreve código, não corrige, não opina sobre qualidade. Também explica decisões da spec e gera o simulado pré-PR.
+mainAgent: false
+subagent: true
+tools:
+  - view_file
+  - grep_search
+  - run_command
 ---
 
+<!-- A lista `tools:` acima é a trava de escrita no Antigravity: sem `replace_file_content`,
+     este agente não tem como editar arquivo. `run_command` fica porque ele precisa rodar
+     `git diff` — é a mesma brecha de terminal que existe no Claude Code e no Cursor, e o
+     que a fecha ali é a proibição no texto abaixo. Só o OpenCode a fecha por configuração. -->
+
+
 # Tutor
 
 Você tem uma função só: **ensinar**. O aluno está aprendendo NestJS, Prisma e o frontend enquanto constrói o projeto — trate **todo conceito como possivelmente novo** para ele. Sua explicação é o que o prepara para a defesa presencial, onde ele terá que explicar cada trecho **sem você**.

.cursor/agents/auditor-final.md

@@ -0,0 +1,8 @@
+---
+name: auditor-final
+description: Compara o diff inteiro da branch contra o spec.md original, antes do Pull Request. Somente leitura.
+readonly: true
+---
+Leia `.agents/agents/auditor-final.md` e siga-o integralmente antes de qualquer outra ação.
+
+O terminal existe apenas para `git diff`, `git log` e para rodar os testes. É proibido usá-lo para alterar qualquer arquivo.

.cursor/agents/implementador.md

@@ -0,0 +1,5 @@
+---
+name: implementador
+description: Implementa UMA tarefa do plan.md seguindo TDD, com contexto limpo. Não revisa o próprio trabalho.
+---
+Leia `.agents/agents/implementador.md` e siga-o integralmente antes de qualquer outra ação.

.cursor/agents/revisor-codigo.md

@@ -0,0 +1,8 @@
+---
+name: revisor-codigo
+description: Revisa a qualidade do código de uma tarefa contra docs/architecture.md. Somente leitura — aponta, nunca corrige.
+readonly: true
+---
+Leia `.agents/agents/revisor-codigo.md` e siga-o integralmente antes de qualquer outra ação.
+
+O terminal existe apenas para `git diff`, `git log` e para rodar os testes. É proibido usá-lo para alterar qualquer arquivo.

.cursor/agents/revisor-conformidade.md

@@ -0,0 +1,8 @@
+---
+name: revisor-conformidade
+description: Compara o diff de uma tarefa contra os critérios de aceite do spec.md. Somente leitura — aponta, nunca corrige.
+readonly: true
+---
+Leia `.agents/agents/revisor-conformidade.md` e siga-o integralmente antes de qualquer outra ação.
+
+O terminal existe apenas para `git diff`, `git log` e para rodar os testes. É proibido usá-lo para alterar qualquer arquivo.

.cursor/agents/tutor.md

@@ -0,0 +1,8 @@
+---
+name: tutor
+description: Ensina o aluno — explica a tarefa antes, o diff depois, a spec e o simulado pré-PR. Não escreve código, não corrige, não opina sobre qualidade.
+readonly: true
+---
+Leia `.agents/agents/tutor.md` e siga-o integralmente antes de qualquer outra ação.
+
+O terminal existe apenas para `git diff`, `git log` e para rodar os testes. É proibido usá-lo para alterar qualquer arquivo.

.cursor/commands/utf-architecture.md

@@ -0,0 +1,5 @@
+---
+description: Gera o docs/architecture.md por entrevista guiada — stack, monorepo, testes, glossário técnico e diagrama ER. Roda depois do /utf-flows.
+---
+
+Leia `.agents/workflows/architecture.md` e execute-o integralmente.

.cursor/commands/utf-backlog.md

@@ -0,0 +1,5 @@
+---
+description: Leva as stories Ready do prd.md para o GitHub — uma Issue por story e orientação do Kanban. Exige gh autenticado ou MCP do GitHub.
+---
+
+Leia `.agents/workflows/backlog.md` e execute-o integralmente.

.cursor/commands/utf-flows.md

@@ -0,0 +1,5 @@
+---
+description: Desenha as jornadas de usuário e os tokens de design. Obriga pelo menos uma jornada com ponto de desistência. Roda antes do /utf-architecture.
+---
+
+Leia `.agents/workflows/user-flows.md` e execute-o integralmente.

.cursor/commands/utf-issue.md

@@ -0,0 +1,7 @@
+---
+description: Inicia o ciclo SDD completo de uma Issue — brainstorming, spec.md, plan.md e execução tarefa a tarefa.
+---
+
+Leia `.agents/workflows/utf-workflow.md` e execute-o integralmente.
+
+Issue a trabalhar: o valor que o usuário escreveu depois do comando.

.cursor/commands/utf-prd.md

@@ -0,0 +1,5 @@
+---
+description: Gera o docs/prd.md por entrevista guiada — tema, glossário, atores, user stories, regras de negócio e NFRs. Roda antes do /utf-flows.
+---
+
+Leia `.agents/workflows/prd.md` e execute-o integralmente.

.cursor/commands/utf-setup.md

@@ -0,0 +1,5 @@
+---
+description: Gera a estrutura inicial do monorepo a partir do docs/architecture.md. Roda uma vez, antes da primeira Issue. Task de manutenção — sem spec.
+---
+
+Leia `.agents/workflows/setup.md` e execute-o integralmente.

.cursor/commands/utf-task.md

@@ -0,0 +1,7 @@
+---
+description: Executa UMA tarefa do plan.md com implementador de contexto limpo, dois revisores somente-leitura e limite de 2 rodadas de revisão. Sem número, pega a próxima pendente.
+---
+
+Leia `.agents/workflows/ciclo-tarefa.md` e execute-o integralmente.
+
+Tarefa a executar: o valor que o usuário escreveu depois do comando.

.cursor/commands/utf-tutor.md

@@ -0,0 +1,7 @@
+---
+description: Chama o agente tutor: <n> explica a tarefa já implementada; antes <n> explica antes de implementar; spec explica a spec em rascunho; prova conduz o simulado pré-PR.
+---
+
+Leia `.agents/workflows/tutor.md` e execute-o integralmente.
+
+Argumento: o valor que o usuário escreveu depois do comando.

.cursor/rules/utf-rules.mdc

@@ -0,0 +1,9 @@
+---
+description: Constituição da disciplina — as regras inegociáveis do método UTF-SDD.
+alwaysApply: true
+---
+
+Leia `.agents/rules/utf-rules.md` e obedeça-o integralmente. Ele é a constituição
+deste repositório; este arquivo é só a casca do Cursor.
+
+@.agents/rules/utf-rules.md

.opencode/agents/auditor-final.md

@@ -0,0 +1,26 @@
+---
+description: Compara o diff inteiro da branch contra o spec.md original, antes do Pull Request. Somente leitura.
+mode: subagent
+tools:
+  write: false
+  edit: false
+  patch: false
+permission:
+  edit: deny
+  bash:
+    "*": deny
+    "git diff*": allow
+    "git log*": allow
+    "git status*": allow
+    "ls*": allow
+    "cat*": allow
+    "npm test*": allow
+    "npm run test*": allow
+    "npx vitest*": allow
+    "npx jest*": allow
+---
+Leia `.agents/agents/auditor-final.md` e siga-o integralmente antes de qualquer outra ação.
+
+> A lista de comandos liberados acima cobre git e os testes mais comuns.
+> **Ajuste-a à stack declarada no `docs/architecture.md`** — comando de teste
+> que não estiver liberado simplesmente não roda, e o parecer sai incompleto.

.opencode/agents/implementador.md

@@ -0,0 +1,5 @@
+---
+description: Implementa UMA tarefa do plan.md seguindo TDD, com contexto limpo. Não revisa o próprio trabalho.
+mode: subagent
+---
+Leia `.agents/agents/implementador.md` e siga-o integralmente antes de qualquer outra ação.

.opencode/agents/revisor-codigo.md

@@ -0,0 +1,26 @@
+---
+description: Revisa a qualidade do código de uma tarefa contra docs/architecture.md. Somente leitura — aponta, nunca corrige.
+mode: subagent
+tools:
+  write: false
+  edit: false
+  patch: false
+permission:
+  edit: deny
+  bash:
+    "*": deny
+    "git diff*": allow
+    "git log*": allow
+    "git status*": allow
+    "ls*": allow
+    "cat*": allow
+    "npm test*": allow
+    "npm run test*": allow
+    "npx vitest*": allow
+    "npx jest*": allow
+---
+Leia `.agents/agents/revisor-codigo.md` e siga-o integralmente antes de qualquer outra ação.
+
+> A lista de comandos liberados acima cobre git e os testes mais comuns.
+> **Ajuste-a à stack declarada no `docs/architecture.md`** — comando de teste
+> que não estiver liberado simplesmente não roda, e o parecer sai incompleto.

.opencode/agents/revisor-conformidade.md

@@ -0,0 +1,26 @@
+---
+description: Compara o diff de uma tarefa contra os critérios de aceite do spec.md. Somente leitura — aponta, nunca corrige.
+mode: subagent
+tools:
+  write: false
+  edit: false
+  patch: false
+permission:
+  edit: deny
+  bash:
+    "*": deny
+    "git diff*": allow
+    "git log*": allow
+    "git status*": allow
+    "ls*": allow
+    "cat*": allow
+    "npm test*": allow
+    "npm run test*": allow
+    "npx vitest*": allow
+    "npx jest*": allow
+---
+Leia `.agents/agents/revisor-conformidade.md` e siga-o integralmente antes de qualquer outra ação.
+
+> A lista de comandos liberados acima cobre git e os testes mais comuns.
+> **Ajuste-a à stack declarada no `docs/architecture.md`** — comando de teste
+> que não estiver liberado simplesmente não roda, e o parecer sai incompleto.

.opencode/agents/tutor.md

@@ -0,0 +1,22 @@
+---
+description: Ensina o aluno — explica a tarefa antes, o diff depois, a spec e o simulado pré-PR. Não escreve código, não corrige, não opina sobre qualidade.
+mode: subagent
+tools:
+  write: false
+  edit: false
+  patch: false
+permission:
+  edit: deny
+  bash:
+    "*": deny
+    "git diff*": allow
+    "git log*": allow
+    "git status*": allow
+    "ls*": allow
+    "cat*": allow
+---
+Leia `.agents/agents/tutor.md` e siga-o integralmente antes de qualquer outra ação.
+
+> A lista de comandos liberados acima cobre git e os testes mais comuns.
+> **Ajuste-a à stack declarada no `docs/architecture.md`** — comando de teste
+> que não estiver liberado simplesmente não roda, e o parecer sai incompleto.

.opencode/command/utf-architecture.md

@@ -0,0 +1,5 @@
+---
+description: Gera o docs/architecture.md por entrevista guiada — stack, monorepo, testes, glossário técnico e diagrama ER. Roda depois do /utf-flows.
+---
+
+Leia `.agents/workflows/architecture.md` e execute-o integralmente.

.opencode/command/utf-backlog.md

@@ -0,0 +1,5 @@
+---
+description: Leva as stories Ready do prd.md para o GitHub — uma Issue por story e orientação do Kanban. Exige gh autenticado ou MCP do GitHub.
+---
+
+Leia `.agents/workflows/backlog.md` e execute-o integralmente.

.opencode/command/utf-flows.md

@@ -0,0 +1,5 @@
+---
+description: Desenha as jornadas de usuário e os tokens de design. Obriga pelo menos uma jornada com ponto de desistência. Roda antes do /utf-architecture.
+---
+
+Leia `.agents/workflows/user-flows.md` e execute-o integralmente.

.opencode/command/utf-issue.md

@@ -0,0 +1,7 @@
+---
+description: Inicia o ciclo SDD completo de uma Issue — brainstorming, spec.md, plan.md e execução tarefa a tarefa.
+---
+
+Leia `.agents/workflows/utf-workflow.md` e execute-o integralmente.
+
+Issue a trabalhar: $ARGUMENTS

.opencode/command/utf-prd.md

@@ -0,0 +1,5 @@
+---
+description: Gera o docs/prd.md por entrevista guiada — tema, glossário, atores, user stories, regras de negócio e NFRs. Roda antes do /utf-flows.
+---
+
+Leia `.agents/workflows/prd.md` e execute-o integralmente.

.opencode/command/utf-setup.md

@@ -0,0 +1,5 @@
+---
+description: Gera a estrutura inicial do monorepo a partir do docs/architecture.md. Roda uma vez, antes da primeira Issue. Task de manutenção — sem spec.
+---
+
+Leia `.agents/workflows/setup.md` e execute-o integralmente.

.opencode/command/utf-task.md

@@ -0,0 +1,7 @@
+---
+description: Executa UMA tarefa do plan.md com implementador de contexto limpo, dois revisores somente-leitura e limite de 2 rodadas de revisão. Sem número, pega a próxima pendente.
+---
+
+Leia `.agents/workflows/ciclo-tarefa.md` e execute-o integralmente.
+
+Tarefa a executar: $ARGUMENTS

.opencode/command/utf-tutor.md

@@ -0,0 +1,7 @@
+---
+description: Chama o agente tutor: <n> explica a tarefa já implementada; antes <n> explica antes de implementar; spec explica a spec em rascunho; prova conduz o simulado pré-PR.
+---
+
+Leia `.agents/workflows/tutor.md` e execute-o integralmente.
+
+Argumento: $ARGUMENTS

AGENTS.md

@@ -0,0 +1,7 @@
+# Regras deste repositório
+
+Leia `.agents/rules/utf-rules.md` e obedeça-o integralmente — é a constituição do
+método UTF-SDD, e vale para qualquer agente que trabalhe aqui.
+
+Os fluxos ficam em `.agents/workflows/` e os subagentes em `.agents/agents/`.
+Cada harness tem só a casca: `.claude/`, `.cursor/`, `.opencode/`. O conteúdo é um só.