ganbatte-os 0.2.32 → 0.2.34

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.
@@ -93,6 +93,11 @@ comprehension_gate:
93
93
  protocol:
94
94
  step_0_scan: "Read relevant files, docs, recent commits related to the request"
95
95
  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."
96
+ 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."
97
+ 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."
98
+ step_0_57_branch: "Auto-resolve WORK_BRANCH: tela bate com dirs.storybook → feat/storybook; senão → dev. Não pedir ao usuário."
99
+ 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)."
100
+ 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."
96
101
  step_0_6_progress: "If progress.txt exists at the configured path: read it for active plan/task context (memória L1)."
97
102
  step_1_document: "State what exists (current state, patterns, constraints) in factual terms"
98
103
  step_2_assess: "Determine which agent/skill/workflow is appropriate based on evidence, not assumption"
@@ -199,13 +204,28 @@ routing_matrix:
199
204
  triggers: [plan, plano, screen plan, tela, criar plano, blueprint, plano de tela]
200
205
  target: skill:plan-blueprint
201
206
  pre_action: Validate docs/stack.md exists; if not, dispatch stack-profiler first
202
- notes: 1 tela = 1 plano. Subdivide automaticamente quando há múltiplas seções autônomas
207
+ notes: |
208
+ 1 tela = 1 plano. OBJETIVO obrigatório no prompt:
209
+ - implantacao → criar do zero (fluxo padrão)
210
+ - correcao → cirúrgico, diff vs Storybook, 1 task por componente
211
+ - refactor → implica --allow-arch-change + ADR
212
+ Auto-resolve PROJETO/WORK_BRANCH/BUSINESS_RULES/POSTMAN no comprehension gate.
213
+ Backend gaps → tasks ClickUp automáticas pro Douglas (--skip-clickup desliga).
203
214
 
204
215
  progress_tracking:
205
216
  triggers: [progress, status, progress.txt, memoria curta, l1]
206
217
  target: skill:progress-tracker
207
218
  notes: State machine pendente → em-andamento → validacao → concluido
208
219
 
220
+ execute_plan:
221
+ triggers: [execute, executar plano, run plan, "*execute-plan", execute plan, executar PLAN]
222
+ target: skill:execute-plan
223
+ pre_action: Validate PLAN-NNN-<slug>/plan.md exists; load stack.md; index dirs.storybook stories
224
+ notes: |
225
+ Comando primário do ambiente Codex IDE Extension.
226
+ Ciclo Opus(plan) → Codex(execute). Roda task-a-task com state machine
227
+ e visual gate obrigatório contra Storybook canônico antes de validacao.
228
+
209
229
  product_decisions:
210
230
  triggers: [PRD, requirements, product decision, scope, feature priority]
211
231
  target: agent:po
@@ -292,6 +312,9 @@ commands:
292
312
  - name: progress
293
313
  args: "[init|show|set <plan>|status <task> <novo-status>|compact|read]"
294
314
  description: Gerencia progress.txt (memória L1) e state machine de status
315
+ - name: execute-plan
316
+ args: "<PLAN-NNN-slug> [--task T-NNN-NN] [--skip-visual-gate]"
317
+ description: Executa plano task-a-task com visual gate obrigatório (comando primário do Codex IDE)
295
318
 
296
319
  # Quality
297
320
  - name: check
@@ -328,7 +351,7 @@ available_squads:
328
351
  - name: git-operations
329
352
  purpose: SSH setup, quality gate, safe commit+push
330
353
 
331
- # ─── AVAILABLE SKILLS (18) ────────────────────────────────────
354
+ # ─── AVAILABLE SKILLS (19) ────────────────────────────────────
332
355
  available_skills:
333
356
  - design-to-code
334
357
  - figma-implement-design
@@ -348,6 +371,7 @@ available_skills:
348
371
  - stack-profiler
349
372
  - plan-blueprint
350
373
  - progress-tracker
374
+ - execute-plan
351
375
 
352
376
  # ─── PLAYBOOKS ────────────────────────────────────────────────
353
377
  available_playbooks:
@@ -449,7 +473,8 @@ security:
449
473
  **Plan pipeline (stack-aware):**
450
474
 
451
475
  - `*stack [refresh|show|drift]` - Mantém docs/stack.md
452
- - `*plan <tela|figma-url|descrição>` - Cria plano por tela
476
+ - `*plan <tela|figma-url|descrição>` - Cria plano por tela (Opus, planejamento)
477
+ - `*execute-plan <PLAN-NNN-slug>` - Executa plano com visual gate (Codex IDE, execução)
453
478
  - `*progress [show|set|status|compact]` - Gerencia progress.txt (L1)
454
479
 
455
480
  **Framework:**
@@ -13,7 +13,7 @@
13
13
  "antigravity": { "workspaceDir": ".antigravity", "skillsDir": ".antigravity/skills", "adapter": "integrations/antigravity", "status": "active" },
14
14
  "gemini-cli": { "workspaceDir": ".gemini", "contextFile": "GEMINI.md", "status": "active" },
15
15
  "cursor": { "workspaceDir": ".cursor", "ruleFile": ".cursor/rules/g-os.mdc", "status": "active" },
16
- "codex": { "workspaceDir": ".codex", "skillsDir": ".agents/skills", "adapter": "integrations/codex", "status": "active" },
16
+ "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" },
17
17
  "opencode": { "workspaceDir": ".opencode", "adapter": "integrations/opencode", "status": "active" },
18
18
  "kilo-code": { "workspaceDir": ".kilocode", "ruleFile": ".kilocode/rules/g-os.md", "status": "active" },
19
19
  "qwen-code": { "workspaceDir": ".qwen", "skillsDir": ".qwen/skills", "commandsDir": ".qwen/commands/gos", "agentsDir": ".qwen/agents", "adapter": "integrations/qwen", "status": "active" }
@@ -39,19 +39,31 @@ Se houver drift, decidir entre:
39
39
  ### 2. Criar plano
40
40
 
41
41
  ```
42
- *plan <tela|figma-url|descrição>
42
+ *plan <tela>
43
+
44
+ OBJETIVO = implantacao | correcao | refactor # obrigatório
45
+ FIGMA = <url-frame>
46
+ FIGMA+ = [<url-comp>, ...] # opcional
47
+ NOTAS = """<prosa livre>""" # opcional
48
+ ASSIGNEE = <user-id> # opcional, default 112010775 (Douglas)
43
49
  ```
44
50
 
51
+ `gos-master` resolve no comprehension gate (não pedir ao usuário):
52
+ - `PROJETO` (cwd, ou `~/.claude/.gos-state/last-project.json`)
53
+ - `WORK_BRANCH` (`dev` para app, `feat/storybook` quando em Storybook)
54
+ - Indexação de `<PROJETO>/docs/regras-de-negocio/` e `docs/postman/` (registrada em `progress.txt`)
55
+
45
56
  `plan-blueprint` executa:
46
57
  1. Fase 1 — Mapeamento Visual & Componentização
47
58
  2. Fase 2 — Aderência à Stack (sem redefinir arquitetura)
59
+ 2.5 Fase 2.5 — Backend gaps → criar tasks ClickUp pro Douglas (`--skip-clickup` desliga)
48
60
  3. Fase 3 — Plano de Execução
49
61
 
50
62
  Saídas:
51
- - `<dirs.planos>/PLAN-NNN-<slug>/plan.md`
63
+ - `<dirs.planos>/PLAN-NNN-<slug>/plan.md` (com seções `## Backend pendings` e `## Knowledge mapped`)
52
64
  - `<dirs.planos>/PLAN-NNN-<slug>/context.md`
53
65
  - `<dirs.planos>/PLAN-NNN-<slug>/tasks/T-NNN-NN-*.md`
54
- - `progress.txt` atualizado com plano ativo
66
+ - `progress.txt` atualizado com plano ativo + inventário de knowledge + backend pendings
55
67
 
56
68
  ### 3. Revisar e aceitar
57
69
 
@@ -62,19 +74,29 @@ Humano revisa:
62
74
 
63
75
  Se aprovado, prosseguir. Caso contrário: ajustar manualmente ou rerodar `*plan` com refinamento.
64
76
 
65
- ### 4. Executar tasks
66
-
67
- Para cada task, dev (humano ou LLM):
77
+ ### 3.5. Pre-flight visual (antes de executar)
68
78
 
69
79
  ```
70
- *progress status T-NNN-NN em-andamento
80
+ *execute-plan PLAN-NNN-<slug>
71
81
  ```
72
82
 
73
- Implementa, commita localmente (sem push), atualiza:
83
+ 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.
74
84
 
75
- ```
76
- *progress status T-NNN-NN validacao
77
- ```
85
+ > 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`.
86
+
87
+ ### 4. Executar tasks (orquestrado por execute-plan)
88
+
89
+ `execute-plan` itera as tasks em ordem de `seq`:
90
+
91
+ 1. `*progress status T-NNN-NN em-andamento` (state machine).
92
+ 2. Despacha agent (`labels: [agent:<slug>]`, default `dev`) para implementar.
93
+ 3. **Visual gate** antes de marcar `validacao`:
94
+ - Compara cada componente alterado com `<Componente>.stories.tsx` em 4 dimensões (anatomia, tokens, variants, densidade).
95
+ - Cruza JSX da tela com Figma MCP (árvore vs hierarquia).
96
+ - Falha → task volta a `em-andamento` com diff em `tasks/T-NNN-NN.notes.md`.
97
+ 4. Sucesso → `*progress status T-NNN-NN validacao`.
98
+
99
+ Para rodar uma task específica fora do loop: `*execute-plan PLAN-NNN-<slug> --task T-NNN-NN`.
78
100
 
79
101
  ### 5. Validação
80
102
 
@@ -116,7 +138,8 @@ Validação humana + QA. Se aprovado:
116
138
  ## Skills relacionadas
117
139
 
118
140
  - `stack-profiler` — produz/mantém `stack.md`
119
- - `plan-blueprint` — cria plano por tela
141
+ - `plan-blueprint` — cria plano por tela (Opus, planejamento)
120
142
  - `plan-to-tasks` — decompõe plano em tasks (chamada automaticamente)
143
+ - `execute-plan` — executa plano com visual gate (Codex IDE, execução)
121
144
  - `progress-tracker` — gerencia `progress.txt`
122
145
  - `clickup` — sync opcional para tracking externo (não obrigatório)