ganbatte-os 0.2.1

package/AGENTS.md

@@ -0,0 +1,46 @@
+# ganbatte-os Agents
+
+## Objetivo
+
+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.
+
+## Plan Mode Protocol
+
+Antes de executar qualquer tarefa complexa, SEMPRE entre em plan mode.
+
+**Triggers:** analisar, planejar, criar tasks, arquitetar, refatorar, implementar feature/skill/agente, sprint, backlog, migrar, integrar, redesign — quando envolver >3 passos ou múltiplos arquivos.
+
+**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 **PARE**
+3. **AWAIT** — aguarde aprovação: "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", quando já aprovado na sessão.

package/CLAUDE.md

@@ -0,0 +1,31 @@
+# ganbatte-os Context
+
+ganbatte-os e uma distribuicao enxuta do framework operacional ganbatte-os para:
+
+- converter design em codigo
+- organizar squads de entrega
+- planejar sprint
+- sincronizar backlog no ClickUp
+
+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
+
+O ganbatte-os herda o modelo de orquestração do .a8z-OS (framework pai):
+
+| Tier | Componente | Função |
+|------|-----------|--------|
+| 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 | `model-router` | Roteamento para modelo mais barato adequado |
+| 3 | `agent-teams` / `dispatching-parallel-agents` | Paralelização multi-agente |
+
+Para tarefas complexas multi-domínio, 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)

package/GEMINI.md

@@ -0,0 +1,17 @@
+# ganbatte-os For Gemini CLI
+
+Use este projeto como um kit de design-to-code e sprint ops.
+
+## Prioridades
+
+- Figma, Figma Make e Stitch para React/Next.js
+- planejamento de sprint
+- ClickUp
+- revisao de qualidade antes de entrega
+
+## Fontes principais
+
+- `AGENTS.md`
+- `CLAUDE.md`
+- `docs/toolchain-map.md`
+- `skills/registry.json`

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Douglas Oliveira
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,141 @@
+# ganbatte-os
+# ganbatte-os
+
+Framework operacional para design-to-code, squads de entrega e sprint sync com ClickUp.
+
+---
+
+[![NPM Version](https://img.shields.io/npm/v/ganbatte-os)](https://www.npmjs.com/package/ganbatte-os)
+![Node >= 18](https://img.shields.io/badge/Node.js-%3E%3D18-green)
+
+O ganbatte-os organiza agentes de IA, skills e squads num workspace pronto para uso. Ele conecta Figma, ClickUp e 7 IDEs diferentes para acelerar a entrega de projetos de software. Baseado no framework .a8z-OS.
+
+## Quick Start
+
+### 1. Instalação (Recomendado)
+Para criar um novo workspace ganbatte-os em qualquer diretório:
+
+```bash
+mkdir meu-projeto && cd meu-projeto
+npx ganbatte-os install
+```
+
+Ou via clone tradicional:
+
+```bash
+git clone https://github.com/adrianomorais-ganbatte/ganbatte-os.git .
+node scripts/cli/ganbatte-os-cli.js init
+```
+
+### 2. Comandos Disponíveis
+Apos a instalação, você terá acesso aos comandos via `npm run`:
+
+- `npm run ganbatte-os:doctor` — Validar integridade do workspace
+- `npm run ganbatte-os:update` — Buscar atualizações do framework
+- `npm run ganbatte-os:version` — Mostrar versão instalada
+
+## Funcionalidades
+
+- **Design-to-Code**: Pipeline automatizado para converter frames do Figma em código.
+- **Squads de Entrega**: Agentes pré-configurados para SM, PO, Dev e QA.
+- **Integração ClickUp**: Sincronização automática de tarefas e status.
+- **Suporte Multi-IDE**: Configurações otimizadas para Claude Code, Gemini, Cursor e outras.
+
+## Estrutura do Projeto
+
+```text
+├── agents/          # Perfis e instruções dos agentes
+├── skills/          # Catálogo de funcionalidades reutilizáveis
+├── squads/          # Definições de times de agentes
+├── scripts/         # CLI e utilitários de sistema
+├── manifests/       # Configurações de runtime e instalação
+└── packages/        # Seus projetos e código-fonte
+```
+
+## Contribuição
+
+Este é um projeto interno da **Ganbatte**. Para sugestões ou bugs, abra uma issue no repositório.
+
+---
+© 2026 Ganbatte. Todos os direitos reservados.
+
+## Agentes
+
+| Nome | Foco |
+|------|------|
+| ux-design-expert | Design de interfaces e UX |
+| architect | Arquitetura de software |
+| dev | Desenvolvimento full-stack |
+| sm | Scrum Master e facilitacao |
+| po | Product Owner e priorizacao |
+| devops | Infraestrutura e CI/CD |
+| squad-creator | Montagem de squads |
+
+## Skills
+
+| Nome | Foco |
+|------|------|
+| design-to-code | Figma para codigo React |
+| figma-implement-design | Implementacao de designs Figma |
+| figma-make-analyzer | Analise de output do Figma Make |
+| make-code-triage | Triagem de codigo gerado |
+| make-version-diff | Diff entre versoes de componentes |
+| component-dedup | Deduplicacao de componentes |
+| frontend-dev | Desenvolvimento frontend |
+| react-best-practices | Boas praticas React/Next.js |
+| react-doctor | Diagnostico de problemas React |
+| sprint-planner | Planejamento de sprints |
+| clickup | Integracao ClickUp API |
+| plan-to-tasks | Conversao de planos em tasks |
+| agent-teams | Orquestracao multi-agente |
+
+## Squads
+
+| Nome | Foco |
+|------|------|
+| design-delivery | Entrega de design-to-code |
+| design-squad | Squad de design |
+| sprint-planning | Planejamento e sync de sprints |
+
+## IDEs suportadas
+
+Claude Code, Codex (VS Code), Gemini, OpenCode, Antigravity, Cursor, KiloCode
+
+Cada IDE recebe adapters finos que apontam para os arquivos canonicos em `agents/` e `skills/`.
+
+## Estrutura
+
+```
+g-os/
+  agents/profiles/     Perfis de agentes IA
+  skills/              Skills plugaveis (cada uma com SKILL.md)
+  squads/              Definicoes de squads e workflows
+  scripts/
+    cli/               CLI gos-cli.js
+    tools/             Ferramentas (clickup.js, etc)
+    integrations/      Sync e validacao de IDEs
+  manifests/           Manifestos de runtime e instalacao
+  packages/            Seus projetos aqui
+  docs/                Documentacao
+  integrations/        Command maps por IDE
+  templates/           Templates reutilizaveis
+  prompts/             Prompts canonicos
+```
+
+## Scripts
+
+| Script | O que faz |
+|--------|-----------|
+| `npx g-os install` | Instalação via NPX no diretório atual |
+| `npm run gos:init` | Setup pos-clone |
+| `npm run gos:update` | Atualizar do upstream |
+| `npm run gos:doctor` | Validar integridade |
+| `npm run gos:version` | Ver versao e checar updates |
+| `npm run clickup` | CLI ClickUp API |
+| `npm run sync:ides` | Sincronizar IDE adapters |
+| `npm run check:ides` | Validar IDE adapters |
+| `npm run doctor` | Validacao completa |
+
+## Licenca
+
+[MIT](LICENSE)

package/agents/profiles/architect.md

@@ -0,0 +1,13 @@
+# architect
+
+Use para:
+
+- decidir stack React ou Next.js
+- definir limites entre page, component, hook, service e API
+- orientar importacao de codigo vindo de Figma Make ou Stitch
+
+Checklist:
+
+- evitar UI misturada com data fetching
+- preferir componentes reutilizaveis e tokens semanticos
+- deixar caminho claro para sprint planning e implementacao

package/agents/profiles/dev.md

@@ -0,0 +1,13 @@
+# dev
+
+Use para:
+
+- implementar componentes, paginas e hooks
+- refatorar output gerado por Figma Make ou Stitch
+- conectar a implementacao ao design system e ao stack do projeto
+
+Padrao:
+
+1. ler skill e referencias `.G-OS/`
+2. implementar o menor corte funcional
+3. validar com `react-doctor` quando houver React

package/agents/profiles/devops.md

@@ -0,0 +1,12 @@
+# devops
+
+Use para:
+
+- configurar GitHub, branches e workflows
+- manter `main`, `beta` e `dev`
+- operar publicacao, merge automatizado e integracao de repositorio
+- configurar identidade SSH do workspace via skill git-ssh-setup
+- validar que remote URLs usam o alias SSH correto antes de push
+- rodar quality gate pre-commit (tsc --noEmit + testes) via pre-commit-validate.js
+
+Regra: o valor real do alias SSH nao pode aparecer em output ou documentacao. Usar `[configured-ssh-identity]` como placeholder.