ganbatte-os 0.2.38 → 0.2.42

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (82) hide show
  1. package/.gos/README.md +2 -6
  2. package/.gos/agents/profiles/ganbatte-os-master.md +91 -58
  3. package/.gos/agents/profiles/index.json +3 -1
  4. package/.gos/agents/profiles/perf-optimizer.md +10 -0
  5. package/.gos/agents/profiles/po.md +1 -1
  6. package/.gos/agents/profiles/security-auditor.md +11 -0
  7. package/.gos/agents/profiles/sm.md +4 -4
  8. package/.gos/agents/profiles/squad-creator.md +2 -2
  9. package/.gos/config.json +23 -2
  10. package/.gos/docs/curation.md +8 -6
  11. package/.gos/docs/gos_installation_guide.md +1 -1
  12. package/.gos/docs/plan-distribuicao-publica.md +2 -3
  13. package/.gos/docs/toolchain-map.md +2 -2
  14. package/.gos/libraries/component-reuse-gate.md +75 -0
  15. package/.gos/libraries/doc-sync-policy.md +31 -0
  16. package/.gos/libraries/lazy-dev-policy.md +38 -0
  17. package/.gos/libraries/lucide-icons-policy.md +1 -1
  18. package/.gos/libraries/performance-audit-playbook.md +54 -0
  19. package/.gos/libraries/security-audit-playbook.md +63 -0
  20. package/.gos/manifests/g-os-runtime-manifest.json +29 -8
  21. package/.gos/playbooks/audit-streaming-playbook.md +86 -0
  22. package/.gos/playbooks/plan-creation-playbook.md +3 -5
  23. package/.gos/prompts/01-search.md +2 -2
  24. package/.gos/prompts/03-tasks.md +4 -4
  25. package/.gos/prompts/05-reviews.md +1 -1
  26. package/.gos/scripts/cli/gos-cli.js +16 -0
  27. package/.gos/scripts/hooks/claude-stop-summary.js +0 -16
  28. package/.gos/scripts/integrations/check-plan.js +15 -5
  29. package/.gos/scripts/integrations/setup-ide-adapters.js +72 -75
  30. package/.gos/scripts/tools/model-router.js +122 -0
  31. package/.gos/skills/audit-screenshots/SKILL.md +195 -155
  32. package/.gos/skills/execute-plan/SKILL.md +37 -23
  33. package/.gos/skills/figma-print-diff/SKILL.md +5 -0
  34. package/.gos/skills/perf-review/SKILL.md +58 -0
  35. package/.gos/skills/plan-blueprint/SKILL.md +34 -26
  36. package/.gos/skills/plan-to-tasks/SKILL.md +13 -2
  37. package/.gos/skills/progress-tracker/SKILL.md +3 -3
  38. package/.gos/skills/registry.json +3 -4
  39. package/.gos/skills/security-review/SKILL.md +59 -0
  40. package/.gos/skills/simplify-review/SKILL.md +59 -0
  41. package/.gos/skills/validate-plan/SKILL.md +29 -30
  42. package/.gos/squads/code-quality/README.md +20 -0
  43. package/.gos/squads/code-quality/squad.yaml +32 -0
  44. package/.gos/squads/code-quality/workflows/wf-code-quality.yaml +19 -0
  45. package/.gos/squads/design-delivery/README.md +1 -1
  46. package/.gos/squads/design-delivery/squad.yaml +4 -3
  47. package/.gos/squads/design-delivery/workflows/wf-design-delivery.yaml +6 -6
  48. package/.gos/templates/planTemplate.md +35 -5
  49. package/.gos/templates/specTemplate.md +68 -0
  50. package/.gos/templates/taskTemplate.md +37 -10
  51. package/AGENTS.md +0 -2
  52. package/CLAUDE.md +25 -9
  53. package/GEMINI.md +3 -3
  54. package/LICENSE +1 -1
  55. package/README.md +6 -8
  56. package/package.json +2 -3
  57. package/.gos/docs/slack-notifications.md +0 -219
  58. package/.gos/playbooks/sprint-planner-playbook.md +0 -127
  59. package/.gos/scripts/hooks/post-commit-notify.js +0 -175
  60. package/.gos/scripts/tools/clickup-preprocess.js +0 -218
  61. package/.gos/scripts/tools/clickup.js +0 -1058
  62. package/.gos/scripts/tools/slack-notify.js +0 -271
  63. package/.gos/skills/clickup/SKILL.md +0 -151
  64. package/.gos/skills/slack-review/SKILL.md +0 -91
  65. package/.gos/skills/sprint-planner/SKILL.md +0 -434
  66. package/.gos/skills/weekly-update/CHANGELOG.md +0 -165
  67. package/.gos/skills/weekly-update/SKILL.md +0 -361
  68. package/.gos/squads/sprint-planning/agents/sprint-chief.md +0 -47
  69. package/.gos/squads/sprint-planning/agents/sprint-planner-agent.md +0 -43
  70. package/.gos/squads/sprint-planning/agents/sprint-tracker.md +0 -43
  71. package/.gos/squads/sprint-planning/agents/task-importer.md +0 -44
  72. package/.gos/squads/sprint-planning/checklists/sprint-readiness.md +0 -27
  73. package/.gos/squads/sprint-planning/config/config.yaml +0 -65
  74. package/.gos/squads/sprint-planning/data/clickup-field-mapping.yaml +0 -94
  75. package/.gos/squads/sprint-planning/squad.yaml +0 -52
  76. package/.gos/squads/sprint-planning/tasks/close-sprint.md +0 -43
  77. package/.gos/squads/sprint-planning/tasks/create-sprint.md +0 -42
  78. package/.gos/squads/sprint-planning/tasks/import-tasks.md +0 -39
  79. package/.gos/squads/sprint-planning/tasks/sync-status.md +0 -31
  80. package/.gos/squads/sprint-planning/workflows/wf-sprint-creation.yaml +0 -59
  81. package/.gos/squads/sprint-planning/workflows/wf-sprint-sync.yaml +0 -35
  82. package/.gos/templates/sprint-clickup.template.md +0 -80
@@ -1,7 +1,7 @@
1
1
  name: design-delivery
2
2
  version: "1.0.0"
3
3
  short-title: "Design Delivery Squad"
4
- description: "Converte design e output de ferramentas generativas em codigo pronto para sprint e sincronizacao com ClickUp."
4
+ description: "Converte design e output de ferramentas generativas em codigo pronto para producao (plano, execucao e validacao)."
5
5
  slashPrefix: "design-delivery"
6
6
 
7
7
  components:
@@ -11,6 +11,7 @@ components:
11
11
  - dev.md
12
12
  - sm.md
13
13
  - po.md
14
+ - qa.md
14
15
  - devops.md
15
16
  workflows:
16
17
  - wf-design-delivery.yaml
@@ -25,6 +26,6 @@ routing_matrix:
25
26
  stitch_code:
26
27
  primary: dev
27
28
  triggers: ["google stitch", "stitch", "codigo gerado pelo stitch"]
28
- sprint_sync:
29
+ plan_pipeline:
29
30
  primary: sm
30
- triggers: ["criar sprint", "subir clickup", "sync clickup"]
31
+ triggers: ["plano de tela", "planejar entrega", "quebrar em tasks"]
@@ -18,10 +18,10 @@ phases:
18
18
  owner: dev
19
19
  goal: "Transformar o material em codigo reutilizavel para React ou Next.js."
20
20
  - id: planning
21
- name: "Sprint Planning"
21
+ name: "Plan Pipeline"
22
22
  owner: sm
23
- goal: "Gerar backlog, prioridades e entregaveis de sprint."
24
- - id: sync
25
- name: "ClickUp Sync"
26
- owner: devops
27
- goal: "Criar ou atualizar sprint no ClickUp."
23
+ goal: "Gerar plano por tela, tasks com criterios de aceite e ordem backend-first."
24
+ - id: quality
25
+ name: "Quality Gate"
26
+ owner: qa
27
+ goal: "Auditar seguranca e performance; validar criterios de aceite antes de fechar."
@@ -15,7 +15,13 @@ validated_at: null
15
15
 
16
16
  # <Título da tela>
17
17
 
18
- ## Contexto
18
+ > **Modelo O QUE / ONDE / COMO / POR QUE** — este plano (e cada task que ele gera) responde às 4 perguntas:
19
+ > - **POR QUE** → `## Contexto` (motivação, PRD/ticket, problema).
20
+ > - **O QUE** → `## Componentes mapeados` + `## Interações & Estados` + `## Checklist de aceite` (o entregável).
21
+ > - **ONDE** → `context.md` (`## Arquivos relevantes`) + coluna de paths nas tasks (`## Arquivos`).
22
+ > - **COMO** → `## Aderência à Stack` + `## Plano de execução` (abordagem técnica, fetching, composição).
23
+
24
+ ## Contexto (POR QUE)
19
25
 
20
26
  <Por que esta tela existe — referência ao PRD, ticket, decisão de produto.>
21
27
 
@@ -137,13 +143,23 @@ Decisões possíveis:
137
143
 
138
144
  ## Backend pendings
139
145
 
140
- > Gaps detectados confrontando Postman/regras-de-negocio com a necessidade da tela. Cada item vira task ClickUp atribuída ao Douglas (default) ou ao `ASSIGNEE` informado. Vazio = backend completo para esta tela.
146
+ > Gaps detectados confrontando Postman/regras-de-negocio com a necessidade da tela. Tracking **local** (sem serviço externo). Vazio = backend completo para esta tela.
141
147
 
148
+ > Coluna `Backend plan` referencia o plano-irmão `PLAN-NNN-backend-<slug>` quando o gap é grande o bastante para virar plano próprio; senão fica `-` (gap resolvido inline). Coluna `Status` é local: `aberto` / `em-andamento` / `concluido`.
142
149
  > Coluna `Bloqueia tasks` lista os T-IDs frontend cujo frontmatter declara `depends_on_backend:` apontando para a `gap-key` desta linha (ex.: `migration-20260501150000`).
150
+ > Coluna `Bypass frontend` declara COMO o frontend entrega sem o backend pronto (fallback, mock, toast "em breve", cast + null-coalesce). Sem bypass declarado, a tarefa frontend fica `bloqueada-backend`. **Princípio: frontend nunca bloqueado por gap de backend — sempre há bypass OU a task é explicitamente bloqueada. Execução prioriza backend-first para destravar.**
151
+
152
+ | gap-key | Gap | Bypass frontend | Endpoint/Coleção esperada | Backend plan | Status | Bloqueia tasks |
153
+ |---------|-----|-----------------|---------------------------|--------------|--------|----------------|
154
+ | | | | | | | |
155
+
156
+ ## Impacto documental
143
157
 
144
- | gap-key | Gap | Endpoint/Coleção esperada | ClickUp ID | Status | Bloqueia tasks |
145
- |---------|-----|---------------------------|------------|--------|----------------|
146
- | | | | | | |
158
+ > Item 2 / `libraries/doc-sync-policy.md`. Docs que MUDAM com esta entrega (regras de negócio, fluxos, permissões, auditorias, seeds, ADRs, guias, contratos de API). `validate-plan` bloqueia o fechamento se um item aqui não foi atualizado no diff. Vazio = entrega não toca regra de negócio nem documentação.
159
+
160
+ | Doc impactada | O que atualizar | Motivo (regra criada/alterada/removida) |
161
+ |---------------|-----------------|------------------------------------------|
162
+ | | | |
147
163
 
148
164
  ## Mock strategy
149
165
 
@@ -157,6 +173,20 @@ Decisões possíveis:
157
173
  - **Postman**: `<lista de coleções/endpoints relevantes em docs/postman/>`
158
174
  - **Stack ref**: `<sha de stack.md>`
159
175
 
176
+ ## Tabela de regressão
177
+
178
+ > Fluxos/telas existentes que este plano NÃO pode quebrar. `validate-plan` confere que nenhum item regrediu. Vazio = plano greenfield sem superfície a preservar.
179
+
180
+ - <rota/fluxo 1 — o que deve continuar funcionando (fetching + markup preservados)>
181
+ - <rota/fluxo 2>
182
+
183
+ ## Anti-padrões
184
+
185
+ > Proibições explícitas desta entrega. O executor recusa qualquer task que viole. Derivado das memórias do projeto + decisões deste plano.
186
+
187
+ - ❌ <ação proibida 1 — ex.: criar primitiva nova quando componente X já cobre; estender via prop>
188
+ - ❌ <ação proibida 2 — ex.: hardcode de RBAC inline em JSX; centralizar em helper>
189
+
160
190
  ## Riscos & Rollback
161
191
 
162
192
  - <risco>
@@ -0,0 +1,68 @@
1
+ ---
2
+ id: SPEC-<NNN>-<slug>
3
+ plan_id: PLAN-<NNN>-<slug>
4
+ tela: <nome da tela>
5
+ stack_ref: docs/stack.md@<sha-curto>
6
+ created_at: <iso>
7
+ ---
8
+
9
+ # Spec — <Título da tela>
10
+
11
+ > **Spec completa de desenvolvimento**. Deriva de `plan.md` + `context.md` + tasks e é o contrato que o **Junior executa** e o **Senior audita**. Responde O QUE / ONDE / COMO / POR QUE e fecha com critérios de aceite verificáveis. Sem placeholders: seção sem resposta = spec incompleta.
12
+
13
+ ## POR QUE (motivação)
14
+
15
+ <Problema/necessidade que a entrega resolve. Referência a PRD/ticket/decisão de produto. O que muda quando isto existir.>
16
+
17
+ ## O QUE (escopo)
18
+
19
+ <Descrição precisa do entregável: telas, componentes, comportamentos, dados. O que está DENTRO e o que está FORA do escopo (lista explícita de out-of-scope).>
20
+
21
+ **Fora de escopo:**
22
+ - <item que parece relacionado mas NÃO deve ser tocado>
23
+
24
+ ## Contrato backend / frontend
25
+
26
+ > Item 9: decidir se o backend pronto atende ANTES de detalhar o frontend.
27
+
28
+ - **Backend existente atende?** <sim | não | parcial>
29
+ - **Se sim**: o que usar (endpoint/coleção Postman | tabela | regra-de-negócio), por quê, onde e como consumir.
30
+ - **Se não/parcial**: gaps listados em `plan.md` `## Backend pendings`. Gap grande → plano-irmão `PLAN-NNN-backend-<slug>` executado ANTES do frontend dependente (backend-first).
31
+ - **Padrão de fetching**: <server component | server action | client + cache>
32
+ - **Auth/authz requerida**: <sim/não> — provider e regras (RLS/policy) de `docs/stack.md`.
33
+
34
+ ## ONDE (arquivos e rotas)
35
+
36
+ > Referência a `context.md` `## Arquivos relevantes`. Caminhos concretos.
37
+
38
+ - Rota: `<src/app/.../page.tsx>`
39
+ - Arquivos-chave: `<lista com função de cada um>`
40
+
41
+ ## COMO (abordagem técnica)
42
+
43
+ <Passo a passo da implementação em nível de spec: estrutura de pastas/rotas, fetching, composição de componentes, estado e interatividade, estados visuais (skeleton/empty/error/loading). Referência ao `## Plano de execução` do plano.>
44
+
45
+ ## Segurança e performance (checagens obrigatórias)
46
+
47
+ > Auditadas por `security-review` / `perf-review` no fechamento.
48
+
49
+ - **Segurança**: <RLS/policy aplicável, authz de endpoint/edge, validação Zod no boundary, sem secret no client>.
50
+ - **Performance**: <cache estratégico, paginação por filtro/search, evitar N+1/over-fetch, trabalho não-realtime em fila/cron>.
51
+
52
+ ## Impacto documental
53
+
54
+ > Item 2. Docs que MUDAM com esta entrega (regras de negócio, fluxos, permissões, seeds, ADR, guias). Atualizar no mesmo PR.
55
+
56
+ - <doc impactada 1 — o que atualizar>
57
+
58
+ ## Critérios de aceite (globais)
59
+
60
+ > Verificáveis (comando + resultado esperado). Cada task herda os que lhe cabem em `## Critérios de aceite (DoD)`. Se um critério falhar: loop de correção até passar (execute) / correção do Senior (validate). Anti-falso-positivo: re-verificar, nunca auto-declarar.
61
+
62
+ - [ ] <critério 1 — comando + resultado esperado>
63
+ - [ ] <critério 2>
64
+ - [ ] `tsc --noEmit` exit 0
65
+ - [ ] Estados loading/empty/error/success implementados
66
+ - [ ] Segurança: sem findings críticos em `security-review`
67
+ - [ ] Performance: sem findings críticos em `perf-review`
68
+ - [ ] Documentação impactada atualizada (seção acima)
@@ -17,30 +17,57 @@ assignees: []
17
17
  links: []
18
18
  ---
19
19
 
20
- ## Contexto
20
+ <!--
21
+ MODELO DE TASK: toda task DEVE responder às 4 perguntas, nesta ordem:
22
+ POR QUE → ## Contexto
23
+ O QUE → ## Objetivo + ## Entrega
24
+ ONDE → ## Arquivos
25
+ COMO → ## Plano de execução
26
+ Nenhuma seção pode ficar com placeholder. Se não há resposta para uma das 4, a task não está pronta para execução.
27
+ -->
21
28
 
22
- <Por que esta task existe — referência direta ao plano pai e ao critério de aceite.>
29
+ ## Contexto (POR QUE)
23
30
 
24
- ## Objetivo
31
+ <Por que esta task existe — referência direta ao plano pai e ao critério de aceite. Qual problema/gap motiva.>
25
32
 
26
- <Resultado esperado em 1-2 frases.>
33
+ ## Objetivo (O QUE)
27
34
 
28
- ## Plano de execução
35
+ <Resultado esperado em 1-2 frases — o entregável concreto, observável.>
36
+
37
+ ### Entrega
38
+
39
+ - <artefato 1 que esta task produz (componente, action, migration, story...)>
40
+ - <artefato 2>
41
+
42
+ ## Arquivos (ONDE)
43
+
44
+ > Caminhos exatos. Marque a operação. Sem isso o executor adivinha — proibido.
45
+
46
+ | Operação | Path | Nota |
47
+ |----------|------|------|
48
+ | criar | `src/.../novo.tsx` | <o que é> |
49
+ | editar | `src/.../existente.ts:NN` | <o que muda> |
50
+ | deletar | `src/.../legado.tsx` | <só se `cleanup_target`> |
51
+
52
+ ## Plano de execução (COMO)
29
53
 
30
54
  - [ ] Passo 1
31
55
  - [ ] Passo 2
32
56
  - [ ] Passo 3
33
57
 
34
- ## Critérios de aceitação (DoD)
58
+ ## Critérios de aceite (DoD)
59
+
60
+ > Cada critério é **machine-checkable** (comando + resultado esperado) OU verificável por evidência no diff. `execute-plan` roda estes critérios ao concluir a task (loop de correção: OK → segue; inconclusivo → bypass + alerta; falha → corrige até passar, teto 3). `validate-plan` (Senior) re-verifica e corrige gaps. Derivados do `spec.md` (critérios globais) + `valida_em` do plano.
35
61
 
36
- - [ ] Implementação atende `valida_em` do plano
62
+ - [ ] Implementação atende `valida_em` do plano e o critério correspondente do `spec.md`
37
63
  - [ ] **Visual gate aprovado** (relatório em `T-NNN-NN.notes.md` com 5 seções: anatomia, tokens, variants, densidade, comportamentos)
38
64
  - [ ] **Comportamentos**: cada `interaction_target` declarado tem handler/estado implementado e observável no diff
39
65
  - [ ] **Overrides**: cada `override_target` declarado foi aplicado conforme decisão (a/b/c) registrada em `## Page-level overrides`
40
66
  - [ ] **Cleanup**: quando `cleanup_target:` declarado, arquivo foi removido (`git diff --staged` mostra deleção)
41
- - [ ] Tests/CI verdes
42
- - [ ] Sem regressões
43
- - [ ] <métrica específica>
67
+ - [ ] `tsc --noEmit` exit 0 (ou comando de typecheck da stack)
68
+ - [ ] Tests/CI verdes: `<comando de teste da stack>` → passa
69
+ - [ ] Sem regressões nos fluxos de `## Tabela de regressão` do plano
70
+ - [ ] <critério específico da task — comando + resultado esperado>
44
71
 
45
72
  ## Riscos & Rollback
46
73
 
package/AGENTS.md CHANGED
@@ -32,8 +32,6 @@ Este repo existe para acelerar design-to-code e entrega de sprint.
32
32
  | **interface-design** | `/gos:skills:interface-design` | Design de interface com metodologia intent-first |
33
33
  | **react-best-practices** | `/gos:skills:react-best-practices` | Otimizacao de performance React/Next.js |
34
34
  | **react-doctor** | `/gos:skills:react-doctor` | Diagnostico de saude de componentes React |
35
- | **sprint-planner** | `/gos:skills:sprint-planner` | Planejamento completo de sprint |
36
- | **clickup** | `/gos:skills:clickup` | Gestao de tarefas e sprints no ClickUp |
37
35
  | **plan-to-tasks** | `/gos:skills:plan-to-tasks` | Converte plano em tasks acionaveis |
38
36
  | **agent-teams** | `/gos:skills:agent-teams` | Coordena multiplos agentes em time |
39
37
  | **git-ssh-setup** | `/gos:skills:git-ssh-setup` | Configura identidade SSH para o workspace |
package/CLAUDE.md CHANGED
@@ -1,11 +1,11 @@
1
1
  # ganbatte-os Context
2
2
 
3
- ganbatte-os e uma distribuicao enxuta do framework operacional ganbatte-os para:
3
+ ganbatte-os e uma distribuicao enxuta do framework operacional ganbatte-os, focada em DESENVOLVIMENTO:
4
4
 
5
+ - prototipacao de ideias
5
6
  - converter design em codigo
6
- - organizar squads de entrega
7
- - planejar sprint
8
- - sincronizar backlog no ClickUp
7
+ - implementacao, otimizacao e seguranca
8
+ - organizar squads de desenvolvimento
9
9
 
10
10
  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.
11
11
 
@@ -30,6 +30,13 @@ Todo texto gerado deve passar por correcao ortografica e remocao de padroes de I
30
30
  - **Humanizacao**: Skill `/humanizer` remove padroes de escrita artificial (26 patterns)
31
31
  - **Referencia**: `libraries/content/ai-writing-patterns.md` (taxonomia de padroes)
32
32
 
33
+ ## Qualidade de Codigo (seguranca, performance, docs)
34
+
35
+ - **Seguranca**: `security-review` audita vulnerabilidades conhecidas (React/Next/TS/Node/Deno/Supabase RLS+edge/D1). Roda no fechamento do `validate-plan` e sob demanda (`*security-review`). CRITICAL/HIGH bloqueiam o fechamento do plano. Catalogo: `libraries/security-audit-playbook.md`.
36
+ - **Performance**: `perf-review` audita cache, filas, background, cron, N+1, views/materialized, paginacao, over-fetch (Supabase e D1). Roda no fechamento e sob demanda (`*perf-review`). Catalogo: `libraries/performance-audit-playbook.md`.
37
+ - **Documentacao sempre sincronizada** (`libraries/doc-sync-policy.md`): regra de negocio criada/alterada/removida => atualizar docs impactadas (regras-de-negocio, fluxos, permissoes, ADR, seeds, contratos) no mesmo PR. `plan.md` `## Impacto documental` declara; `validate-plan` bloqueia o fechamento se algo ficou dessincronizado.
38
+ - **Anti-over-engineering** (`libraries/lazy-dev-policy.md`): escrever so o necessario — reuso > stdlib > native > dep > 1 linha > minimo. Nunca cortar validacao/seguranca/a11y.
39
+
33
40
  ## Comandos do Workspace
34
41
 
35
42
  | Comando | O que faz |
@@ -40,7 +47,6 @@ Todo texto gerado deve passar por correcao ortografica e remocao de padroes de I
40
47
  | `npm run gos:version` | Versao e atualizacoes |
41
48
  | `npm run sync:ides` | Regenera IDE adapters |
42
49
  | `npm run check:ides` | Valida IDE adapters |
43
- | `npm run clickup` | CLI ClickUp |
44
50
 
45
51
  ## Slash Commands
46
52
 
@@ -48,14 +54,24 @@ Todo texto gerado deve passar por correcao ortografica e remocao de padroes de I
48
54
  gos-master | architect | dev | devops | po | qa | sm | squad-creator | ux-design-expert
49
55
 
50
56
  ### Skills (invoke via /gos:skills:{slug})
51
- 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 | humanizer | weekly-update | slack-review | stack-profiler | plan-blueprint | progress-tracker | execute-plan | validate-plan | audit-screenshots
57
+ 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 | plan-to-tasks | agent-teams | git-ssh-setup | humanizer | stack-profiler | plan-blueprint | progress-tracker | execute-plan | validate-plan | audit-screenshots | security-review | perf-review | simplify-review
52
58
 
53
59
  ### IDEs suportadas (npm run sync:ides gera adapters)
54
60
  Claude Code | Cursor | Gemini CLI | Qwen Code | Antigravity | Opencode | Kilo Code | **Codex IDE Extension** (ambiente de execucao, comando primario `*execute-plan`)
55
61
 
62
+ ## Model routing por etapa (Junior executa, Senior audita)
63
+
64
+ Regra persistida: planos, tasks e spec sao criados pensando que um **Junior executa** e um **Senior audita**. O modelo/provider de cada etapa e **configuravel** e resolvido por `.gos/scripts/tools/model-router.js`:
65
+
66
+ - **plan** (Senior): cria plano + tasks + spec. Default `claude-opus-4-8`.
67
+ - **execute** (Junior): analisa plano/tasks/spec e implementa. Default `claude-sonnet-5` (aceita Codex e modelos mais baratos adequados).
68
+ - **validate** (Senior): audita a execucao e corrige qualquer GAP deixado pelo Junior. Default `claude-opus-4-8`.
69
+
70
+ Precedencia: `.gos-local/models.json` (override local por dev/projeto) → `.gos/config.json` campo `stageModels` (default versionado). `gos init` gera o `.gos-local/models.json`. Consulta: `node .gos/scripts/tools/model-router.js get <plan|execute|validate>`.
71
+
56
72
  ## Plan Pipeline (stack-aware)
57
73
 
58
- Pipeline padronizado para criacao de planos por tela. Toda tela = 1 plano. Stack-of-record (`docs/stack.md`) e contrato — alteracoes de stack exigem ADR. Divisao de trabalho: **Opus 4.7 planeja, Codex IDE executa**.
74
+ Pipeline padronizado para criacao de planos por tela. Toda tela = 1 plano. Stack-of-record (`docs/stack.md`) e contrato — alteracoes de stack exigem ADR. Divisao de trabalho: **Senior (etapa plan) planeja, Junior (etapa execute) implementa, Senior (etapa validate) audita** — modelos definidos em `stageModels` (ver acima).
59
75
 
60
76
  | Comando | Skill | IDE / Modelo | Funcao |
61
77
  |---------|-------|--------------|--------|
@@ -65,7 +81,7 @@ Pipeline padronizado para criacao de planos por tela. Toda tela = 1 plano. Stack
65
81
  | `*validate-plan <PLAN-NNN>` | `validate-plan` | Opus 4.7 (revisor) | Valida pos-execute; auto-marca concluido tasks que passam em checklist + visual gate curto + diff |
66
82
  | `*progress [show|set|status]` | `progress-tracker` | qualquer | Memoria L1 + state machine de status |
67
83
 
68
- State machine: `pendente -> em-andamento -> validacao -> concluido`. Estado lateral `bloqueada-backend` (introduzido pelo `*execute-plan` quando task tem `depends_on_backend:` em aberto no ClickUp; libera quando ClickUp fecha). `concluido` marcado automaticamente pelo `*validate-plan` quando passa em checklist + visual gate curto + diff + cobertura de `interaction_target`/`override_target`.
84
+ State machine: `pendente -> em-andamento -> validacao -> concluido`. Estado lateral `bloqueada-backend` (introduzido pelo `*execute-plan` quando task tem `depends_on_backend:` com gap de backend ainda em aberto no tracking local; libera quando o pending local fecha). `concluido` marcado automaticamente pelo `*validate-plan` quando passa em checklist + visual gate curto + diff + cobertura de `interaction_target`/`override_target`.
69
85
 
70
86
  **Politica Figma vs Storybook**: story define API/anatomia do componente; em conflito visual cosmetico (bg, border, padding, radius), Figma da pagina vence — divergencia e registrada em `## Page-level overrides` do plano com decisao a/b/c (a=className, b=variant nova, c=excecao documentada). Sem essa disciplina, refinamentos da pagina viram retrabalho no fim (caso PLAN-005: 54 deltas em 26 rodadas).
71
87
 
@@ -73,7 +89,7 @@ State machine: `pendente -> em-andamento -> validacao -> concluido`. Estado late
73
89
 
74
90
  **Cleanup de starter legado (Fase 1.6)**: `.gos-local/plan-paths.json` campo `legacy_starter_dirs: ["src/figma-make/", ...]` faz `*plan` emitir tasks `T-NN-cleanup-legacy-<slug>` automaticamente para arquivos do starter. Sem o campo, comportamento atual preservado.
75
91
 
76
- **Schema/contrato gate (Fase 2.4)**: `.gos-local/plan-paths.json` campo `backend_schema_files: [...]` (Postman + Prisma) faz `*plan` validar contrato antes de emitir tasks frontend; gaps viram task ClickUp + entrada em `## Backend pendings`.
92
+ **Schema/contrato gate (Fase 2.4)**: `.gos-local/plan-paths.json` campo `backend_schema_files: [...]` (Postman + Prisma) faz `*plan` validar contrato antes de emitir tasks frontend; gaps viram entrada local em `## Backend pendings` (e plano-irmao `PLAN-NNN-backend-<slug>` quando grandes).
77
93
 
78
94
  **Skill `*audit-screenshots`**: conversacional. Recebe N prints anotados em uma sessao, resolve cada print -> tela -> Figma frame via `docs/figma-screen-map.md`, compara, e ao fechar emite UM plano de correcao com tasks pendentes (sem executar). Acoplado ao mesmo template — output e input valido para `*execute-plan`/`*validate-plan`.
79
95
 
package/GEMINI.md CHANGED
@@ -1,12 +1,12 @@
1
1
  # ganbatte-os For Gemini CLI
2
2
 
3
- Use este projeto como um kit de design-to-code e sprint ops.
3
+ Use este projeto como um kit de desenvolvimento: design-to-code, implementacao, otimizacao e seguranca.
4
4
 
5
5
  ## Prioridades
6
6
 
7
7
  - Figma, Figma Make e Stitch para React/Next.js
8
- - planejamento de sprint
9
- - ClickUp
8
+ - planejamento por tela (plano + tasks com criterios de aceite)
9
+ - auditoria de seguranca e performance
10
10
  - revisao de qualidade antes de entrega
11
11
 
12
12
  ## Fontes principais
package/LICENSE CHANGED
@@ -1,6 +1,6 @@
1
1
  MIT License
2
2
 
3
- Copyright (c) 2026 Douglas Oliveira
3
+ Copyright (c) 2026 Douglas Oliveira (https://github.com/imdouglasoliveira)
4
4
 
5
5
  Permission is hereby granted, free of charge, to any person obtaining a copy
6
6
  of this software and associated documentation files (the "Software"), to deal
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # ganbatte-os
2
2
 
3
- Framework operacional para design-to-code, squads de entrega e sprint sync com ClickUp.
3
+ Framework operacional de desenvolvimento: prototipacao, design-to-code, implementacao, otimizacao e seguranca.
4
4
 
5
5
  ---
6
6
 
@@ -8,7 +8,7 @@ Framework operacional para design-to-code, squads de entrega e sprint sync com C
8
8
  [![NPM Home](https://img.shields.io/badge/NPM-Registry-red)](https://www.npmjs.com/package/ganbatte-os)
9
9
  ![Node >= 18](https://img.shields.io/badge/Node.js-%3E%3D18-green)
10
10
 
11
- 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`.
11
+ O **ganbatte-os** organiza agentes de IA, skills e squads num workspace pronto para uso. Ele orquestra o ciclo completo de desenvolvimento da prototipacao à implementação, otimização e segurança — conectando Figma e as principais IDEs de IA (Claude Code, Gemini, Cursor, etc). Baseado nos padrões do framework `.a8z-OS`.
12
12
 
13
13
  ## Quick Start
14
14
 
@@ -52,7 +52,6 @@ Após rodar o install, o framework criará uma estrutura limpa na sua raiz:
52
52
  | `npm run gos:rescue` | `gos rescue` | Lista/recupera stashes acumulados de updates falhos |
53
53
  | `npm run sync:ides` | — | Regenera apenas os IDE adapters (`.claude/`, `.qwen/`, `.gemini/`, `.cursor/`, `.agents/`) |
54
54
  | `npm run check:ides` | — | Valida que adapters estão consistentes com `.gos/skills/registry.json` |
55
- | `npm run clickup` | — | CLI ClickUp |
56
55
 
57
56
  ## Atualizar o ganbatte-os
58
57
 
@@ -210,8 +209,8 @@ O `ganbatte-os` utiliza uma estrutura **encapsulada** para manter seu projeto li
210
209
  ## Funcionalidades Principais
211
210
 
212
211
  - **Design-to-Code**: Pipeline automatizado para converter frames do Figma em componentes React/Next.js de alta fidelidade.
213
- - **Squads de Entrega**: Agentes especializados (SM, PO, Dev, QA) que trabalham de forma coordenada.
214
- - **Sincronização ClickUp**: Conecta seu workspace diretamente ao ClickUp para automação de status e tarefas.
212
+ - **Pipeline de Planos**: Plano por tela com `spec.md`, tasks com critérios de aceite e loop de correção automática (Opus planeja, modelo barato executa, Opus valida).
213
+ - **Auditoria de Segurança e Performance**: Verificação sistemática de vulnerabilidades (RLS, authz, secrets) e otimização (cache, filas, N+1, paginação) em Supabase e D1.
215
214
  - **Multi-IDE Multi-Tenant**: Configurações automáticas para as melhores ferramentas de IA do mercado.
216
215
 
217
216
  ## Agentes Disponíveis
@@ -242,13 +241,12 @@ O `ganbatte-os` utiliza uma estrutura **encapsulada** para manter seu projeto li
242
241
  | **interface-design** | `/gos:skills:interface-design` | Design de interface com metodologia intent-first |
243
242
  | **react-best-practices** | `/gos:skills:react-best-practices` | Otimizacao de performance React/Next.js |
244
243
  | **react-doctor** | `/gos:skills:react-doctor` | Diagnostico de saude de componentes React |
245
- | **sprint-planner** | `/gos:skills:sprint-planner` | Planejamento completo de sprint |
246
- | **clickup** | `/gos:skills:clickup` | Gestao de tarefas e sprints no ClickUp |
247
244
  | **plan-to-tasks** | `/gos:skills:plan-to-tasks` | Converte plano em tasks acionaveis |
248
245
  | **agent-teams** | `/gos:skills:agent-teams` | Coordena multiplos agentes em time |
249
246
  | **git-ssh-setup** | `/gos:skills:git-ssh-setup` | Configura identidade SSH para o workspace |
250
247
  | **humanizer** | `/gos:skills:humanizer` | Remove padroes de IA do texto (two-pass audit + soul injection) |
251
- | **weekly-update** | `/gos:skills:weekly-update` | Resumo semanal de tasks ClickUp humaniza → posta no Slack (requer aprovacao) |
248
+ | **security-review** | `/gos:skills:security-review` | Auditoria de seguranca (RLS, authz, secrets, injection) |
249
+ | **perf-review** | `/gos:skills:perf-review` | Auditoria de performance (cache, filas, N+1, paginacao) |
252
250
  | **stack-profiler** | `/gos:skills:stack-profiler` | Mantem `docs/stack.md` como stack-of-record canonica do projeto |
253
251
  | **plan-blueprint** | `/gos:skills:plan-blueprint` | Cria plano por tela (1 tela = 1 plano) seguindo a stack |
254
252
  | **progress-tracker** | `/gos:skills:progress-tracker` | Memoria L1 (`progress.txt`) + state machine de status |
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "ganbatte-os",
3
- "version": "0.2.38",
4
- "description": "Framework operacional para design-to-code, squads de entrega e sprint sync com ClickUp.",
3
+ "version": "0.2.42",
4
+ "description": "Framework operacional de desenvolvimento: prototipacao, design-to-code, implementacao, otimizacao e seguranca.",
5
5
  "bin": {
6
6
  "gos": ".gos/scripts/cli/gos-cli.js"
7
7
  },
@@ -11,7 +11,6 @@
11
11
  "gos:doctor": "node .gos/scripts/cli/gos-cli.js doctor",
12
12
  "gos:version": "node .gos/scripts/cli/gos-cli.js version",
13
13
  "gos:rescue": "node .gos/scripts/cli/gos-cli.js rescue",
14
- "clickup": "node .gos/scripts/tools/clickup.js",
15
14
  "sync:ides": "node .gos/scripts/integrations/setup-ide-adapters.js",
16
15
  "check:ides": "node .gos/scripts/integrations/check-ide-compat.js",
17
16
  "doctor": "node .gos/scripts/cli/gos-cli.js doctor"