ganbatte-os 0.2.10 → 0.2.12

package/.gos/scripts/cli/gos-cli.js

@@ -222,6 +222,14 @@ function cmdInit(root, args) {
     warn('setup-ide-adapters.js nao encontrado. Pulando sync de IDEs.');
   }
 
+  // 6b. Sync adapters no framework pai (a8z-framework)
+  const parentSyncScript = path.join(root, '..', 'scripts', 'integrations', 'sync-gos-adapters.js');
+  if (pathExists(parentSyncScript)) {
+    log('Sincronizando adapters no framework pai...');
+    runNode(parentSyncScript, { cwd: path.join(root, '..') });
+    ok('Adapters sincronizados no framework pai.');
+  }
+
   // 7. Validar IDEs
   const ideCheckScript = path.join(root, 'scripts', 'integrations', 'check-ide-compat.js');
   if (pathExists(ideCheckScript)) {
@@ -427,6 +435,14 @@ function cmdUpdate(root, args) {
     ok('IDE adapters atualizados.');
   }
 
+  // 6b. Re-sync adapters no framework pai (a8z-framework)
+  const parentSyncScript = path.join(root, '..', 'scripts', 'integrations', 'sync-gos-adapters.js');
+  if (pathExists(parentSyncScript)) {
+    log('Re-sincronizando adapters no framework pai...');
+    runNode(parentSyncScript, { cwd: path.join(root, '..'), quiet: true });
+    ok('Adapters atualizados no framework pai.');
+  }
+
   // 7. Validar IDEs
   const ideCheckScript = path.join(root, 'scripts', 'integrations', 'check-ide-compat.js');
   if (pathExists(ideCheckScript)) {

package/AGENTS.md

@@ -4,32 +4,39 @@
 
 Este repo existe para acelerar design-to-code e entrega de sprint.
 
-## Agentes principais
-
-- `ganbatte-os-master`: orquestrador master — roteia para o skill/agent/squad certo conforme a complexidade
-- `ux-design-expert`: leitura de design, tokens, componentes e handoff
-- `architect`: define stack e cortes de integração para React/Next.js
-- `dev`: implementa componentes, páginas, hooks e refinamentos
-- `sm`: transforma inputs em sprint executável
-- `po`: organiza backlog, scope e prioridades
-- `devops`: integra GitHub, branches e automações de entrega
-- `squad-creator`: monta ou ajusta squads especializados
-
-## Skills principais
-
-- `design-to-code`
-- `figma-implement-design`
-- `figma-make-analyzer`
-- `make-code-triage`
-- `component-dedup`
-- `frontend-dev`
-- `react-doctor`
-- `sprint-planner`
-- `clickup`
-
-## Runtime
-
-As skills usam suporte interno em `.G-OS/` para regras, templates e bibliotecas.
+## Agentes
+
+| ID | Slash Command | Foco |
+|----|--------------|------|
+| **gos-master** | `/gos:agents:gos-master` | Orquestrador master — routing, skills, squads, workflows |
+| **architect** | `/gos:agents:architect` | Stack, padroes tecnicos, revisoes de arquitetura |
+| **dev** | `/gos:agents:dev` | Implementacao de features, hooks, refinamentos |
+| **devops** | `/gos:agents:devops` | Git, branches, CI/CD, automacoes de entrega |
+| **po** | `/gos:agents:po` | Backlog, scope, priorizacao |
+| **qa** | `/gos:agents:qa` | Testes, quality gates, revisao de codigo |
+| **sm** | `/gos:agents:sm` | Sprint, planning, sync com stakeholders |
+| **squad-creator** | `/gos:agents:squad-creator` | Orquestracao de times multi-agentes |
+| **ux-design-expert** | `/gos:agents:ux-design-expert` | Design de interfaces, tokens, design systems |
+
+## Skills
+
+| Skill | Slash Command | Funcao |
+|-------|--------------|--------|
+| **design-to-code** | `/gos:skills:design-to-code` | Converte Figma/screenshot em componentes React |
+| **figma-implement-design** | `/gos:skills:figma-implement-design` | Implementa design Figma com fidelidade 1:1 |
+| **figma-make-analyzer** | `/gos:skills:figma-make-analyzer` | Analisa output do Figma Make |
+| **make-code-triage** | `/gos:skills:make-code-triage` | Classifica codigo do Figma Make por categoria |
+| **make-version-diff** | `/gos:skills:make-version-diff` | Compara versoes de output Figma Make |
+| **component-dedup** | `/gos:skills:component-dedup` | Detecta componentes duplicados |
+| **frontend-dev** | `/gos:skills:frontend-dev` | Build componentes, pages, hooks (React/Next.js) |
+| **interface-design** | `/gos:skills:interface-design` | Design de interface com metodologia intent-first |
+| **react-best-practices** | `/gos:skills:react-best-practices` | Otimizacao de performance React/Next.js |
+| **react-doctor** | `/gos:skills:react-doctor` | Diagnostico de saude de componentes React |
+| **sprint-planner** | `/gos:skills:sprint-planner` | Planejamento completo de sprint |
+| **clickup** | `/gos:skills:clickup` | Gestao de tarefas e sprints no ClickUp |
+| **plan-to-tasks** | `/gos:skills:plan-to-tasks` | Converte plano em tasks acionaveis |
+| **agent-teams** | `/gos:skills:agent-teams` | Coordena multiplos agentes em time |
+| **git-ssh-setup** | `/gos:skills:git-ssh-setup` | Configura identidade SSH para o workspace |
 
 ## Plan Mode Protocol
 
@@ -39,8 +46,8 @@ Antes de executar qualquer tarefa complexa, SEMPRE entre em plan mode.
 
 **Protocolo:**
 1. **RESEARCH** — leia arquivos relevantes sem alterar nada
-2. **PLAN** — crie `implementation_plan.md` com `[NEW]`/`[MODIFY]`/`[DELETE]`, perguntas abertas, plano de verificação. Apresente e aguarde aprovação na resposta principal, sem bloquear via hook
-3. **AWAIT** — aguarde aprovação: "ok", "aprovado", "go", "execute", "pode ir"
+2. **PLAN** — crie `implementation_plan.md` com `[NEW]`/`[MODIFY]`/`[DELETE]`, perguntas abertas, plano de verificacao. Apresente e aguarde aprovacao na resposta principal, sem bloquear via hook
+3. **AWAIT** — aguarde aprovacao: "ok", "aprovado", "go", "execute", "pode ir"
 4. **EXECUTE + TRACK** — crie `task.md`, execute, finalize com `walkthrough.md`
 
-**Exceções — NÃO ativar:** git operations, leitura/explicação, edições simples de 1 arquivo, lint/typo, "execute direto", "sem plano", comandos de retomada como `continue`/`continuar`/`resume`, aprovações como `ok`/`aprovado`/`pode ir`, quando já aprovado na sessão.
+**Excecoes — NAO ativar:** git operations, leitura/explicacao, edicoes simples de 1 arquivo, lint/typo, "execute direto", "sem plano", comandos de retomada como `continue`/`continuar`/`resume`, aprovacoes como `ok`/`aprovado`/`pode ir`, quando ja aprovado na sessao.

package/CLAUDE.md

@@ -9,23 +9,43 @@ ganbatte-os e uma distribuicao enxuta do framework operacional ganbatte-os para:
 
 Priorize React e Next.js. Quando houver input vindo de Figma Make ou Stitch, trate o codigo como material de triagem antes de integrar ao projeto final.
 
-## Orquestração
+## Orquestracao
 
-O ganbatte-os herda o modelo de orquestração do .a8z-OS (framework pai):
+O ganbatte-os herda o modelo de orquestracao do .a8z-OS (framework pai):
 
-| Tier | Componente | Função |
+| Tier | Componente | Funcao |
 |------|-----------|--------|
 | 1 | `ganbatte-os-master` | Orquestrador master — routing matrix, skills, squads, workflows |
 | 2 | `workflow-select` | Scoring de workflows (Ralph, SDD, Rapid Bug Fix, Escalation) |
-| 2 | `composer` | Sequências de skills com decision gates |
+| 2 | `composer` | Sequencias de skills com decision gates |
 | 2 | `model-router` | Roteamento para modelo mais barato adequado |
-| 3 | `agent-teams` / `dispatching-parallel-agents` | Paralelização multi-agente |
+| 3 | `agent-teams` / `dispatching-parallel-agents` | Paralelizacao multi-agente |
 
-Para tarefas complexas multi-domínio, invocar `ganbatte-os-master` (agents/profiles/gos-master.md).
+Para tarefas complexas multi-dominio, invocar `ganbatte-os-master` (agents/profiles/gos-master.md).
 
 ## Qualidade de Texto
 
-Todo texto gerado deve passar por correção ortográfica e remoção de padrões de IA:
-- **Ortografia pt-BR**: Stop hook automático corrige acentos
-- **Humanização**: Skill `/humanizer` remove padrões de escrita artificial (26 patterns)
-- **Referência**: `libraries/content/ai-writing-patterns.md` (taxonomia de padrões)
+Todo texto gerado deve passar por correcao ortografica e remocao de padroes de IA:
+- **Ortografia pt-BR**: Stop hook automatico corrige acentos
+- **Humanizacao**: Skill `/humanizer` remove padroes de escrita artificial (26 patterns)
+- **Referencia**: `libraries/content/ai-writing-patterns.md` (taxonomia de padroes)
+
+## Comandos do Workspace
+
+| Comando | O que faz |
+|---------|-----------|
+| `npm run gos:init` | Setup pos-clone |
+| `npm run gos:update` | Atualiza framework + re-sync IDEs |
+| `npm run gos:doctor` | Health-check do workspace |
+| `npm run gos:version` | Versao e atualizacoes |
+| `npm run sync:ides` | Regenera IDE adapters |
+| `npm run check:ides` | Valida IDE adapters |
+| `npm run clickup` | CLI ClickUp |
+
+## Slash Commands
+
+### Agents (invoke via /gos:agents:{id})
+gos-master | architect | dev | devops | po | qa | sm | squad-creator | ux-design-expert
+
+### Skills (invoke via /gos:skills:{slug})
+design-to-code | figma-implement-design | figma-make-analyzer | make-code-triage | make-version-diff | component-dedup | frontend-dev | interface-design | react-best-practices | react-doctor | sprint-planner | clickup | plan-to-tasks | agent-teams | git-ssh-setup

package/README.md

@@ -31,11 +31,29 @@ Após rodar o install, o framework criará uma estrutura limpa na sua raiz:
 - `packages/` — Onde você deve colocar o código do seu aplicativo.
 
 ### 3. Comandos do Workspace
+
 A partir da raiz do seu projeto, você pode gerenciar o framework:
 
-- `npm run gos:doctor` — Valida se o framework está íntegro e as IDEs configuradas.
-- `npm run gos:update` — Sincroniza seu workspace com as últimas melhorias da Ganbatte.
-- `npm run sync:ides` — Regenera os adapters para Claude, Gemini, Cursor e outras.
+| Comando | Alias | O que faz |
+|---------|-------|-----------|
+| `npm run gos:init` | `npm run ganbatte-os:init` | Setup pos-clone (remote, dirs, IDEs, sync framework pai) |
+| `npm run gos:update` | `npm run ganbatte-os:update` | Fetch upstream + merge + re-sync IDEs + sync framework pai |
+| `npm run gos:doctor` | `npm run ganbatte-os:doctor` | Valida integridade do workspace e IDEs |
+| `npm run gos:version` | `npm run ganbatte-os:version` | Mostra versao e checa atualizacoes |
+| `npm run sync:ides` | — | Regenera adapters para Claude, Gemini, Cursor e outras |
+| `npm run check:ides` | — | Valida compatibilidade dos IDE adapters |
+| `npm run clickup` | — | CLI ClickUp (tarefas, sprints, status) |
+| `npm run doctor` | — | Alias direto para gos:doctor |
+
+### Via npx (instalacao/atualizacao)
+
+| Comando | O que faz |
+|---------|-----------|
+| `npx ganbatte-os install` | Instala framework em diretorio novo |
+| `npx ganbatte-os init` | Inicializa workspace existente |
+| `npx ganbatte-os update` | Atualiza framework |
+| `npx ganbatte-os doctor` | Health-check |
+| `npx ganbatte-os version` | Versao instalada |
 
 ## Estrutura do Workspace
 
@@ -63,13 +81,50 @@ O `ganbatte-os` utiliza uma estrutura **encapsulada** para manter seu projeto li
 
 ## Agentes Disponíveis
 
-| Nome | Foco |
-|------|------|
-| **ux-design-expert** | Design de interfaces, tokens e design systems. |
-| **architect** | Definição de stack, padrões técnicos e revisões de código. |
-| **dev** | Implementação de features, hooks e refinamentos visuais. |
-| **sm / po** | Gestão de sprint, priorização de backlog e sync com stakeholders. |
-| **squad-creator** | Orquestração de times multi-agentes para tarefas complexas. |
+| Agent | Slash Command | Foco |
+|-------|--------------|------|
+| **gos-master** | `/gos:agents:gos-master` | Orquestrador master — routing, skills, squads, workflows |
+| **architect** | `/gos:agents:architect` | Stack, padroes tecnicos, revisoes de arquitetura |
+| **dev** | `/gos:agents:dev` | Implementacao de features, hooks, refinamentos |
+| **devops** | `/gos:agents:devops` | Git, branches, CI/CD, automacoes de entrega |
+| **po** | `/gos:agents:po` | Backlog, scope, priorizacao |
+| **qa** | `/gos:agents:qa` | Testes, quality gates, revisao de codigo |
+| **sm** | `/gos:agents:sm` | Sprint, planning, sync com stakeholders |
+| **squad-creator** | `/gos:agents:squad-creator` | Orquestracao de times multi-agentes |
+| **ux-design-expert** | `/gos:agents:ux-design-expert` | Design de interfaces, tokens, design systems |
+
+## Skills Disponiveis
+
+| Skill | Slash Command | Funcao |
+|-------|--------------|--------|
+| **design-to-code** | `/gos:skills:design-to-code` | Converte Figma/screenshot em componentes React |
+| **figma-implement-design** | `/gos:skills:figma-implement-design` | Implementa design Figma com fidelidade 1:1 |
+| **figma-make-analyzer** | `/gos:skills:figma-make-analyzer` | Analisa output do Figma Make |
+| **make-code-triage** | `/gos:skills:make-code-triage` | Classifica codigo do Figma Make por categoria |
+| **make-version-diff** | `/gos:skills:make-version-diff` | Compara versoes de output Figma Make |
+| **component-dedup** | `/gos:skills:component-dedup` | Detecta componentes duplicados |
+| **frontend-dev** | `/gos:skills:frontend-dev` | Build componentes, pages, hooks (React/Next.js) |
+| **interface-design** | `/gos:skills:interface-design` | Design de interface com metodologia intent-first |
+| **react-best-practices** | `/gos:skills:react-best-practices` | Otimizacao de performance React/Next.js |
+| **react-doctor** | `/gos:skills:react-doctor` | Diagnostico de saude de componentes React |
+| **sprint-planner** | `/gos:skills:sprint-planner` | Planejamento completo de sprint |
+| **clickup** | `/gos:skills:clickup` | Gestao de tarefas e sprints no ClickUp |
+| **plan-to-tasks** | `/gos:skills:plan-to-tasks` | Converte plano em tasks acionaveis |
+| **agent-teams** | `/gos:skills:agent-teams` | Coordena multiplos agentes em time |
+| **git-ssh-setup** | `/gos:skills:git-ssh-setup` | Configura identidade SSH para o workspace |
+
+## Documentacao
+
+| Documento | Descricao |
+|-----------|-----------|
+| [AGENTS.md](./AGENTS.md) | Agentes, skills e slash commands disponiveis |
+| [CLAUDE.md](./CLAUDE.md) | Instrucoes para Claude Code |
+| [GEMINI.md](./GEMINI.md) | Instrucoes para Google Gemini |
+| [docs/README.md](./docs/README.md) | Indice de documentacao |
+
+**Fonte canonica dos agents**: `.gos/agents/profiles/`
+**Fonte canonica das skills**: `.gos/skills/`
+**Registry de skills**: `.gos/skills/registry.json`
 
 ## Licença
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ganbatte-os",
-  "version": "0.2.10",
+  "version": "0.2.12",
   "description": "Framework operacional para design-to-code, squads de entrega e sprint sync com ClickUp.",
   "bin": {
     "ganbatte-os": ".gos/scripts/cli/gos-cli.js",