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.
- package/.gos/agents/profiles/ganbatte-os-master.md +28 -3
- package/.gos/integrations/registry.json +1 -1
- package/.gos/playbooks/plan-creation-playbook.md +35 -12
- package/.gos/scripts/cli/gos-cli.js +382 -40
- package/.gos/scripts/integrations/setup-ide-adapters.js +103 -1
- package/.gos/skills/execute-plan/SKILL.md +117 -0
- package/.gos/skills/plan-blueprint/SKILL.md +54 -10
- package/.gos/skills/registry.json +2 -1
- package/.gos/templates/planTemplate.md +24 -3
- package/.gos/templates/taskTemplate.md +1 -0
- package/CLAUDE.md +11 -7
- package/README.md +124 -25
- package/package.json +2 -1
|
@@ -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:
|
|
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 (
|
|
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": ".
|
|
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
|
|
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
|
-
###
|
|
66
|
-
|
|
67
|
-
Para cada task, dev (humano ou LLM):
|
|
77
|
+
### 3.5. Pre-flight visual (antes de executar)
|
|
68
78
|
|
|
69
79
|
```
|
|
70
|
-
*
|
|
80
|
+
*execute-plan PLAN-NNN-<slug>
|
|
71
81
|
```
|
|
72
82
|
|
|
73
|
-
|
|
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
|
-
|
|
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)
|