ganbatte-os

Framework operacional para design-to-code, squads de entrega e sprint sync com ClickUp.

O ganbatte-os organiza agentes de IA, skills e squads num workspace pronto para uso. Ele orquestra o ciclo completo de desenvolvimento conectando Figma, ClickUp e as principais IDEs de IA (Claude Code, Gemini, Cursor, etc). Baseado nos padrões do framework .a8z-OS.

Quick Start

1. Instalação (Recomendado)

Para transformar qualquer diretório em um workspace ganbatte-os:

mkdir meu-projeto && cd meu-projeto
npx ganbatte-os install

[!TIP] Durante o desenvolvimento ou para usar a versão mais recente, você pode instalar diretamente do GitHub: npx adrianomorais-ganbatte/g-os#main install

2. Pós-Instalação

Após rodar o install, o framework criará uma estrutura limpa na sua raiz:

• .gos/ — O núcleo do framework (Agentes, Skills, Scripts).
• AGENTS.md, CLAUDE.md, GEMINI.md — Instruções para as IDEs.
• 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:

| 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

O ganbatte-os utiliza uma estrutura encapsulada para manter seu projeto limpo e organizado:

├── .gos/                # Core do Framework (Somente leitura para usuários)
│   ├── agents/          # Perfis e instruções dos agentes IA
│   ├── skills/          # Catálogo de ferramentas (ex: design-to-code)
│   ├── scripts/         # Engine do CLI e integração de IDEs
│   └── prompts/         # Prompts canônicos para os agentes
├── .gos-local/          # Dados locais (logs, queues, worktrees) - ignorado no git
├── packages/            # Seu código-fonte e projetos vivem aqui
├── AGENTS.md            # Entrypoint de agentes para o framework
├── CLAUDE.md            # Instruções específicas para Claude Code
└── GEMINI.md            # Instruções específicas para Google Gemini

Funcionalidades Principais

• Design-to-Code: Pipeline automatizado para converter frames do Figma em componentes React/Next.js de alta fidelidade.
• Squads de Entrega: Agentes especializados (SM, PO, Dev, QA) que trabalham de forma coordenada.
• Sincronização ClickUp: Conecta seu workspace diretamente ao ClickUp para automação de status e tarefas.
• Multi-IDE Multi-Tenant: Configurações automáticas para as melhores ferramentas de IA do mercado.

Agentes Disponíveis

| 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 | Agentes, skills e slash commands disponiveis | | CLAUDE.md | Instrucoes para Claude Code | | GEMINI.md | Instrucoes para Google Gemini | | 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

Este é um projeto interno da Ganbatte. Distribuído sob licença MIT.

© 2026 Ganbatte. Todos os direitos reservados.