ganbatte-os 0.2.1

package/docs/plan/plan-git-operations.md

@@ -0,0 +1,51 @@
+# Plan: Sistema de Git Operations com SSH Identity e Quality Gate
+
+**Data:** 2026-04-01
+**Status:** Implementado
+**Escopo:** .a8z-OS + G-OS
+
+## Problema
+
+Dois problemas resolvidos:
+
+1. **Identidade SSH** — Ao gerenciar multiplas contas GitHub via SSH aliases, agentes podem usar a identidade errada ou expor nomes de alias em output. Cada workspace precisa saber qual alias usar, e essa info tem que ficar local (gitignored).
+
+2. **Quality Gate pre-commit** — Commits iam para o repo sem validacao de TypeScript (`tsc --noEmit`) ou testes. Agora o agente roda ambos antes de commitar, e se houver erro, corrige antes de prosseguir.
+
+## Solucao
+
+### Identidade SSH Local
+
+Arquivo `ssh-identity.json` gravado em diretorio gitignored (`.gos-local/` ou `.a8z/local/`). Contem o alias SSH, git user e timestamp de validacao. Lido pela skill `commit-dev` antes de cada push.
+
+### Quality Gate Pre-Commit
+
+Script `scripts/hooks/pre-commit-validate.js` roda `tsc --noEmit` e testes do projeto. Integrado na skill `commit-dev` como passo obrigatorio antes do commit. Se falhar, o agente corrige e retenta (max 2 vezes).
+
+### Mascaramento de alias
+
+Alias SSH reais nao aparecem em nenhum output. Placeholder: `[configured-ssh-identity]`.
+
+## Componentes criados
+
+| Componente | Path | Tipo |
+|-----------|------|------|
+| git-ssh-setup | `skills/git-ssh-setup/SKILL.md` | Skill |
+| pre-commit-validate | `scripts/hooks/pre-commit-validate.js` | Script |
+| ssh-multi-account-setup | `playbooks/ssh-multi-account-setup.md` | Playbook |
+| git-operations | `squads/git-operations/` | Squad |
+| wf-ssh-setup | `squads/git-operations/workflows/wf-ssh-setup.yaml` | Workflow |
+| wf-safe-commit | `squads/git-operations/workflows/wf-safe-commit.yaml` | Workflow |
+
+## Componentes modificados
+
+| Componente | Path | Mudanca |
+|-----------|------|---------|
+| commit-dev | `skills/git-commit/SKILL.md` | Quality gate + SSH validation + mascaramento |
+| devops agent | `agents/profiles/devops.md` | Comando ssh-setup + principio SSH protection |
+| registries | `skills/registry.json` | Entrada git-ssh-setup |
+| manifestos | `manifests/*.json` | copyMap e modulos atualizados |
+
+## Tasks detalhadas
+
+Ver `docs/stacks/stack-git-operations.md`.

package/docs/plan-distribuicao-publica.md

@@ -0,0 +1,360 @@
+# Distribuicao Publica do G-OS via GitHub
+
+> **Data:** 2026-04-01 | **Status:** Aprovado | **Revisor:** Douglas Oliveira
+
+---
+
+## Objetivo
+
+Tornar o G-OS publico e distribuivel via GitHub. Sem NPM private packages.
+
+```bash
+# Instalacao
+git clone https://github.com/imdouglasoliveira/g-os.git meu-workspace
+cd meu-workspace
+node scripts/cli/gos-cli.js init
+
+# Atualizacao
+npm run gos:update
+```
+
+## Arquitetura
+
+```
+GitHub Publico --> git clone --> Workspace Local --> gos init --> Pronto
+                                                 --> gos update --> Atualizado
+```
+
+### Zonas de arquivos
+
+| Zona | Update sobrescreve? | Exemplos |
+|------|---------------------|----------|
+| Framework-managed | Sim (auto-resolve) | `agents/`, `skills/`, `scripts/` |
+| User-owned | Nunca | `packages/`, `config.json`, `data/clients/` |
+| Hibrido | Git merge padrao | `CLAUDE.md` |
+
+---
+
+## T-001 — CLI `gos-cli.js`
+
+P0 | 8 pts | backend | `scripts/cli/gos-cli.js` (NOVO)
+
+CLI zero-dependency em Node.js para gerenciar o workspace G-OS. Alicerce de toda a distribuicao — todos os outros scripts dependem dele. Modelado no `a8z-cli.js`, adaptado para o modelo git-based.
+
+Diferente do a8z-framework que se instala DENTRO de projetos via NPM, o G-OS E o workspace. O CLI configura o ambiente pos-clone e gerencia updates via git.
+
+### Comandos
+
+| Comando | O que faz |
+|---------|-----------|
+| `gos init` | Setup pos-clone |
+| `gos update` | Fetch + merge de upstream/main |
+| `gos doctor` | Validar integridade |
+| `gos version` | Mostrar versao + checar atualizacao |
+
+### Implementacao
+
+**1)** Criar `scripts/cli/gos-cli.js` com shebang `#!/usr/bin/env node`
+
+**2)** Utilitarios base (copiar padrao do `a8z-cli.js` linhas 1-150):
+- `readJson()`, `writeJson()`, `ensureDir()`, `pathExists()`
+- `log()`, `info()`, `success()`, `warn()`, `fail()` com cores ANSI
+- `getFlagValue()` para parsing de `--flag=value`
+- `exec()` wrapper para `child_process.execSync`
+
+**3)** `cmdInit()`:
+- Validar Node.js >= 18 (`process.version`)
+- Checar se ja inicializado (`.gos-local/install-log.json` existe)
+- Renomear remote `origin` para `upstream`: `git remote rename origin upstream`
+- Criar `.gos-local/` com subdirs: `worktrees/`, `outputs/`, `task-queue/`
+- Criar `packages/` com `.gitkeep` se nao existir
+- Chamar `setup-ide-adapters.js` via `require()` ou `execSync`
+- Chamar `check-ide-compat.js`
+- Merge `.gitignore` (adicionar entradas de `gos-install-manifest.json`)
+- Escrever `.gos-local/install-log.json`:
+  ```json
+  { "version": "0.2.0", "initializedAt": "2026-04-01T...", "nodeVersion": "v22.x" }
+  ```
+- Exibir sucesso + proximos passos
+
+**4)** `cmdUpdate()`:
+- Checar `git status --porcelain` — se dirty, rodar `git stash`
+- `git fetch upstream main`
+- Ler manifest para saber quais paths sao framework-managed
+- `git merge upstream/main --no-edit`
+- Conflitos em paths framework-managed: `git checkout --theirs <path>` + `git add <path>`
+- Conflitos em paths user-owned: abortar merge, pop stash, instruir usuario
+- Re-rodar `setup-ide-adapters.js` e `check-ide-compat.js`
+- Pop stash se fez stash
+- Logar em `.gos-local/update-log.json`
+- Mostrar changelog: `git log --oneline <commit-anterior>..HEAD`
+
+**5)** `cmdDoctor()`:
+- Ler `manifests/gos-install-manifest.json`
+- Validar cada path em `requiredPaths` existe
+- Validar `agents/profiles/index.json` — cada agent listado tem arquivo
+- Validar `skills/registry.json` — cada skill listada tem SKILL.md
+- Checar IDE adapters via `check-ide-compat.js`
+- Reportar versao de `package.json` e ultimo update
+
+**6)** `cmdVersion()`:
+- Ler versao de `package.json`
+- Tentar `git fetch upstream main --dry-run` para checar commits novos
+- Se houver: "Nova versao disponivel. Rode: npm run gos:update"
+
+**7)** `main()` com `switch(command)` dispatch
+
+### Aceite
+
+- DADO repo clonado QUANDO rodar `gos init` ENTAO remote renomeado, dirs criados, IDEs sincronizadas
+- DADO workspace inicializado QUANDO rodar `gos doctor` ENTAO checks passam sem erro
+- DADO commits novos no upstream QUANDO rodar `gos update` ENTAO merge acontece e IDEs re-sincronizadas
+- DADO mudancas locais QUANDO rodar update ENTAO stash automatico + restaurado apos merge
+
+### Referencia
+
+- `e:\Github\.a8z-framework\scripts\cli\a8z-cli.js` — linhas 1-150 (utils), 1598-1731 (init), 1737-1820 (update)
+- `scripts/integrations/setup-ide-adapters.js`
+- `scripts/integrations/check-ide-compat.js`
+
+Sem dependencias. DoD: CLI roda sem erros, 4 comandos funcionam, zero deps externas.
+
+---
+
+## T-002 — Install Manifest
+
+P0 | 2 pts | backend | `manifests/gos-install-manifest.json` (NOVO)
+
+Manifest JSON que classifica arquivos do workspace em zonas (framework-managed vs user-owned). O CLI usa isso para decidir como resolver conflitos durante updates — e o contrato entre framework e usuario.
+
+```json
+{
+  "version": "0.2.0",
+  "runtime": "gos-design-delivery",
+  "preserveUserContent": [
+    "packages/", "data/sprints/", "data/clients/", ".gos-local/", "config.json"
+  ],
+  "frameworkManaged": [
+    "agents/", "skills/", "squads/", "templates/", "prompts/",
+    "integrations/", "scripts/", "manifests/", "docs/", "playbooks/",
+    "AGENTS.md", "CLAUDE.md", "GEMINI.md"
+  ],
+  "requiredPaths": [
+    "agents/profiles/index.json", "skills/registry.json",
+    "manifests/g-os-runtime-manifest.json", "scripts/cli/gos-cli.js",
+    "scripts/integrations/setup-ide-adapters.js",
+    "scripts/integrations/check-ide-compat.js", "AGENTS.md", "CLAUDE.md"
+  ],
+  "gitignoreEntries": [
+    ".gos-local/", ".temp/", ".backups/",
+    "packages/*/figma-make/", "packages/*/node_modules/",
+    ".env", ".env.local", ".env.*.local"
+  ]
+}
+```
+
+Validar: `node -e "require('./manifests/gos-install-manifest.json')"`
+
+Sem dependencias. DoD: JSON valido, paths conferem com estrutura real.
+
+---
+
+## T-003 — Atualizar package.json
+
+P0 | 1 pt | backend | `package.json` (EDITAR)
+
+Remover `"private": true`, adicionar `bin` entry, scripts `gos:*`, e metadata publica.
+
+1. Remover `"private": true`
+2. Alterar version para `"0.2.0"`
+3. Adicionar `"bin": { "gos": "scripts/cli/gos-cli.js" }`
+4. Substituir scripts:
+   ```json
+   {
+     "gos:init": "node scripts/cli/gos-cli.js init",
+     "gos:update": "node scripts/cli/gos-cli.js update",
+     "gos:doctor": "node scripts/cli/gos-cli.js doctor",
+     "gos:version": "node scripts/cli/gos-cli.js version",
+     "clickup": "node scripts/tools/clickup.js",
+     "sync:ides": "node scripts/integrations/setup-ide-adapters.js",
+     "check:ides": "node scripts/integrations/check-ide-compat.js",
+     "doctor": "node scripts/cli/gos-cli.js doctor"
+   }
+   ```
+5. Adicionar: `"repository"`, `"license": "MIT"`, `"author": "Douglas Oliveira"`
+
+Depende de T-001. DoD: JSON valido, scripts rodam, `private` removido.
+
+---
+
+## T-004 — LICENSE
+
+P1 | 1 pt | general | `LICENSE` (NOVO)
+
+Criar arquivo MIT License com copyright Douglas Oliveira 2026. Conteudo padrao MIT.
+
+Sem dependencias. DoD: Arquivo na raiz, GitHub detecta como MIT.
+
+---
+
+## T-005 — README.md publico
+
+P1 | 3 pts | general | `README.md` (REESCREVER)
+
+Reescrever para audiencia publica — primeira impressao do repositorio.
+
+**Secoes obrigatorias:**
+1. Header com tagline + badges (MIT, Node >= 18)
+2. O que e o G-OS (2 paragrafos)
+3. Quick Start (3 comandos: clone, cd, init)
+4. Modulos incluidos — tabela dos 7 agents, 13 skills, 3 squads (de `g-os-runtime-manifest.json`)
+5. Atualizando (`npm run gos:update`)
+6. IDEs suportadas (Claude Code, Codex, Gemini, OpenCode, Antigravity, Cursor, KiloCode)
+7. Estrutura do workspace (arvore de diretorios)
+8. Scripts disponiveis (tabela)
+9. Licenca MIT
+
+Acentos pt-BR corretos. Zero conteudo privado.
+
+Depende de T-001. DoD: README completo, renderiza no GitHub, nenhum dado privado.
+
+---
+
+## T-006 — .gitignore
+
+P1 | 1 pt | general | `.gitignore` (EDITAR)
+
+Adicionar ao final:
+```
+# G-OS local (nao versionado)
+.gos-local/
+
+# Conteudo de usuario
+packages/*/node_modules/
+packages/*/figma-make/
+```
+
+Verificar que `.env` e `.env.local` ja estao listados.
+
+Sem dependencias. DoD: entradas adicionadas, `git status` nao mostra `.gos-local/`.
+
+---
+
+## T-007 — Workflow PR Check
+
+P2 | 2 pts | devops | `.github/workflows/pr-check.yml` (NOVO)
+
+```yaml
+name: PR Check
+on:
+  pull_request:
+    branches: [beta, main]
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+      - name: Doctor check
+        run: node scripts/cli/gos-cli.js doctor
+      - name: IDE compatibility check
+        run: node scripts/integrations/check-ide-compat.js
+```
+
+Depende de T-001. DoD: YAML valido, roda em PRs.
+
+---
+
+## T-008 — Atualizar dev-to-beta
+
+P2 | 1 pt | devops | `.github/workflows/dev-to-beta.yml` (EDITAR)
+
+Adicionar steps ANTES do "Merge dev into beta":
+```yaml
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+      - name: Doctor check
+        run: node scripts/cli/gos-cli.js doctor
+```
+
+Depende de T-001. DoD: doctor roda antes do merge.
+
+---
+
+## T-009 — Sanitizar repo
+
+P0 | 3 pts | general
+
+Remover conteudo de clientes e dados privados ANTES de tornar publico. Task de seguranca.
+
+**Remover:**
+```bash
+rm -rf packages/fractus/ packages/cursoeduca/ packages/cnpq/ packages/compomente-vue/
+rm -rf supabase/ others/
+rm -f links.txt instrucoes.txt stacks.txt requirements.txt
+```
+
+**Criar:** `packages/.gitkeep` + `packages/README.md` (explicando que projetos ficam ali)
+
+**Auditar segredos:**
+```bash
+grep -rn "CLICKUP_TOKEN\|API_KEY\|SECRET\|PASSWORD\|sk-\|ghp_" . --include="*.js" --include="*.json" --include="*.yaml"
+git ls-files | grep -i env
+```
+
+**Git history:** considerar `git filter-repo` se houver segredos no historico.
+
+Sem dependencias. DoD: zero conteudo privado, zero segredos.
+
+---
+
+## T-010 — Replicar em .G-OS/
+
+P1 | 2 pts | general
+
+Copiar todos os arquivos novos/modificados de `E:\Github\Ganbatte` para `e:\Github\.a8z-framework\.G-OS\`.
+
+```bash
+# Novos
+cp scripts/cli/gos-cli.js           .G-OS/scripts/cli/gos-cli.js
+cp manifests/gos-install-manifest.json .G-OS/manifests/gos-install-manifest.json
+cp LICENSE                           .G-OS/LICENSE
+cp .github/workflows/pr-check.yml   .G-OS/.github/workflows/pr-check.yml
+
+# Modificados
+cp package.json                      .G-OS/package.json
+cp README.md                         .G-OS/README.md
+cp .gitignore                        .G-OS/.gitignore
+cp .github/workflows/dev-to-beta.yml .G-OS/.github/workflows/dev-to-beta.yml
+```
+
+Validar com `diff` entre os dois repos. NAO commitar em `.G-OS/`.
+
+Depende de T-001 a T-009. DoD: diff confirma paridade.
+
+---
+
+## Ordem
+
+```
+Fase 1 (paralelo): T-001, T-002, T-004, T-006, T-009
+Fase 2:            T-003, T-005
+Fase 3:            T-007, T-008
+Fase 4 (final):    T-010
+
+Total: 10 tasks, 25 story points
+```
+
+## Checklist final
+
+```bash
+node scripts/cli/gos-cli.js doctor
+node scripts/cli/gos-cli.js version
+npm run check:ides
+grep -rn "CLICKUP_TOKEN\|API_KEY\|SECRET\|sk-\|ghp_" . --include="*.js" --include="*.json"
+diff -rq . e:/Github/.a8z-framework/.G-OS/ --exclude=node_modules --exclude=.git --exclude=packages
+```

package/docs/stacks/stack-git-operations.md

@@ -0,0 +1,154 @@
+# Stack: Git Operations — SSH Identity + Quality Gate
+
+**Ref:** `docs/plan/plan-git-operations.md`
+**Total:** 9 tasks, 5 waves, ~31 pts
+
+---
+
+## Wave 1 — Fundacao (sem dependencias)
+
+### T-101: Criar skill git-ssh-setup (5 pts)
+
+Criar `skills/git-ssh-setup/SKILL.md` com frontmatter padrao (name, description, use-when, do-not-use-for, metadata category workflow-automation).
+
+Fluxo da skill:
+1. Detectar framework (G-OS via `.gos-local/`, .a8z via `.a8z/`)
+2. Checar se `ssh-identity.json` ja existe
+3. Extrair alias do remote URL (`git remote get-url origin`)
+4. Validar conexao (`ssh -T git@<alias>`)
+5. Perguntar nome/email ao usuario
+6. Gravar `ssh-identity.json` no dir local gitignored
+
+Regras de seguranca embutidas: alias real mascarado como `[configured-ssh-identity]`.
+
+Replicar em: `.G-OS/skills/git-ssh-setup/SKILL.md` e `Ganbatte/skills/git-ssh-setup/SKILL.md`.
+
+**Aceite:** Arquivo existe nos 3 repos. Frontmatter valido. Grep por alias reais retorna zero.
+
+---
+
+### T-102: Criar playbook ssh-multi-account-setup (3 pts)
+
+Criar `playbooks/ssh-multi-account-setup.md` baseado no GUIA-SSH-MULTIPLAS-CONTAS.md, genericizado com `<placeholder>` ao inves de nomes reais.
+
+6 fases: Key Generation → SSH Config → GitHub Registration → URL Rewrite → Validation → Workspace Config.
+
+Replicar em: `.G-OS/playbooks/` e `Ganbatte/playbooks/`.
+
+**Aceite:** Arquivo existe. Grep por `imdouglas|gabriel|fappssh|moradigna|adriano` retorna zero.
+
+---
+
+### T-103: Criar script pre-commit-validate.js (5 pts)
+
+Criar `scripts/hooks/pre-commit-validate.js` — Node.js zero-dependency.
+
+Funcionalidades:
+- Detectar package manager via lockfiles
+- Se `tsconfig.json` existe: rodar `npx tsc --noEmit`
+- Se package.json tem script test/test:e2e/test:run: rodar testes (com `--run` para vitest)
+- Output JSON: `{ passed, checks: [{name, status, output, duration}], timestamp }`
+- Flags: `--json`, `--skip-tests`, `--skip-tsc`
+- Usar `execFileSync` (sem shell injection)
+- Exit 0 se OK, exit 1 se falha
+
+Replicar em: `.G-OS/scripts/hooks/` e `Ganbatte/scripts/hooks/`.
+
+**Aceite:** `node scripts/hooks/pre-commit-validate.js --json` retorna JSON valido. Exit code correto.
+
+---
+
+## Wave 2 — Integracao (depende de Wave 1)
+
+### T-104: Aprimorar skill git-commit (5 pts)
+
+Editar `skills/git-commit/SKILL.md`:
+
+1. Corrigir linha com alias hardcoded → referenciar `ssh-identity.json`
+2. Adicionar secao "Pre-Commit Quality Gate" antes do workflow automatico
+3. Adicionar secao "SSH Identity Validation (Pre-Push)" apos workflow
+4. Adicionar regra PROIBIDO: expor alias SSH
+5. Atualizar checklist com "tsc passa?" e "testes passam?"
+6. Atualizar workflow automatico com passo 0 (quality gate) e passo 5 (SSH validation)
+
+**Aceite:** Skill menciona pre-commit-validate.js. Grep por `github-imdouglas` retorna zero.
+
+---
+
+### T-105: Aprimorar agent devops (2 pts)
+
+.a8z-OS (`agents/profiles/devops.md`):
+- Adicionar core_principle: SSH Identity Protection
+- Adicionar comandos: ssh-setup, pre-commit-validate
+- Adicionar skill dependency: git-ssh-setup
+
+G-OS (`.G-OS/agents/profiles/devops.md`):
+- Expandir com linhas sobre SSH e quality gate
+
+Replicar G-OS em Ganbatte.
+
+**Aceite:** devops agent lista ssh-setup como comando.
+
+---
+
+## Wave 3 — Squad (depende de Wave 1+2)
+
+### T-106: Criar squad git-operations (5 pts)
+
+Criar em `squads/git-operations/`:
+- `squad.yaml` — agents devops+dev, routing matrix com 4 categorias
+- `workflows/wf-ssh-setup.yaml` — 5 fases (detect → key-check → configure → validate → identity)
+- `workflows/wf-safe-commit.yaml` — 5 fases (validate → pre-check → stage → commit → safe-push)
+- `README.md` — documentacao da squad
+
+Replicar em `.G-OS/squads/git-operations/` e `Ganbatte/squads/git-operations/`.
+
+**Aceite:** Arquivos existem nos 3 repos. YAML valido.
+
+---
+
+## Wave 4 — Registros (depende de todas)
+
+### T-107: Atualizar registries (2 pts)
+
+- `.a8z-framework/skills/registry.json`: adicionar entrada git-ssh-setup
+- `.G-OS/skills/registry.json`: adicionar entrada
+- `Ganbatte/skills/registry.json`: adicionar entrada
+- Rodar `npm run sync:skills-registry` se disponivel
+
+**Aceite:** `jq '.skills[] | select(.slug=="git-ssh-setup")' skills/registry.json` retorna resultado.
+
+---
+
+### T-108: Atualizar manifestos (2 pts)
+
+- `manifests/dev-runtime-manifest.json`: adicionar copyMap git-ssh-setup
+- `.G-OS/manifests/g-os-runtime-manifest.json`: adicionar skill git-ssh-setup e squad git-operations
+- `.G-OS/manifests/gos-install-manifest.json`: ja coberto por `skills/` e `scripts/` no frameworkManaged
+
+Replicar G-OS manifestos em Ganbatte.
+
+**Aceite:** `npm run doctor` passa.
+
+---
+
+## Wave 5 — Documentacao
+
+### T-109: Criar plano e stack (2 pts)
+
+- Criar `docs/plan/plan-git-operations.md` com visao geral
+- Criar `docs/stacks/stack-git-operations.md` com todas as tasks
+
+Replicar em `.G-OS/docs/` e `Ganbatte/docs/`.
+
+**Aceite:** Arquivos existem nos 3 repos.
+
+---
+
+## Verificacao Final
+
+1. `grep -rn "imdouglas\|gabriel\|fappssh\|moradigna\|adriano" skills/git-ssh-setup/ playbooks/ssh-multi-account-setup.md squads/git-operations/` — zero matches
+2. `npm run doctor` passa
+3. `.gos-local/` e `.a8z/local/` estao no .gitignore
+4. `node scripts/hooks/pre-commit-validate.js --json` retorna JSON valido
+5. Diff entre `.G-OS/` e Ganbatte confirma paridade

package/docs/toolchain-map.md

@@ -0,0 +1,18 @@
+# Toolchain Map
+
+## Entradas suportadas
+
+- URL ou frame do Figma
+- export do Figma Make
+- codigo gerado pelo Google Stitch
+- screenshot de UI
+
+## Decisao rapida
+
+- Figma com acesso estruturado: `figma-implement-design`
+- Screenshot ou referencia visual: `design-to-code`
+- Figma Make bruto: `figma-make-analyzer` -> `make-code-triage` -> `component-dedup`
+- diff entre export antigo e novo do Make: `make-version-diff`
+- Stitch ou codigo gerado por IA: `make-code-triage` -> `frontend-dev` -> `react-doctor`
+- Descoberta e backlog: `sprint-planner`
+- Subida para ClickUp: `clickup`

package/integrations/README.md

@@ -0,0 +1,42 @@
+# Integrations Layer (Multi-IDE / Multi-LLM)
+
+Este diretório define como o core do G-OS (na raiz) é exposto para cada IDE.
+
+## Princípio
+
+- **Core compartilhado**: permanece na raiz (`agents/`, `rules/`, `skills/`, `playbooks/`, `prompts/`, etc.).
+- **Integrações de IDE**: ficam em `integrations/<ide>/` e descrevem aliases/adapters.
+- **Workspace local da IDE** (ex.: `.claude/`): deve ser fino, contendo apenas configuração local e ponte para o core.
+
+## Estrutura
+
+```text
+integrations/
+├── registry.json               # Registro global de integrações e comandos canônicos
+├── claude/
+│   ├── README.md               # Regras do adapter Claude
+│   └── command-map.json        # Mapeamento comando-IDE -> artefato core
+├── codex/
+├── opencode/
+└── antigravity/
+```
+
+## Comandos canônicos
+
+G-OS usa IDs neutros para comandos compartilhados (ex.: `gos.search`, `gos.spec`, `gos.tasks`, `gos.code`, `gos.review`).
+
+Cada IDE mapeia esses IDs para sua forma nativa (slash command, menu, atalho, workflow).
+
+## Perfis de agentes
+
+- Fonte canônica: `agents/profiles/`
+- Adapter Claude: `.claude/commands/gos/agents/`
+- Sincronização: `npm run sync:ides`
+
+## Validacao do catalogo de integracoes
+
+Use o gate local antes de alterar qualquer `command-map` ou `registry`:
+
+```bash
+npm run check:integrations
+```

package/integrations/antigravity/README.md

@@ -0,0 +1,29 @@
+# Antigravity Adapter
+
+Adapter para ambiente Antigravity.
+
+## Status: Ativo
+
+## Como funciona
+
+Antigravity le o diretorio `.antigravity/` na raiz do projeto.
+O script `sync-antigravity-instructions.js` gera `instructions.md` e `config.json` a partir das fontes canonicas do framework.
+
+## Sync
+
+```bash
+npm run sync:antigravity          # Gera/atualiza .antigravity/
+npm run check:antigravity         # Verifica se esta em sincronia
+```
+
+## Fontes
+
+- `agents/profiles/index.json` — perfis de agentes
+- `skills/registry.json` — skills registradas
+- `rules/*.md` — regras de governanca
+- `playbooks/*.md` — playbooks operacionais
+
+## Referencia
+
+- Command map: `integrations/antigravity/command-map.json`
+- Sync script: `scripts/integrations/sync-antigravity-instructions.js`

package/integrations/antigravity/command-map.json

@@ -0,0 +1,29 @@
+{
+  "ide": "antigravity",
+  "version": "1.0.0",
+  "status": "active",
+  "mappings": [
+    {
+      "canonicalCommand": "gos.search",
+      "coreArtifact": "prompts/01-search.md"
+    },
+    {
+      "canonicalCommand": "gos.spec",
+      "coreArtifact": "prompts/02-spec.md"
+    },
+    {
+      "canonicalCommand": "gos.tasks",
+      "coreArtifact": "prompts/03-tasks.md"
+    },
+    {
+      "canonicalCommand": "gos.code",
+      "coreArtifact": "prompts/04-code.md"
+    },
+    {
+      "canonicalCommand": "gos.review",
+      "coreArtifact": "prompts/05-reviews.md"
+    }
+  ]
+}
+
+