ganbatte-os 0.2.33 → 0.2.34

package/.gos/agents/profiles/ganbatte-os-master.md

@@ -93,6 +93,11 @@ comprehension_gate:
   protocol:
     step_0_scan: "Read relevant files, docs, recent commits related to the request"
     step_0_5_stack: "If routing to planning/implementation: load docs/stack.md (path from .gos-local/plan-paths.json). If absent, abort and dispatch stack-profiler refresh."
+    step_0_55_storybook: "If routing to plan/execute: resolve dirs.storybook and index .stories.tsx files. Absent storybook = abort plan-blueprint until path provided."
+    step_0_56_project: "Resolve PROJETO from cwd. If ambiguous (monorepo root), check ~/.claude/.gos-state/last-project.json; if absent ask once and persist there for silent reuse."
+    step_0_57_branch: "Auto-resolve WORK_BRANCH: tela bate com dirs.storybook → feat/storybook; senão → dev. Não pedir ao usuário."
+    step_0_58_knowledge: "On *plan: index <PROJETO>/docs/regras-de-negocio/ and <PROJETO>/docs/postman/ (when present). Register inventory in progress.txt under '## Knowledge mapped — PLAN-NNN'. Ausência não bloqueia (apenas Storybook bloqueia)."
+    step_0_59_backend_gaps: "On *plan: detected backend gaps (endpoint não existe no Postman, RLS incompleto, migration ausente para o shape exigido) → criar task ClickUp via mcp__clickup__clickup_create_task, assignee Douglas Oliveira (112010775) salvo override ASSIGNEE no prompt. Título: '[Backend] PLAN-NNN: <gap>'. Registrar IDs em progress.txt e plan.md (## Backend pendings). Flag --skip-clickup desliga."
     step_0_6_progress: "If progress.txt exists at the configured path: read it for active plan/task context (memória L1)."
     step_1_document: "State what exists (current state, patterns, constraints) in factual terms"
     step_2_assess: "Determine which agent/skill/workflow is appropriate based on evidence, not assumption"
@@ -199,13 +204,28 @@ routing_matrix:
     triggers: [plan, plano, screen plan, tela, criar plano, blueprint, plano de tela]
     target: skill:plan-blueprint
     pre_action: Validate docs/stack.md exists; if not, dispatch stack-profiler first
-    notes: 1 tela = 1 plano. Subdivide automaticamente quando há múltiplas seções autônomas
+    notes: |
+      1 tela = 1 plano. OBJETIVO obrigatório no prompt:
+        - implantacao  → criar do zero (fluxo padrão)
+        - correcao     → cirúrgico, diff vs Storybook, 1 task por componente
+        - refactor     → implica --allow-arch-change + ADR
+      Auto-resolve PROJETO/WORK_BRANCH/BUSINESS_RULES/POSTMAN no comprehension gate.
+      Backend gaps → tasks ClickUp automáticas pro Douglas (--skip-clickup desliga).
 
   progress_tracking:
     triggers: [progress, status, progress.txt, memoria curta, l1]
     target: skill:progress-tracker
     notes: State machine pendente → em-andamento → validacao → concluido
 
+  execute_plan:
+    triggers: [execute, executar plano, run plan, "*execute-plan", execute plan, executar PLAN]
+    target: skill:execute-plan
+    pre_action: Validate PLAN-NNN-<slug>/plan.md exists; load stack.md; index dirs.storybook stories
+    notes: |
+      Comando primário do ambiente Codex IDE Extension.
+      Ciclo Opus(plan) → Codex(execute). Roda task-a-task com state machine
+      e visual gate obrigatório contra Storybook canônico antes de validacao.
+
   product_decisions:
     triggers: [PRD, requirements, product decision, scope, feature priority]
     target: agent:po
@@ -292,6 +312,9 @@ commands:
   - name: progress
     args: "[init|show|set <plan>|status <task> <novo-status>|compact|read]"
     description: Gerencia progress.txt (memória L1) e state machine de status
+  - name: execute-plan
+    args: "<PLAN-NNN-slug> [--task T-NNN-NN] [--skip-visual-gate]"
+    description: Executa plano task-a-task com visual gate obrigatório (comando primário do Codex IDE)
 
   # Quality
   - name: check
@@ -328,7 +351,7 @@ available_squads:
   - name: git-operations
     purpose: SSH setup, quality gate, safe commit+push
 
-# ─── AVAILABLE SKILLS (18) ────────────────────────────────────
+# ─── AVAILABLE SKILLS (19) ────────────────────────────────────
 available_skills:
   - design-to-code
   - figma-implement-design
@@ -348,6 +371,7 @@ available_skills:
   - stack-profiler
   - plan-blueprint
   - progress-tracker
+  - execute-plan
 
 # ─── PLAYBOOKS ────────────────────────────────────────────────
 available_playbooks:
@@ -449,7 +473,8 @@ security:
 **Plan pipeline (stack-aware):**
 
 - `*stack [refresh|show|drift]` - Mantém docs/stack.md
-- `*plan <tela|figma-url|descrição>` - Cria plano por tela
+- `*plan <tela|figma-url|descrição>` - Cria plano por tela (Opus, planejamento)
+- `*execute-plan <PLAN-NNN-slug>` - Executa plano com visual gate (Codex IDE, execução)
 - `*progress [show|set|status|compact]` - Gerencia progress.txt (L1)
 
 **Framework:**

package/.gos/integrations/registry.json

@@ -13,7 +13,7 @@
     "antigravity": { "workspaceDir": ".antigravity", "skillsDir": ".antigravity/skills", "adapter": "integrations/antigravity", "status": "active" },
     "gemini-cli": { "workspaceDir": ".gemini", "contextFile": "GEMINI.md", "status": "active" },
     "cursor": { "workspaceDir": ".cursor", "ruleFile": ".cursor/rules/g-os.mdc", "status": "active" },
-    "codex": { "workspaceDir": ".codex", "skillsDir": ".agents/skills", "adapter": "integrations/codex", "status": "active" },
+    "codex": { "workspaceDir": ".codex", "skillsDir": ".codex/skills", "agentsDir": ".codex/agents", "commandsDir": ".codex/commands", "configFile": ".codex/config.toml", "rulesFile": ".codex/AGENTS.md", "adapter": "integrations/codex", "status": "active" },
     "opencode": { "workspaceDir": ".opencode", "adapter": "integrations/opencode", "status": "active" },
     "kilo-code": { "workspaceDir": ".kilocode", "ruleFile": ".kilocode/rules/g-os.md", "status": "active" },
     "qwen-code": { "workspaceDir": ".qwen", "skillsDir": ".qwen/skills", "commandsDir": ".qwen/commands/gos", "agentsDir": ".qwen/agents", "adapter": "integrations/qwen", "status": "active" }

package/.gos/playbooks/plan-creation-playbook.md

@@ -39,19 +39,31 @@ Se houver drift, decidir entre:
 ### 2. Criar plano
 
 ```
-*plan <tela|figma-url|descrição>
+*plan <tela>
+
+OBJETIVO = implantacao | correcao | refactor   # obrigatório
+FIGMA    = <url-frame>
+FIGMA+   = [<url-comp>, ...]                   # opcional
+NOTAS    = """<prosa livre>"""                 # opcional
+ASSIGNEE = <user-id>                           # opcional, default 112010775 (Douglas)
 ```
 
+`gos-master` resolve no comprehension gate (não pedir ao usuário):
+- `PROJETO` (cwd, ou `~/.claude/.gos-state/last-project.json`)
+- `WORK_BRANCH` (`dev` para app, `feat/storybook` quando em Storybook)
+- Indexação de `<PROJETO>/docs/regras-de-negocio/` e `docs/postman/` (registrada em `progress.txt`)
+
 `plan-blueprint` executa:
 1. Fase 1 — Mapeamento Visual & Componentização
 2. Fase 2 — Aderência à Stack (sem redefinir arquitetura)
+2.5 Fase 2.5 — Backend gaps → criar tasks ClickUp pro Douglas (`--skip-clickup` desliga)
 3. Fase 3 — Plano de Execução
 
 Saídas:
-- `<dirs.planos>/PLAN-NNN-<slug>/plan.md`
+- `<dirs.planos>/PLAN-NNN-<slug>/plan.md` (com seções `## Backend pendings` e `## Knowledge mapped`)
 - `<dirs.planos>/PLAN-NNN-<slug>/context.md`
 - `<dirs.planos>/PLAN-NNN-<slug>/tasks/T-NNN-NN-*.md`
-- `progress.txt` atualizado com plano ativo
+- `progress.txt` atualizado com plano ativo + inventário de knowledge + backend pendings
 
 ### 3. Revisar e aceitar
 
@@ -62,19 +74,29 @@ Humano revisa:
 
 Se aprovado, prosseguir. Caso contrário: ajustar manualmente ou rerodar `*plan` com refinamento.
 
-### 4. Executar tasks
-
-Para cada task, dev (humano ou LLM):
+### 3.5. Pre-flight visual (antes de executar)
 
 ```
-*progress status T-NNN-NN em-andamento
+*execute-plan PLAN-NNN-<slug>
 ```
 
-Implementa, commita localmente (sem push), atualiza:
+A skill `execute-plan` resolve `dirs.storybook`, indexa `.stories.tsx` disponíveis e confronta cada componente da tabela "Componentes mapeados" do plano. Componente sem story → bloqueia e propõe task de criação ANTES das tasks de implementação.
 
-```
-*progress status T-NNN-NN validacao
-```
+> Ambiente recomendado: **Codex IDE Extension** (executor). O `*plan` da etapa 2 roda em Opus 4.7 (planejador). Adapter Codex é gerado por `npm run sync:ides`.
+
+### 4. Executar tasks (orquestrado por execute-plan)
+
+`execute-plan` itera as tasks em ordem de `seq`:
+
+1. `*progress status T-NNN-NN em-andamento` (state machine).
+2. Despacha agent (`labels: [agent:<slug>]`, default `dev`) para implementar.
+3. **Visual gate** antes de marcar `validacao`:
+   - Compara cada componente alterado com `<Componente>.stories.tsx` em 4 dimensões (anatomia, tokens, variants, densidade).
+   - Cruza JSX da tela com Figma MCP (árvore vs hierarquia).
+   - Falha → task volta a `em-andamento` com diff em `tasks/T-NNN-NN.notes.md`.
+4. Sucesso → `*progress status T-NNN-NN validacao`.
+
+Para rodar uma task específica fora do loop: `*execute-plan PLAN-NNN-<slug> --task T-NNN-NN`.
 
 ### 5. Validação
 
@@ -116,7 +138,8 @@ Validação humana + QA. Se aprovado:
 ## Skills relacionadas
 
 - `stack-profiler` — produz/mantém `stack.md`
-- `plan-blueprint` — cria plano por tela
+- `plan-blueprint` — cria plano por tela (Opus, planejamento)
 - `plan-to-tasks` — decompõe plano em tasks (chamada automaticamente)
+- `execute-plan` — executa plano com visual gate (Codex IDE, execução)
 - `progress-tracker` — gerencia `progress.txt`
 - `clickup` — sync opcional para tracking externo (não obrigatório)

package/.gos/scripts/integrations/setup-ide-adapters.js

@@ -103,13 +103,23 @@ function main() {
     const agentTarget = relativeTarget(qwenAgent, agentProfilePath);
     const safeDesc = agentDesc.replace(/"/g, '\\"').replace(/\n/g, ' ').slice(0, 200);
     writeFile(qwenAgent, `---\nname: "gos-${agent.id}"\ndescription: "${safeDesc}"\nmodel: inherit\ntools:\n  - Read\n  - Glob\n  - Grep\n  - Bash\n  - Edit\n  - Write\n---\n\nFonte canonica: \`${agentTarget}\`\nLeia e siga o perfil em \`${agentTarget}\`.`);
+
+    // Codex commands (slash commands no Codex IDE Extension)
+    const codexCmd = path.join(root, '.codex', 'commands', 'gos', 'agents', `${agent.id}.md`);
+    writeFile(codexCmd, claudeCommandWrapper(`gos-${agent.id}`, agentDesc, relativeTarget(codexCmd, agentProfilePath)));
+
+    // Codex sub-agents (Codex IDE espera .codex/agents/<id>.md)
+    const codexAgent = path.join(root, '.codex', 'agents', `gos-${agent.id}.md`);
+    const codexAgentTarget = relativeTarget(codexAgent, agentProfilePath);
+    writeFile(codexAgent, `---\nname: "gos-${agent.id}"\ndescription: "${safeDesc}"\nmodel: inherit\ntools:\n  - Read\n  - Glob\n  - Grep\n  - Bash\n  - Edit\n  - Write\n---\n\nFonte canonica: \`${codexAgentTarget}\`\nLeia e siga o perfil em \`${codexAgentTarget}\`.`);
   }
 
   for (const skill of skills) {
     const skillTargetPath = skill.skillFile || skill.path;
     const canonicalPath = path.join(root, '.gos', skillTargetPath);
     const claudeSkill = path.join(root, '.claude', 'commands', 'gos', 'skills', `${skill.slug}.md`);
-    const codexSkill = path.join(root, '.agents', 'skills', `gos-${skill.slug}`, 'SKILL.md');
+    const codexSkill = path.join(root, '.codex', 'skills', `gos-${skill.slug}`, 'SKILL.md');
+    const codexSkillCmd = path.join(root, '.codex', 'commands', 'gos', 'skills', `${skill.slug}.md`);
     const antigravitySkill = path.join(root, '.antigravity', 'skills', `gos-${skill.slug}`, 'SKILL.md');
     const geminiSkill = path.join(root, '.gemini', 'skills', `gos-${skill.slug}`, 'SKILL.md');
     const opencodeSkill = path.join(root, '.opencode', 'skills', `gos-${skill.slug}`, 'SKILL.md');
@@ -129,6 +139,7 @@ function main() {
     writeFile(qwenSkill, skillWrapper(skill.slug, relativeTarget(qwenSkill, canonicalPath), skillDesc));
 
     writeFile(qwenCmd, qwenCommandWrapper(`gos-${skill.slug}`, skillDesc, relativeTarget(qwenCmd, canonicalPath)));
+    writeFile(codexSkillCmd, claudeCommandWrapper(`gos-${skill.slug}`, skillDesc, relativeTarget(codexSkillCmd, canonicalPath), skillArgHint));
     writeFile(claudeSkill, claudeCommandWrapper(`gos-${skill.slug}`, skillDesc, relativeTarget(claudeSkill, canonicalPath), skillArgHint));
   }
 
@@ -169,7 +180,98 @@ function main() {
     )
   );
 
+  // Codex IDE Extension — AGENTS.md + config.toml
+  // Codex e o ambiente de EXECUCAO (Opus planeja, Codex executa). Bloco abaixo garante
+  // que slash commands e subagents estao disponiveis ao abrir o projeto no Codex.
+  const codexAgentsMd = [
+    '# G-OS no Codex IDE Extension',
+    '',
+    'Este arquivo e auto-gerado por `npm run sync:ides`. Nao edite a mao.',
+    '',
+    'Codex IDE Extension e o ambiente de EXECUCAO do G-OS. Opus 4.7 planeja em outra IDE/sessao;',
+    'Codex executa task-a-task com `*execute-plan`.',
+    '',
+    'Leia sempre:',
+    '- `../AGENTS.md` (raiz do projeto)',
+    '- `../CLAUDE.md`',
+    '- `../.gos/docs/toolchain-map.md`',
+    '',
+    '## Execucao de planos (comando primario do Codex)',
+    '',
+    '```',
+    '*execute-plan PLAN-NNN-<slug>',
+    '```',
+    '',
+    'Ciclo: pre-flight visual -> loop por task com state machine -> visual gate -> validacao -> humano marca concluido.',
+    'Detalhes: `../.gos/skills/execute-plan/SKILL.md`.',
+    '',
+    '## Agents disponiveis',
+    '',
+    ...agents.map((agent) => `- \`gos-${agent.id}\` -> \`../.gos/agents/profiles/${agent.path}\``),
+    '',
+    '## Skills curadas',
+    '',
+    '| Slug | Arquivo canonico |',
+    '|------|------------------|',
+    ...skills.map((skill) => `| \`gos-${skill.slug}\` | \`../.gos/${skill.skillFile || skill.path}\` |`),
+    '',
+    '## Como o Codex consome',
+    '',
+    '- Slash commands em `.codex/commands/gos/{agents,skills}/<id>.md` -> Codex carrega o canonico apontado em CANONICAL-SOURCE e executa.',
+    '- Subagents em `.codex/agents/gos-<id>.md` -> referencia o profile em `.gos/agents/profiles/`.',
+    '- Skills em `.codex/skills/gos-<slug>/SKILL.md` -> wrapper fino que aponta para `.gos/skills/<slug>/SKILL.md`.',
+    ''
+  ].join('\n');
+  writeFile(path.join(root, '.codex', 'AGENTS.md'), codexAgentsMd);
+
+  const codexConfigToml = [
+    '# G-OS Codex IDE Extension config (auto-gerado por npm run sync:ides).',
+    '# Edite os arquivos canonicos em .gos/ ao inves deste.',
+    '',
+    'project = "g-os"',
+    '',
+    '[instructions]',
+    'files = [',
+    '  "AGENTS.md",',
+    '  "../AGENTS.md",',
+    '  "../CLAUDE.md",',
+    '  "../.gos/docs/toolchain-map.md",',
+    ']',
+    '',
+    '[execution]',
+    'primary_command = "*execute-plan"',
+    'planning_command = "*plan"',
+    'progress_command = "*progress"',
+    'stack_command = "*stack"',
+    ''
+  ].join('\n');
+  writeFile(path.join(root, '.codex', 'config.toml'), codexConfigToml);
+
+  // Validacao final: garantir que os arquivos do Codex foram gerados.
+  // Evita regressoes silenciosas que ja quebraram a IDE no passado.
+  const codexFailures = [];
+  for (const agent of agents) {
+    const expectedAgent = path.join(root, '.codex', 'agents', `gos-${agent.id}.md`);
+    const expectedCmd = path.join(root, '.codex', 'commands', 'gos', 'agents', `${agent.id}.md`);
+    if (!fs.existsSync(expectedAgent)) codexFailures.push(expectedAgent);
+    if (!fs.existsSync(expectedCmd)) codexFailures.push(expectedCmd);
+  }
+  for (const skill of skills) {
+    const expectedSkill = path.join(root, '.codex', 'skills', `gos-${skill.slug}`, 'SKILL.md');
+    const expectedCmd = path.join(root, '.codex', 'commands', 'gos', 'skills', `${skill.slug}.md`);
+    if (!fs.existsSync(expectedSkill)) codexFailures.push(expectedSkill);
+    if (!fs.existsSync(expectedCmd)) codexFailures.push(expectedCmd);
+  }
+  if (!fs.existsSync(path.join(root, '.codex', 'AGENTS.md'))) codexFailures.push('.codex/AGENTS.md');
+  if (!fs.existsSync(path.join(root, '.codex', 'config.toml'))) codexFailures.push('.codex/config.toml');
+  if (codexFailures.length > 0) {
+    console.error(`[sync:ides] Codex IDE adapters incompletos. Faltando ${codexFailures.length} arquivos:`);
+    for (const f of codexFailures) console.error(`  - ${path.relative(root, f)}`);
+    process.exit(1);
+  }
+
   console.log(`Adapters generated for ${agents.length} agents and ${skills.length} skills.`);
+  console.log(`Codex IDE: ${agents.length} agents + ${skills.length} skills + AGENTS.md + config.toml.`);
 }
 
 main();

package/.gos/skills/execute-plan/SKILL.md

@@ -0,0 +1,117 @@
+---
+name: execute-plan
+description: Executa um plano (PLAN-NNN-<slug>) task-a-task aplicando state machine + visual gate contra Storybook canonico antes de marcar validacao. Comando primario do ambiente Codex IDE.
+argument-hint: "<PLAN-NNN-slug> [--task T-NNN-NN] [--skip-visual-gate]"
+allowedTools: [Read, Glob, Grep, Bash, Write, Edit, Agent, AskUserQuestion]
+sourceDocs:
+  - templates/taskTemplate.md
+  - playbooks/plan-creation-playbook.md
+  - skills/figma-implement-design/SKILL.md
+  - skills/plan-blueprint/SKILL.md
+use-when:
+  - executar plano ja criado por *plan
+  - rodar tasks de um PLAN-NNN com state machine e visual gate
+  - ambiente Codex IDE Extension (comando primario)
+do-not-use-for:
+  - criar plano novo (use plan-blueprint)
+  - decompor plano em tasks (use plan-to-tasks)
+  - gerenciar progress.txt isoladamente (use progress-tracker)
+metadata:
+  category: execution
+---
+
+Voce esta executando como **Executor de Planos** via skill `execute-plan`. No ambiente Codex IDE Extension este e o comando primario do ciclo `Opus(plan) -> Codex(execute)`.
+
+## Input
+
+$ARGUMENTS
+
+Formato esperado:
+- `<PLAN-NNN-slug>` — id do plano (ex.: `PLAN-001-pagina-projetos-inicial`)
+- `--task T-NNN-NN` — opcional, executa apenas a task especifica
+- `--skip-visual-gate` — opcional, pula visual gate (raro, registra warning)
+
+## Pre-requisitos (gate)
+
+1. Resolver paths via `.gos-local/plan-paths.json`. Se ausente, abortar e instruir o usuario a rodar `*plan` primeiro.
+2. Localizar `<dirs.planos>/<PLAN-NNN-slug>/plan.md`. Se ausente, abortar.
+3. Ler `plan.md` por completo: frontmatter + Componentes mapeados + Componentes ausentes + Aderencia a stack + Plano de execucao + Checklist de aceite.
+4. Validar `stack_ref` do frontmatter contra `<dirs.stack>` (`docs/stack.md`):
+   - Calcular sha-curto atual e comparar.
+   - Drift detectado: ABORTAR e instruir `*stack drift` + replanejar com `*stack refresh`.
+5. Ler `<dirs.progress>` (progress.txt). Se aponta para outro plano ativo, perguntar se troca o foco antes de prosseguir.
+
+## Pre-flight visual
+
+(Pulado quando `--skip-visual-gate` presente — registrar warning em `tasks/T-NNN-NN.notes.md` da primeira task.)
+
+1. Resolver `<dirs.storybook>` via `plan-paths.json`. Path absoluto fora do repo do projeto e valido (ex.: `E:\Github\Ganbatte\tmp\fractus-storybook`).
+2. Indexar todos `.stories.tsx` disponiveis em `<dirs.stories>` ou `<dirs.components>`.
+3. Para cada linha da tabela "Componentes mapeados" do plano:
+   - Confirmar que a coluna `Story (path)` aponta para arquivo existente.
+   - Se ausente: gerar task de criacao do componente ANTES das tasks de implementacao. Renumerar `seq` das tasks restantes.
+4. Output do pre-flight: bloco em `progress.txt` campo `notes=` com numero de stories indexadas e tasks de criacao geradas.
+
+## Loop por task
+
+Iterar tasks em ordem de `seq`. Para cada `tasks/T-NNN-NN-*.md`:
+
+1. **Mover para em-andamento**: `*progress status T-NNN-NN em-andamento`. State machine valida transicao.
+2. **Despachar agent**: ler `labels: [agent:<slug>]` da task. Default: `dev`. Invocar via Agent tool com prompt completo (objetivo, plano de execucao, DoD, paths relevantes).
+3. **Implementacao**: agent edita arquivos seguindo o plano de execucao da task. Stack como contrato — nada fora de `docs/stack.md` salvo se `arch_change=true` no frontmatter do plano pai.
+4. **Visual gate** (antes de propor `validacao`):
+
+   Para cada componente alterado/criado pela task:
+
+   a) Localizar `<Componente>.stories.tsx` em `<dirs.storybook>`.
+   b) Comparar implementacao vs story canonica em 4 dimensoes textuais:
+      - **Anatomia**: ordem de slots/elementos (header -> corpo -> footer; icones esquerda/direita; campos do form na ordem do design).
+      - **Tokens**: classes Tailwind/variaveis CSS batem com DS (cor, raio, espacamento, tipografia).
+      - **Variants**: props expostos cobrem variants da story.
+      - **Densidade**: padding/gap dentro de +-1 step da escala do DS.
+   c) Para a tela como um todo: invocar Figma MCP no `figma_url` do plano e cruzar com o JSX renderizado em arvore (mesmo numero de secoes, mesma hierarquia, mesmas labels).
+   d) Output: relatorio curto em `tasks/T-NNN-NN.notes.md` (4 secoes: anatomia, tokens, variants, densidade + secao "Arvore vs Figma").
+   e) Divergencia >= 1 item critico (anatomia ou tokens) -> falha o gate.
+
+5. **Resultado do gate**:
+   - Sucesso -> `*progress status T-NNN-NN validacao`. Preparar arquivos staged (sem commit).
+   - Falha -> manter em `em-andamento`, gravar diff em `T-NNN-NN.notes.md`, retornar pra etapa 3.
+
+## Fechamento
+
+Quando todas as tasks atingirem `validacao` E o checklist de aceite do plano estiver marcado:
+
+1. Listar arquivos modificados via `git diff --name-only`.
+2. Preparar commit (NAO push). Mensagem segue Conventional Commits + referencia ao `PLAN-NNN-slug`.
+3. Resumo final ao usuario:
+   - Path do plano + numero de tasks concluidas.
+   - Lista de componentes que passaram/falharam o visual gate.
+   - Comando exato para o humano marcar `concluido`: `*progress status T-NNN-NN concluido` (apos validacao humana + smoke E2E).
+
+## Ambiente Codex IDE — observacoes
+
+- O usuario invoca `*execute-plan` direto no Codex. A skill carrega via wrapper em `.codex/skills/gos-execute-plan/SKILL.md`.
+- Toda chamada a outros agents/skills do G-OS dentro do execute-plan deve usar o adapter Codex correspondente (`.codex/agents/`, `.codex/commands/`).
+- Se a chamada cair pra outro adapter (Claude/Qwen/etc) a sessao quebra — abortar com mensagem clara.
+
+## Regras criticas
+
+- **Visual gate nao e opcional** salvo `--skip-visual-gate` explicito. Skill nao silencia o gate.
+- **Sem push automatico**: commit fica preparado. Push e responsabilidade do humano.
+- **State machine inviolavel**: transicao `concluido` so apos humano validar + checklist.
+- **Storybook como contrato**: componente sem `.stories.tsx` em `<dirs.storybook>` bloqueia a task ate ser criado.
+
+## Model guidance
+
+| Escopo | Modelo |
+|--------|--------|
+| Task simples (1 componente, sem novo padrao) | `sonnet` |
+| Task que toca multiplos componentes ou logica de fetching | `opus` |
+| Visual gate / comparacao com Figma | inherit (modelo do agent) |
+
+## Instructions
+
+1. NUNCA pular o pre-flight visual sem flag explicita.
+2. Resolver TODOS os paths via `plan-paths.json`.
+3. Visual gate produz relatorio em `T-NNN-NN.notes.md` mesmo em caso de sucesso.
+4. Status final esperado: todas as tasks em `validacao`, commit preparado, humano notificado.

package/.gos/skills/plan-blueprint/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: plan-blueprint
 description: Cria um plano padronizado para uma tela (1 plano = 1 tela) seguindo a stack-of-record do projeto. Produz {plano, tasks, contexto, entrada-progress.txt} em três fases (Mapeamento → Aderência à stack → Execução). Pré-requisito duro: docs/stack.md existir. Subdivide automaticamente telas com seções autônomas múltiplas.
-argument-hint: "<tela|figma-url|descrição> [--from-figma-mcp] [--allow-arch-change]"
+argument-hint: "<tela> OBJETIVO=<implantacao|correcao|refactor> FIGMA=<url> [FIGMA+=...] [--from-figma-mcp] [--allow-arch-change] [--skip-clickup]"
 allowedTools: [Read, Glob, Grep, Bash, Write, Edit, Agent, AskUserQuestion]
 sourceDocs:
   - templates/planTemplate.md
@@ -25,14 +25,35 @@ Você está executando como **Tech Lead Frontend / Arquiteto Sênior** via skill
 
 $ARGUMENTS
 
-Auto-detecção de input:
-- URL `https://www.figma.com/...` → ativa modo Figma MCP
-- caminho de arquivo `.md`/`.png`/`.jpg` → modo descrição com referência visual
-- texto livre → modo descrição
+Campos obrigatórios no prompt:
+- `OBJETIVO` — `implantacao` | `correcao` | `refactor`
+- `FIGMA` — URL do frame principal (auto-ativa Figma MCP)
+
+Opcionais:
+- `FIGMA+` — lista de URLs de componentes
+- `NOTAS` — prosa livre (comportamento, edge cases, invioláveis)
+- `ASSIGNEE` — override do user_id ClickUp para tasks de backend (default: 112010775)
+
+Auto-resolvido pelo `gos-master` (comprehension gate, NÃO pedir ao usuário):
+- `PROJETO` — `cwd`; ambíguo → `~/.claude/.gos-state/last-project.json`
+- `WORK_BRANCH` — tela em Storybook → `feat/storybook`; senão → `dev`
+- `STORYBOOK_DIR/BRANCH` — `plan-paths.json`
+- `BUSINESS_RULES` — `<PROJETO>/docs/regras-de-negocio/` (indexar e registrar em progress.txt)
+- `POSTMAN` — `<PROJETO>/docs/postman/` (idem)
+- `BACKEND/RLS/SEED/SMOKE_E2E` — derivado de `stack.md` + regras + Postman
+
+OBJETIVO muda postura:
+
+| Valor | Comportamento |
+|-------|---------------|
+| `implantacao` | Cria do zero — Fase 1 → 2 → 3 padrão |
+| `correcao` | Modo cirúrgico — diff vs Storybook canônico, 1 task por componente, sem reescrever |
+| `refactor` | Implica `--allow-arch-change` + ADR obrigatória |
 
 Flags:
-- `--from-figma-mcp` — força leitura via Figma MCP
-- `--allow-arch-change` — libera Fase 2 propositiva (gera ADR)
+- `--from-figma-mcp` — força leitura via Figma MCP (default quando `FIGMA=` é Figma URL)
+- `--allow-arch-change` — libera Fase 2 propositiva (gera ADR); implícito em `OBJETIVO=refactor`
+- `--skip-clickup` — não cria tasks de backend automaticamente
 
 ## Pré-requisitos (gate)
 
@@ -41,6 +62,9 @@ Flags:
    - Se ausente: ABORTAR. Despachar `stack-profiler refresh` e instruir o usuário a re-executar.
    - Se presente: ler integralmente. Verificar drift via `*stack drift` antes de prosseguir.
 3. Ler `progress.txt` se existir (memória L1).
+4. **Verificar `dirs.storybook`** (caminho do `plan-paths.json`):
+   - Se ausente OU diretório não existe: ABORTAR. Pedir caminho ao usuário (path absoluto fora do repo é válido, ex.: `E:\Github\Ganbatte\tmp\fractus-storybook`) e gravar em `plan-paths.json`.
+   - Se presente: indexar `.stories.tsx` disponíveis (lista usada na Fase 1.3).
 
 ## Fase 1 — Mapeamento Visual & Componentização
 
@@ -60,8 +84,10 @@ Caso contrário: trabalhar pela descrição/screenshot fornecido.
 
 Produzir tabela:
 
-| Elemento (Figma/descrição) | Componente do DS | Variant | Props relevantes |
-|----------------------------|------------------|---------|-------------------|
+| Elemento (Figma/descrição) | Componente do DS | Story (path) | Variant | Props relevantes |
+|----------------------------|------------------|--------------|---------|-------------------|
+
+A coluna `Story (path)` aponta para `.stories.tsx` indexado no gate. Componente sem story correspondente NÃO entra na tabela — vai pra "Componentes ausentes" e gera task de criação.
 
 Listar **componentes ausentes** separadamente — sinalizar como bloqueio ou candidato a criação (vai virar task própria).
 
@@ -77,6 +103,22 @@ Saída desta fase é uma seção **"Aderência à Stack"** no plano — não red
 
 **Modo `--allow-arch-change`**: pode propor alteração. Gerar ADR em `dirs.adr` (template `templates/adr-tmpl.yaml`) ANTES de prosseguir. Plano referencia o ADR e marca `arch_change: true` no frontmatter.
 
+### 2.5 Backend gaps → ClickUp automático
+
+Postman é o **contrato backend**. Para cada dado/ação da tela:
+
+1. Confrontar com `<PROJETO>/docs/postman/` (já indexado no comprehension gate).
+2. Se o endpoint não existir, ou existir com shape divergente, ou faltar RLS/migration para suportar a tela → registrar como **backend pending**.
+3. Para cada pending, criar task ClickUp via `mcp__clickup__clickup_create_task`:
+   - **Assignee**: `ASSIGNEE` do prompt OU default `112010775` (Douglas Oliveira).
+   - **List**: `clickup.backend_list_id` de `plan-paths.json`. Ausente → registrar pending no plano com `clickup: pending` e seguir.
+   - **Título**: `[Backend] PLAN-NNN: <gap em uma linha>`
+   - **Descrição**: o que a tela precisa, qual coleção/endpoint do Postman cobre (ou não), referência ao plano (`docs/plans/PLAN-NNN/plan.md`), shape esperado.
+4. Registrar IDs criados em:
+   - `plan.md` → seção `## Backend pendings` (lista com `clickup_id`, status, link).
+   - `progress.txt` → bloco `## Backend pendings — PLAN-NNN`.
+5. Flag `--skip-clickup` desliga a criação (pending fica registrado apenas no plano).
+
 ## Fase 3 — Plano de Execução
 
 Para cada elemento mapeado:
@@ -127,6 +169,7 @@ Próximos passos:
 - **Backend read-only respeitado**: se `stack.md` declara backend read-only, plano NUNCA propõe schema novo.
 - **Next.js App Router**: decisão server vs client é explícita por elemento.
 - **Sem prosa decorativa**: plano deve ser executável, denso, com critérios mensuráveis.
+- **Storybook como contrato**: cada componente do DS na tabela DEVE apontar `.stories.tsx` existente em `dirs.storybook`. Sem story → componente vai pra "Componentes ausentes" e gera task de criação. Sem essa disciplina, o visual gate do `*execute-plan` quebra.
 
 ## Model guidance
 
@@ -139,6 +182,7 @@ Próximos passos:
 ## Instructions
 
 1. NUNCA prosseguir sem `stack.md` válido.
-2. Resolver TODOS os paths via `plan-paths.json`.
+2. Resolver TODOS os paths via `plan-paths.json`. PROJETO/WORK_BRANCH são auto-resolvidos pelo `gos-master` — não perguntar ao usuário.
 3. Status inicial do plano e tasks: `pendente`.
 4. Não pushar nada — apenas escrever arquivos locais.
+5. Backend pendings só criam tasks ClickUp se o `mcp__clickup__*` estiver disponível na sessão E `--skip-clickup` não for passado. Caso contrário, registrar apenas no plano.

package/.gos/skills/registry.json

@@ -22,6 +22,7 @@
     { "slug": "slack-review", "path": "skills/slack-review/SKILL.md" },
     { "slug": "stack-profiler", "path": "skills/stack-profiler/SKILL.md" },
     { "slug": "plan-blueprint", "path": "skills/plan-blueprint/SKILL.md" },
-    { "slug": "progress-tracker", "path": "skills/progress-tracker/SKILL.md" }
+    { "slug": "progress-tracker", "path": "skills/progress-tracker/SKILL.md" },
+    { "slug": "execute-plan", "path": "skills/execute-plan/SKILL.md" }
   ]
 }

package/.gos/templates/planTemplate.md

@@ -1,12 +1,14 @@
 ---
 id: PLAN-<NNN>-<slug>
 tela: <nome da tela>
+objetivo: <implantacao | correcao | refactor>
 figma_url: <url ou null>
 status: pendente
 parent_plan: <PLAN-NNN ou null>
 children_plans: []
 stack_ref: docs/stack.md@<sha-curto>
 arch_change: false
+work_branch: <dev | feat/storybook>
 created_at: <iso>
 validated_at: null
 ---
@@ -19,9 +21,9 @@ validated_at: null
 
 ## Componentes mapeados
 
-| Elemento | Componente do DS | Variant | Props |
-|----------|------------------|---------|-------|
-|          |                  |         |       |
+| Elemento | Componente do DS | Story (path) | Variant | Props |
+|----------|------------------|--------------|---------|-------|
+|          |                  |              |         |       |
 
 ## Componentes ausentes
 
@@ -68,9 +70,28 @@ validated_at: null
 - [ ] Sem console errors/warnings
 - [ ] TypeScript válido (`tsc --noEmit`)
 - [ ] Reutilização ≥ X% de componentes do DS
+- [ ] **Visual gate**: cada componente mapeado tem story em `dirs.stories/`
+- [ ] **Visual gate**: anatomia, tokens e densidade batem com a story canônica (≤ 1 desvio menor documentado em `T-NNN-NN.notes.md`)
+- [ ] **Visual gate**: árvore JSX da tela espelha hierarquia do Figma (mesmas seções, mesma ordem)
 - [ ] <critério específico da tela 1>
 - [ ] <critério específico da tela 2>
 
+## Backend pendings
+
+> 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.
+
+| Gap | Endpoint/Coleção esperada | ClickUp ID | Status |
+|-----|---------------------------|------------|--------|
+|     |                           |            |        |
+
+## Knowledge mapped
+
+> Inventário denso do que foi indexado no comprehension gate (regras-de-negocio + Postman).
+
+- **Regras de negócio**: `<lista de arquivos relevantes em docs/regras-de-negocio/>`
+- **Postman**: `<lista de coleções/endpoints relevantes em docs/postman/>`
+- **Stack ref**: `<sha de stack.md>`
+
 ## Riscos & Rollback
 
 - <risco>

package/.gos/templates/taskTemplate.md

@@ -30,6 +30,7 @@ links: []
 ## Critérios de aceitação (DoD)
 
 - [ ] Implementação atende `valida_em` do plano
+- [ ] **Visual gate aprovado** (relatório em `T-NNN-NN.notes.md` com 4 seções: anatomia, tokens, variants, densidade)
 - [ ] Tests/CI verdes
 - [ ] Sem regressões
 - [ ] <métrica específica>

package/CLAUDE.md

@@ -48,17 +48,21 @@ Todo texto gerado deve passar por correcao ortografica e remocao de padroes de I
 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 | stack-profiler | plan-blueprint | progress-tracker
+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 | stack-profiler | plan-blueprint | progress-tracker | execute-plan
+
+### IDEs suportadas (npm run sync:ides gera adapters)
+Claude Code | Cursor | Gemini CLI | Qwen Code | Antigravity | Opencode | Kilo Code | **Codex IDE Extension** (ambiente de execucao, comando primario `*execute-plan`)
 
 ## Plan Pipeline (stack-aware)
 
-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.
+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**.
 
-| Comando | Skill | Funcao |
-|---------|-------|--------|
-| `*stack [refresh|show|drift]` | `stack-profiler` | Mantem `docs/stack.md` (canonico do projeto) |
-| `*plan <tela>` | `plan-blueprint` | Cria plano + tasks + context + atualiza `progress.txt` |
-| `*progress [show|set|status]` | `progress-tracker` | Memoria L1 + state machine de status |
+| Comando | Skill | IDE / Modelo | Funcao |
+|---------|-------|--------------|--------|
+| `*stack [refresh|show|drift]` | `stack-profiler` | qualquer | Mantem `docs/stack.md` (canonico do projeto) |
+| `*plan <tela>` | `plan-blueprint` | Opus 4.7 (planejador) | Cria plano + tasks + context + atualiza `progress.txt` |
+| `*execute-plan <PLAN-NNN>` | `execute-plan` | **Codex IDE Extension** (executor) | Executa task-a-task com visual gate vs Storybook canonico |
+| `*progress [show|set|status]` | `progress-tracker` | qualquer | Memoria L1 + state machine de status |
 
 State machine: `pendente -> em-andamento -> validacao -> concluido` (concluido somente apos validacao humana).
 

package/package.json

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