sinapse-ai 7.7.1 → 7.7.3

package/.sinapse-ai/data/registry-update-log.jsonl

@@ -551,3 +551,9 @@
 {"timestamp":"2026-03-30T18:05:54.953Z","action":"change","path":".sinapse-ai/development/tasks/dev-develop-story.md","trigger":"watcher"}
 {"timestamp":"2026-03-30T18:05:54.953Z","action":"change","path":".sinapse-ai/development/tasks/health-check.yaml","trigger":"watcher"}
 {"timestamp":"2026-03-30T18:05:54.953Z","action":"change","path":".sinapse-ai/product/templates/ide-rules/claude-rules.md","trigger":"watcher"}
+{"timestamp":"2026-04-02T01:14:38.759Z","action":"change","path":".sinapse-ai/core/doctor/checks/constitution-consistency.js","trigger":"watcher"}
+{"timestamp":"2026-04-02T01:14:38.761Z","action":"change","path":".sinapse-ai/core/health-check/checks/project/constitution-consistency.js","trigger":"watcher"}
+{"timestamp":"2026-04-02T01:14:38.762Z","action":"change","path":".sinapse-ai/product/templates/ide-rules/claude-rules.md","trigger":"watcher"}
+{"timestamp":"2026-04-02T01:18:15.933Z","action":"change","path":".sinapse-ai/core/doctor/checks/constitution-consistency.js","trigger":"watcher"}
+{"timestamp":"2026-04-02T01:18:15.934Z","action":"change","path":".sinapse-ai/core/health-check/checks/project/constitution-consistency.js","trigger":"watcher"}
+{"timestamp":"2026-04-02T01:18:15.934Z","action":"change","path":".sinapse-ai/product/templates/ide-rules/claude-rules.md","trigger":"watcher"}

package/.sinapse-ai/infrastructure/templates/safe-collab/CODEOWNERS.template

@@ -0,0 +1,16 @@
+# Code Owners — {{PROJECT_NAME}}
+# All PRs require approval from an owner before merge.
+
+# Default: all files require owner review
+* @{{OWNER_GITHUB}} @{{COLLAB_GITHUB}}
+
+# Critical paths (framework, config, CI/CD)
+.sinapse-ai/   @{{OWNER_GITHUB}}
+.claude/        @{{OWNER_GITHUB}}
+.github/        @{{OWNER_GITHUB}}
+package.json    @{{OWNER_GITHUB}}
+
+# Security-sensitive
+.env*           @{{OWNER_GITHUB}}
+*.config.js     @{{OWNER_GITHUB}}
+*.config.ts     @{{OWNER_GITHUB}}

package/.sinapse-ai/infrastructure/templates/safe-collab/README.md

@@ -0,0 +1,66 @@
+# Safe Collaboration Template
+
+Template reutilizavel para configurar colaboracao segura em qualquer projeto.
+
+## Uso rapido
+
+```bash
+bash apply.sh <projeto> <owner-github> <collab-github> [prefix1] [prefix2]
+```
+
+### Exemplo
+
+```bash
+bash .sinapse-ai/infrastructure/templates/safe-collab/apply.sh \
+  /path/to/meu-projeto \
+  caioimori \
+  Matheus-soier \
+  caio \
+  soier
+```
+
+Isso cria automaticamente:
+- `.claude/rules/safe-collaboration.md` — regras para agentes
+- `.github/PULL_REQUEST_TEMPLATE.md` — template simplificado de PR
+- `.github/CODEOWNERS` — code owners configurado
+- `docs/guides/parallel-workflow.md` — guia para equipe
+- Atualiza `.gitignore` com patterns de runtime
+
+## Configuracao manual no GitHub
+
+Apos rodar o script, configure no repositorio:
+
+1. **Settings > Rules > Rulesets > New ruleset** (target: `main`)
+   - Block direct pushes
+   - Require 1 PR approval
+   - Block force pushes
+   - Block branch deletion
+   - Dismiss stale reviews
+
+2. **Settings > Collaborators**
+   - Adicionar membros com permissao `Write` (nunca Admin)
+
+3. **Settings > General**
+   - Marcar "Automatically delete head branches"
+
+## Arquivos incluidos
+
+| Arquivo | Proposito |
+|---------|-----------|
+| `apply.sh` | Script de aplicacao automatica |
+| `safe-collaboration-rule.md` | Regra para `.claude/rules/` |
+| `parallel-workflow-guide.md` | Guia para equipe |
+| `CODEOWNERS.template` | Template de code owners |
+| `pull_request_template.md` | PR template simplificado |
+
+## Placeholders
+
+| Placeholder | Descricao | Exemplo |
+|-------------|-----------|---------|
+| `{{USER_1}}` | Nome do usuario 1 | Caio |
+| `{{USER_2}}` | Nome do usuario 2 | Matheus |
+| `{{user1}}` | Prefixo de branch user 1 | caio |
+| `{{user2}}` | Prefixo de branch user 2 | soier |
+| `{{OWNER_GITHUB}}` | Username GitHub do owner | caioimori |
+| `{{COLLAB_GITHUB}}` | Username GitHub do collab | Matheus-soier |
+| `{{PROJECT_NAME}}` | Nome do projeto | meu-projeto |

package/.sinapse-ai/infrastructure/templates/safe-collab/apply.sh

@@ -0,0 +1,85 @@
+#!/bin/bash
+# apply.sh — Apply safe-collab template to a target project
+# Usage: bash apply.sh <target-dir> <owner-github> <collab-github> [user1-prefix] [user2-prefix]
+#
+# Example:
+#   bash apply.sh /path/to/my-project caioimori Matheus-soier caio soier
+
+set -e
+
+TARGET="${1:?Usage: bash apply.sh <target-dir> <owner-github> <collab-github> [user1] [user2]}"
+OWNER="${2:?Missing owner GitHub username}"
+COLLAB="${3:?Missing collaborator GitHub username}"
+USER1="${4:-dev1}"
+USER2="${5:-dev2}"
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+echo "=== Safe Collaboration Setup ==="
+echo "Target: $TARGET"
+echo "Owner: @$OWNER"
+echo "Collaborator: @$COLLAB"
+echo "Branch prefixes: $USER1/, $USER2/"
+echo ""
+
+# Create directories
+mkdir -p "$TARGET/.claude/rules"
+mkdir -p "$TARGET/.github"
+mkdir -p "$TARGET/docs/guides"
+
+# Copy and customize rule file
+sed -e "s/{{USER_1}}/$USER1/g" \
+    -e "s/{{USER_2}}/$USER2/g" \
+    -e "s/{{user1}}/$USER1/g" \
+    -e "s/{{user2}}/$USER2/g" \
+    "$SCRIPT_DIR/safe-collaboration-rule.md" > "$TARGET/.claude/rules/safe-collaboration.md"
+echo "[OK] .claude/rules/safe-collaboration.md"
+
+# Copy PR template
+cp "$SCRIPT_DIR/pull_request_template.md" "$TARGET/.github/PULL_REQUEST_TEMPLATE.md"
+echo "[OK] .github/PULL_REQUEST_TEMPLATE.md"
+
+# Copy and customize CODEOWNERS
+sed -e "s/{{PROJECT_NAME}}/$(basename "$TARGET")/g" \
+    -e "s/{{OWNER_GITHUB}}/$OWNER/g" \
+    -e "s/{{COLLAB_GITHUB}}/$COLLAB/g" \
+    "$SCRIPT_DIR/CODEOWNERS.template" > "$TARGET/.github/CODEOWNERS"
+echo "[OK] .github/CODEOWNERS"
+
+# Copy workflow guide
+cp "$SCRIPT_DIR/parallel-workflow-guide.md" "$TARGET/docs/guides/parallel-workflow.md"
+echo "[OK] docs/guides/parallel-workflow.md"
+
+# Add runtime patterns to .gitignore if not already present
+GITIGNORE="$TARGET/.gitignore"
+if [ -f "$GITIGNORE" ]; then
+  if ! grep -q '.sinapse-ai/.cache/' "$GITIGNORE" 2>/dev/null; then
+    echo "" >> "$GITIGNORE"
+    echo "# SINAPSE runtime artifacts" >> "$GITIGNORE"
+    echo ".sinapse-ai/.cache/" >> "$GITIGNORE"
+    echo ".sinapse-ai/.tmp/" >> "$GITIGNORE"
+    echo "[OK] .gitignore updated"
+  else
+    echo "[OK] .gitignore already has runtime patterns"
+  fi
+else
+  echo "[SKIP] No .gitignore found"
+fi
+
+echo ""
+echo "=== Files applied. Now configure GitHub: ==="
+echo ""
+echo "1. Settings > Rules > Rulesets > New ruleset (target: main)"
+echo "   - Block direct pushes"
+echo "   - Require 1 PR approval"
+echo "   - Block force pushes"
+echo "   - Block branch deletion"
+echo "   - Dismiss stale reviews"
+echo ""
+echo "2. Settings > Collaborators"
+echo "   - Add @$COLLAB with Write permission"
+echo ""
+echo "3. Settings > General"
+echo "   - Check 'Automatically delete head branches'"
+echo ""
+echo "Done. Safe collaboration is ready."

package/.sinapse-ai/infrastructure/templates/safe-collab/parallel-workflow-guide.md

@@ -0,0 +1,55 @@
+# Trabalhando em Paralelo — Guia para a Equipe
+
+## TL;DR
+
+Voces focam no codigo. O Claude Code cuida do git.
+
+## Glossario
+
+| Termo | Significado |
+|-------|-------------|
+| **main** | Versao oficial do projeto. Ninguem mexe direto. |
+| **branch** | Copia temporaria onde voce trabalha com seguranca. |
+| **PR** | Pedido para o outro revisar suas mudancas. |
+| **merge** | Juntar mudancas no main apos aprovacao. |
+| **conflito** | Dois mexeram no mesmo trecho. O agente resolve. |
+
+## Fluxo
+
+```
+Voce pede → Agente cria area segura → Trabalha → Agente salva
+→ Envia para revisao → Outro aprova → Vai pro main
+```
+
+## O que voce FAZ
+
+1. Abrir o Claude Code
+2. Pedir o que quer fazer
+3. Revisar o que mudou
+4. Aprovar mudancas do outro no GitHub
+
+## Regras
+
+1. **Dividam areas** — combinem quem mexe onde
+2. **Mudancas pequenas** — enviem todo dia, nao acumulem
+3. **Atualizem no inicio** — diga "sincroniza e cria branch para [tarefa]"
+4. **Nunca trabalhem no main** — sempre em branch
+5. **Avisem antes de mexer na area do outro**
+
+## Se algo der errado
+
+| Problema | Solucao |
+|----------|---------|
+| Codigo sumiu | Nada some. Peca ao agente recuperar. |
+| Conflito | Agente resolve. Mostra as versoes. |
+| Push rejeitado | Agente atualiza e tenta de novo. |
+| PR com problema | Agente corrige e reenvia. |
+
+## Aprovando PRs
+
+1. GitHub > Pull requests
+2. Clique na PR
+3. Review changes > Approve > Submit
+4. Squash and merge
+
+Branch e apagada automaticamente.

package/.sinapse-ai/infrastructure/templates/safe-collab/pull_request_template.md

@@ -0,0 +1,11 @@
+## O que mudou?
+<!-- Descreva brevemente o que essa PR faz -->
+
+## Por que?
+<!-- Link para issue/story ou explique o motivo -->
+
+## Checklist
+- [ ] Testei localmente
+- [ ] Sem erros ou warnings novos
+- [ ] Nao modifiquei arquivos em .sinapse-ai/ ou .claude/ (a menos que fosse necessario)
+- [ ] Nao tem senhas, tokens ou chaves no codigo

package/.sinapse-ai/infrastructure/templates/safe-collab/safe-collaboration-rule.md

@@ -0,0 +1,93 @@
+# Safe Collaboration — Git Safety Net (NON-NEGOTIABLE)
+
+> **Applies to ALL agents in this project.**
+> Users are product builders, NOT git experts.
+> Agents MUST handle ALL git complexity automatically and safely.
+
+## Golden Rule
+
+**Users focus on WHAT to build. Agents handle HOW to save and share it safely.**
+
+Users should NEVER need to:
+- Resolve merge conflicts manually
+- Decide which branch to use
+- Remember to pull before working
+- Worry about overwriting each other's code
+
+## Session Start — Auto-Sync (MANDATORY)
+
+Before ANY work begins, the agent MUST:
+1. `git fetch origin`
+2. Check if local main is behind origin/main
+3. If behind: `git pull origin main` (fast-forward only)
+4. If diverged: STOP, inform user, resolve safely
+5. Create work branch if not already on one
+6. NEVER start work on `main` directly
+
+## Branch Naming — Automatic
+
+| Who | Pattern | Example |
+|-----|---------|---------|
+| {{USER_1}} | `{{user1}}/{type}/{desc}` | `{{user1}}/feat/new-feature` |
+| {{USER_2}} | `{{user2}}/{type}/{desc}` | `{{user2}}/fix/bug-fix` |
+
+Types: `feat`, `fix`, `refactor`, `docs`, `chore`, `test`
+
+**User Detection (priority order):**
+1. `git config user.name` -> lookup in mapping table (case-insensitive)
+2. `$USERNAME` (Windows) or `$USER` (Unix) -> lookup
+3. Fallback: `dev/`
+
+| git config / env contains | Branch prefix |
+|----------------------------|---------------|
+| {{user1}} (case-insensitive) | `{{user1}}/` |
+| {{user2}} (case-insensitive) | `{{user2}}/` |
+| (anything else)              | `dev/`        |
+
+## Before Every Commit — Safety Checks
+
+1. `git status` — verify only expected files changed
+2. `git diff --stat` — show summary to user
+3. SECRET SCAN — reject .env, API keys, tokens, passwords, private keys
+4. Commit with conventional message
+
+## Before Push — Conflict Prevention
+
+1. `git fetch origin main`
+2. `git merge origin/main --no-edit` (into feature branch)
+3. If conflicts: agent resolves (simple: auto, complex: ask user)
+4. Run tests after merge
+5. Only then: push
+
+## PR Creation — Automatic
+
+1. `gh pr create` with clear title/description
+2. Auto-assign other team member as reviewer
+3. Inform user in simple language
+
+## Conflict Resolution
+
+| Scenario | Action |
+|----------|--------|
+| Same file, different sections | Auto-merge |
+| Same file, same lines | Show both, ask user |
+| package.json version | Take higher version |
+| Generated files | Regenerate |
+| Docs | Merge both (additive) |
+
+## Destructive Operations — BLOCKED
+
+These require EXPLICIT user confirmation:
+- `git push --force` / `--force-with-lease`
+- `git reset --hard`
+- `git branch -D`
+- `git clean -f`
+
+## Anti-Patterns (FORBIDDEN)
+
+- Working on `main` directly
+- Pushing without PR
+- Skipping `git fetch` at session start
+- Using `--force` without confirmation
+- Committing secrets
+- Skipping tests after conflict resolution

package/.sinapse-ai/install-manifest.yaml

@@ -7,10 +7,10 @@
 # - SHA256 hashes for change detection
 # - File types for categorization
 #
-version: 7.7.1
-generated_at: "2026-04-01T21:15:14.671Z"
+version: 7.7.3
+generated_at: "2026-04-02T01:44:04.986Z"
 generator: scripts/generate-install-manifest.js
-file_count: 1107
+file_count: 1113
 files:
   - path: cli/commands/config/index.js
     hash: sha256:66f111eceef0f60fa0a8904add783b615d55b01d5fe36408623c3dd828e702f6
@@ -313,9 +313,9 @@ files:
     type: core
     size: 1724
   - path: core/doctor/checks/constitution-consistency.js
-    hash: sha256:659489ab7c353f4b69473e72b046e43ada1342acdc017398cb6a0b60ffb0ef5b
+    hash: sha256:7d61a71fcc8eeaf139a9bea634dff99154441808e8411f4290ae5a34fa919951
     type: core
-    size: 3083
+    size: 3107
   - path: core/doctor/checks/core-config.js
     hash: sha256:5424528eefbc2f19213b30d00dcd96128acefdbb289c25712be844f0fbddb963
     type: core
@@ -581,9 +581,9 @@ files:
     type: core
     size: 4733
   - path: core/health-check/checks/project/constitution-consistency.js
-    hash: sha256:55cd12c67c7dfbd35dc25db20b35b94fa4e8e5104488dacf6fc4834be73eb767
+    hash: sha256:63f4aa67ac27b337d017c7b642b1e3554bd02554fa69e29b14ebb8922827b4b9
     type: core
-    size: 5883
+    size: 5960
   - path: core/health-check/checks/project/dependencies.js
     hash: sha256:a8f4d9fcadf5dc3274d8ed0605af6f25d6554b1a9b0d3e66c63d8ea4569c95b9
     type: core
@@ -1237,9 +1237,9 @@ files:
     type: data
     size: 9586
   - path: data/entity-registry.yaml
-    hash: sha256:0ef926d7947a2e9a9b95e20a7309f9910b0ba2004bf18c9472d71bdc2b5fa9c9
+    hash: sha256:17d002e1c7b1dc347bc369fd82b28a931babcb69f16efc9ac76eb484eaacc1a1
     type: data
-    size: 512364
+    size: 511993
   - path: data/learned-patterns.yaml
     hash: sha256:24ac0b160615583a0ff783d3da8af80b7f94191575d6db2054ec8e10a3f945dc
     type: data
@@ -3508,6 +3508,30 @@ files:
     hash: sha256:4c9b70cacde88097d53f9d4d6e2319f65cabf6a076047195cdcf949d9e949512
     type: template
     size: 5567
+  - path: infrastructure/templates/safe-collab/apply.sh
+    hash: sha256:1f9d39834ff301e3ee1adf1779fc3dd9e22bd12c9a603f8ff11d430c1328ed82
+    type: template
+    size: 2738
+  - path: infrastructure/templates/safe-collab/CODEOWNERS.template
+    hash: sha256:988d5f6e373df03913d84c11cc42af42917f702920059ef296b2b236be7387e8
+    type: template
+    size: 476
+  - path: infrastructure/templates/safe-collab/parallel-workflow-guide.md
+    hash: sha256:773473b226fe19eb5f6b9769f28c3388fba6f0700ca4c2bd80af9891f34dc433
+    type: template
+    size: 1485
+  - path: infrastructure/templates/safe-collab/pull_request_template.md
+    hash: sha256:1f07f6cb99640c15e11c685debd2dd66dc46ec4dce6a80ba3f1efdc3fb2e5bd7
+    type: template
+    size: 338
+  - path: infrastructure/templates/safe-collab/README.md
+    hash: sha256:53e1193eaf30b5a4d9a5d2c5f700b22a210515abb661baf2b5ebe056343806fe
+    type: template
+    size: 1958
+  - path: infrastructure/templates/safe-collab/safe-collaboration-rule.md
+    hash: sha256:9631681340fddc314080f9182b76ccfbb1ee3441d92ce181067e76cace960a5e
+    type: template
+    size: 2871
   - path: infrastructure/templates/sinapse-sync.yaml.template
     hash: sha256:36ada7873fcbd5bab225b528c7be39035a12fc156135cc82c73d75782d7c53a2
     type: template
@@ -3929,9 +3953,9 @@ files:
     type: template
     size: 3691
   - path: product/templates/ide-rules/claude-rules.md
-    hash: sha256:ffdaf95cccaba6355368ca2e3ba2d2675e2661c52a91adaeb5cc265dca894f5a
+    hash: sha256:e82e8b6cc5c64791ba3a70ca728a920ce522d56e9a60dd0bb4ee76b9a150adf9
     type: template
-    size: 13296
+    size: 13341
   - path: product/templates/ide-rules/codex-rules.md
     hash: sha256:601ffec5e24ff5e247c25e4d61728167503722acc817a1b30fbd695182bed1bc
     type: template

package/.sinapse-ai/product/templates/ide-rules/claude-rules.md

@@ -27,6 +27,7 @@ O SINAPSE possui uma **Constitution formal** com princípios inegociáveis e gat
 | VI | Absolute Imports | SHOULD |
 | VII | Ecosystem Metrics Accuracy | NON-NEGOTIABLE |
 | VIII | Mandatory Delegation | NON-NEGOTIABLE |
+| IX | Safe Collaboration | NON-NEGOTIABLE |
 
 **Gates automáticos bloqueiam violações.** Consulte a Constitution para detalhes completos.
 <!-- SINAPSE-MANAGED-END: constitution -->

package/docs/ORQX-PLAN.md

@@ -188,8 +188,9 @@ Pente fino em cada arquivo do framework. Zero assinaturas escondidas, zero easte
 - [ ] `.github/workflows/` — actions com refs externas
 - [ ] `scripts/` — automacoes com refs externas
 - [ ] `packages/` — package.json internos (author, contributors, repository)
-- [ ] Git tags — verificar se alguma tag referencia AIOX
-- [ ] Git commit messages — verificar se tem refs problematicas (informativo, nao rewrite)
+- [x] Git tags — verificar se alguma tag referencia AIOX (VERIFIED 2026-04-02: ZERO tags AIOX)
+- [x] Git commit messages — verificar se tem refs problematicas (informativo, nao rewrite)
+- [x] GitHub Issues/PRs/Labels/Milestones — VERIFIED 2026-04-02: 0 issues, 0 PRs, 0 AIOX labels, description=SINAPSE
 
 ### Pos-Audit
 - [ ] Regenerar package-lock.json limpo (`npm install`)

package/docs/getting-started.md

@@ -39,7 +39,7 @@ cd my-first-project
 - Claude Code: `/agent-name`
 - Gemini CLI: `/sinapse-menu` then `/sinapse-<agent>`
 - Codex CLI: `/skills` then `sinapse-<agent-id>`
-- Cursor/Copilot/AntiGravity: follow constraints in `docs/ide-integration.md`
+- Cursor/Copilot: follow constraints in `docs/ide-integration.md`
 
 ### Step 3: Validate first value
 
@@ -179,7 +179,7 @@ Summary:
 | Codex CLI | Limited | `/skills` then `sinapse-<agent-id>` |
 | Cursor | Limited | `@agent` + synced rules |
 | GitHub Copilot | Limited | chat modes + repo instructions |
-| AntiGravity | Limited | workflow-driven activation |
+
 
 - **Works**: fully recommended for new users.
 - **Limited**: usable with documented workarounds.

package/docs/guides/parallel-workflow.md

@@ -0,0 +1,104 @@
+# Trabalhando em Paralelo — Guia para Caio e Matheus
+
+## TL;DR
+
+Voces focam no codigo. O Claude Code cuida do git.
+
+## Glossario rapido
+
+| Termo | O que significa |
+|-------|----------------|
+| **main** | A versao "oficial" do projeto. Ninguem mexe direto nela. |
+| **branch** | Uma copia temporaria onde voce trabalha sem afetar o main. |
+| **PR (Pull Request)** | Um pedido para o outro revisar e aprovar suas mudancas. |
+| **merge** | Juntar suas mudancas de volta no main apos aprovacao. |
+| **conflito** | Quando dois mexeram no mesmo trecho. O agente resolve. |
+
+## Como funciona
+
+```
+Voce pede algo → Agente cria area segura → Voce trabalha → Agente salva
+→ Agente envia para revisao → Outro aprova → Mudancas vao pro main
+```
+
+## O que voce FAZ
+
+1. **Abrir o Claude Code** no projeto
+2. **Pedir o que quer fazer** ("otimiza tal agent", "melhora o installer", etc)
+3. **Revisar o que o agente fez** (ele mostra o que mudou)
+4. **Aprovar mudancas do outro** no GitHub quando pedir
+
+## O que voce NAO precisa fazer
+
+- Criar branches (o agente cria)
+- Resolver conflitos (o agente resolve)
+- Lembrar de atualizar o projeto (o agente faz no inicio)
+- Escrever mensagens de commit (o agente escreve)
+- Saber comandos git (o agente sabe)
+
+## Regra #1: Dividam as areas
+
+Para evitar que os dois mexam no mesmo arquivo ao mesmo tempo:
+
+| Area | Responsavel |
+|------|-------------|
+| Installer, CLI, hooks | Caio |
+| Squads, agents, tasks | Matheus |
+| Docs, stories | Quem estiver trabalhando naquela feature |
+| Tests | Quem escreveu o codigo |
+
+Se precisar mexer na area do outro: **avisem antes no WhatsApp/Discord**.
+
+## Regra #2: Mudancas pequenas e frequentes
+
+- Uma PR por feature ou correcao
+- Nao acumule 3 dias de trabalho — envie todo dia
+- Mudanca pequena = revisao rapida = menos chance de conflito
+
+## Regra #3: Atualizar no inicio do dia
+
+Ao abrir o Claude Code, diga:
+
+> "sincroniza e cria branch para [o que vou fazer]"
+
+O agente atualiza tudo e cria uma area segura para trabalhar.
+
+## NUNCA faca isso
+
+- **Nunca trabalhe direto no main** — o GitHub bloqueia, mas se por algum motivo conseguir, PARE e avise
+- **Nunca delete branches do outro** — so delete as suas
+- **Nunca faca push sem antes pedir ao agente** — ele verifica conflitos antes
+
+## Se algo der errado
+
+| Problema | O que fazer |
+|----------|-------------|
+| "Meu codigo sumiu!" | Calma. Nada some no git. Peca ao agente: "recupera minhas mudancas" |
+| "Deu conflito" | Peca ao agente: "resolve o conflito". Ele mostra as duas versoes e pergunta qual manter. |
+| "Nao consigo enviar" | O main mudou. Peca ao agente: "atualiza minha branch e tenta de novo" |
+| "A PR ta com problema" | Peca ao agente: "corrige a PR". Ele atualiza e reenvia. |
+| "Fiz algo errado no main" | Peca ao agente: "desfaz a ultima mudanca no main". Ele sabe como reverter com seguranca. |
+
+## Aprovando mudancas do outro (unica coisa manual)
+
+1. Abra o GitHub do projeto na aba **Pull requests**
+2. Clique na PR do outro
+3. Leia o resumo do que mudou
+4. Clique **Review changes**
+5. Selecione **Approve**
+6. Clique **Submit review**
+7. Clique **Squash and merge** (junta tudo em uma mudanca limpa)
+
+Pronto. A branch temporaria e apagada automaticamente.
+
+## Dica: como pedir coisas ao agente
+
+Em vez de comandos tecnicos, fale normalmente:
+
+| Voce diz | O agente entende |
+|----------|------------------|
+| "salva meu trabalho" | git add + commit |
+| "envia pro Soier revisar" | push + criar PR |
+| "atualiza meu projeto" | git fetch + pull + merge |
+| "o que o Caio mudou?" | git log + diff |
+| "desfaz isso" | git revert (seguro) |

package/docs/guides/workflows/xref-phase2-templates.md

@@ -115,7 +115,7 @@ IDE-specific rule files generated during project setup. Referenced in service-re
 
 | # | File | Consuming Task(s) | Consuming Agent(s) | Workflow(s) | Orphan? |
 |---|------|--------------------|---------------------|-------------|---------|
-| 1 | `antigravity-rules.md` | -- (service-registry, workers.csv) | -- | -- | **WEAK** |
+
 | 2 | `claude-rules.md` | -- (service-registry, workers.csv) | -- | -- | **WEAK** |
 | 4 | `copilot-rules.md` | -- (service-registry, workers.csv) | -- | -- | **WEAK** |
 | 5 | `cursor-rules.md` | -- (service-registry, workers.csv) | -- | -- | **WEAK** |

package/docs/guides/workflows/xref-phase4-infra.md

@@ -126,7 +126,6 @@ These scripts exist in the scripts/ directory but are NOT part of the module's p
 | 4 | `scripts/ide-sync/redirect-generator.js` | IDE Sync | Creates redirect files for deprecated agents | `fs-extra` | ide-sync/index.js | No |
 | 5 | `scripts/ide-sync/transformers/claude-code.js` | IDE Sync | Transforms agent definitions for Claude Code | -- | ide-sync/index.js, tests | No |
 | 6 | `scripts/ide-sync/transformers/cursor.js` | IDE Sync | Transforms agent definitions for Cursor IDE | -- | ide-sync/index.js, tests | No |
-| 8 | `scripts/ide-sync/transformers/antigravity.js` | IDE Sync | Transforms agent definitions for Antigravity | -- | ide-sync/index.js, tests | No |
 
 ### 1.4 Documentation Integrity Sub-module (7 files)