@luanpdd/kit-mcp 1.32.0 → 1.34.0
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/LICENSE +21 -21
- package/README.md +168 -168
- package/gates/agent-no-recursive-dispatch.md +84 -84
- package/kit/COMANDOS.md +138 -138
- package/kit/COMPATIBILITY.md +70 -70
- package/kit/README.md +76 -76
- package/kit/agents/advisor-researcher.md +109 -109
- package/kit/agents/ai-mutation-tester.md +289 -289
- package/kit/agents/assumptions-analyzer.md +110 -110
- package/kit/agents/audit-log-implementer.md +314 -314
- package/kit/agents/auditor-consistencia-isolamento.md +414 -414
- package/kit/agents/b2b-saas-architect.md +157 -157
- package/kit/agents/burn-rate-forecaster.md +153 -153
- package/kit/agents/cascading-failures-auditor.md +299 -299
- package/kit/agents/codebase-mapper.md +769 -769
- package/kit/agents/crm-pipeline-implementer.md +257 -257
- package/kit/agents/debugger.md +814 -814
- package/kit/agents/designer-ui.md +216 -0
- package/kit/agents/detector-tenant-quente.md +338 -338
- package/kit/agents/evolution-go-integrator.md +201 -201
- package/kit/agents/example-reviewer.md +22 -22
- package/kit/agents/executor.md +565 -565
- package/kit/agents/golden-signals-instrumenter.md +232 -232
- package/kit/agents/incident-investigator.md +238 -238
- package/kit/agents/integration-checker.md +203 -203
- package/kit/agents/invite-flow-implementer.md +190 -190
- package/kit/agents/legacy-characterizer.md +369 -369
- package/kit/agents/lgpd-compliance-auditor.md +296 -296
- package/kit/agents/load-shedding-instrumenter.md +290 -290
- package/kit/agents/multi-tenant-isolation-auditor.md +254 -254
- package/kit/agents/multi-tenant-rls-writer.md +341 -341
- package/kit/agents/nyquist-auditor.md +181 -181
- package/kit/agents/observability-coverage-auditor.md +316 -316
- package/kit/agents/observability-instrumenter.md +191 -191
- package/kit/agents/omm-auditor.md +291 -291
- package/kit/agents/org-onboarding-implementer.md +224 -224
- package/kit/agents/payload-capture-instrumenter.md +274 -274
- package/kit/agents/phase-researcher.md +697 -697
- package/kit/agents/plan-checker.md +275 -275
- package/kit/agents/planner.md +923 -923
- package/kit/agents/postmortem-writer.md +273 -273
- package/kit/agents/project-researcher.md +653 -653
- package/kit/agents/prr-conductor.md +287 -287
- package/kit/agents/refactor-safety-auditor.md +405 -405
- package/kit/agents/release-pipeline-auditor.md +364 -364
- package/kit/agents/research-synthesizer.md +246 -246
- package/kit/agents/roadmapper.md +678 -678
- package/kit/agents/schema-checker.md +160 -160
- package/kit/agents/seam-finder.md +360 -360
- package/kit/agents/shotgun-surgery-detector.md +350 -350
- package/kit/agents/slo-engineer.md +217 -217
- package/kit/agents/storytelling-analyst.md +300 -300
- package/kit/agents/supabase-architect.md +249 -249
- package/kit/agents/supabase-auth-bootstrapper.md +400 -400
- package/kit/agents/supabase-auth-hook-writer.md +418 -418
- package/kit/agents/supabase-branching-architect.md +563 -563
- package/kit/agents/supabase-cicd-pipeline-implementer.md +778 -778
- package/kit/agents/supabase-column-privileges-writer.md +400 -400
- package/kit/agents/supabase-edge-fn-tester.md +288 -288
- package/kit/agents/supabase-edge-fn-writer.md +341 -341
- package/kit/agents/supabase-mfa-implementer.md +439 -439
- package/kit/agents/supabase-migration-writer.md +386 -386
- package/kit/agents/supabase-oauth-server-implementer.md +507 -507
- package/kit/agents/supabase-rbac-implementer.md +393 -393
- package/kit/agents/supabase-realtime-implementer.md +364 -364
- package/kit/agents/supabase-rls-hardener.md +522 -522
- package/kit/agents/supabase-rls-writer.md +324 -324
- package/kit/agents/supabase-roles-implementer.md +356 -356
- package/kit/agents/supabase-social-auth-implementer.md +451 -451
- package/kit/agents/supabase-sso-saml-architect.md +549 -549
- package/kit/agents/supabase-storage-implementer.md +407 -407
- package/kit/agents/super-admin-implementer.md +282 -282
- package/kit/agents/toil-auditor.md +268 -268
- package/kit/agents/ui-auditor.md +438 -438
- package/kit/agents/ui-checker.md +305 -305
- package/kit/agents/ui-researcher.md +356 -356
- package/kit/agents/user-profiler.md +176 -176
- package/kit/agents/validador-evolucao-schema.md +336 -336
- package/kit/agents/verifier.md +729 -729
- package/kit/commands/adicionar-backlog.md +75 -75
- package/kit/commands/adicionar-fase.md +42 -42
- package/kit/commands/adicionar-tarefa.md +45 -45
- package/kit/commands/adicionar-testes.md +41 -41
- package/kit/commands/ajuda.md +21 -21
- package/kit/commands/atualizar.md +37 -37
- package/kit/commands/auditar-cascading.md +111 -111
- package/kit/commands/auditar-marco.md +179 -179
- package/kit/commands/auditar-observabilidade-cobertura-workflow.md +121 -0
- package/kit/commands/auditar-observabilidade-cobertura.md +183 -183
- package/kit/commands/auditar-refactor.md +219 -219
- package/kit/commands/auditar-release.md +109 -109
- package/kit/commands/auditar-uat.md +23 -23
- package/kit/commands/autonomo.md +40 -40
- package/kit/commands/branch-pr.md +24 -24
- package/kit/commands/burn-rate-status.md +408 -408
- package/kit/commands/capturar-payloads.md +193 -193
- package/kit/commands/caracterizar.md +212 -212
- package/kit/commands/concluir-marco.md +247 -247
- package/kit/commands/configuracoes.md +36 -36
- package/kit/commands/dados-distribuidos.md +188 -188
- package/kit/commands/definir-perfil.md +10 -10
- package/kit/commands/depurar.md +190 -190
- package/kit/commands/detectar-duplicacao.md +197 -197
- package/kit/commands/discutir-fase.md +131 -131
- package/kit/commands/encontrar-seams.md +136 -136
- package/kit/commands/entrar-discord.md +17 -17
- package/kit/commands/estatisticas.md +18 -18
- package/kit/commands/example-greeting.md +33 -33
- package/kit/commands/executar-fase.md +58 -58
- package/kit/commands/expresso.md +56 -56
- package/kit/commands/fase-ui.md +34 -34
- package/kit/commands/fazer.md +57 -57
- package/kit/commands/fio.md +125 -125
- package/kit/commands/fluxos-trabalho.md +64 -64
- package/kit/commands/forense.md +176 -176
- package/kit/commands/gerenciador.md +38 -38
- package/kit/commands/inserir-fase.md +31 -31
- package/kit/commands/legacy.md +263 -263
- package/kit/commands/limpeza.md +17 -17
- package/kit/commands/listar-hipoteses-fase.md +45 -45
- package/kit/commands/listar-workspaces.md +18 -18
- package/kit/commands/load-shedding.md +117 -117
- package/kit/commands/mapear-codebase.md +70 -70
- package/kit/commands/multi-tenant.md +163 -163
- package/kit/commands/nota.md +33 -33
- package/kit/commands/novo-marco.md +43 -43
- package/kit/commands/novo-projeto.md +41 -41
- package/kit/commands/novo-workspace.md +43 -43
- package/kit/commands/pausar-trabalho.md +37 -37
- package/kit/commands/perfil-usuario.md +45 -45
- package/kit/commands/pesquisar-fase.md +195 -195
- package/kit/commands/planejar-fase.md +67 -67
- package/kit/commands/planejar-lacunas.md +33 -33
- package/kit/commands/plantar-ideia.md +25 -25
- package/kit/commands/progresso.md +24 -24
- package/kit/commands/proximo.md +30 -30
- package/kit/commands/publicar.md +490 -490
- package/kit/commands/rapido.md +35 -35
- package/kit/commands/reaplicar-patches.md +124 -124
- package/kit/commands/refactor-seguro.md +321 -321
- package/kit/commands/relatorio-sessao.md +19 -19
- package/kit/commands/remover-fase.md +31 -31
- package/kit/commands/remover-workspace.md +26 -26
- package/kit/commands/resumo-marco.md +50 -50
- package/kit/commands/retomar-trabalho.md +40 -40
- package/kit/commands/revisar-backlog.md +60 -60
- package/kit/commands/revisar-ui.md +32 -32
- package/kit/commands/revisar.md +37 -37
- package/kit/commands/saude.md +21 -21
- package/kit/commands/setup-notion.md +93 -93
- package/kit/commands/storytelling.md +179 -179
- package/kit/commands/supabase.md +238 -238
- package/kit/commands/sync-main.md +68 -68
- package/kit/commands/validar-fase.md +35 -35
- package/kit/commands/verificar-tarefas.md +44 -44
- package/kit/commands/verificar-trabalho.md +64 -64
- package/kit/file-manifest.json +13 -3
- package/kit/framework/bin/lib/commands.cjs +959 -959
- package/kit/framework/bin/lib/config.cjs +442 -442
- package/kit/framework/bin/lib/core.cjs +1230 -1230
- package/kit/framework/bin/lib/frontmatter.cjs +336 -336
- package/kit/framework/bin/lib/init.cjs +1442 -1442
- package/kit/framework/bin/lib/milestone.cjs +252 -252
- package/kit/framework/bin/lib/model-profiles.cjs +68 -68
- package/kit/framework/bin/lib/phase.cjs +888 -888
- package/kit/framework/bin/lib/profile-output.cjs +952 -952
- package/kit/framework/bin/lib/profile-pipeline.cjs +539 -539
- package/kit/framework/bin/lib/roadmap.cjs +329 -329
- package/kit/framework/bin/lib/security.cjs +382 -382
- package/kit/framework/bin/lib/state.cjs +1031 -1031
- package/kit/framework/bin/lib/template.cjs +222 -222
- package/kit/framework/bin/lib/uat.cjs +282 -282
- package/kit/framework/bin/lib/verify.cjs +888 -888
- package/kit/framework/bin/lib/workstream.cjs +491 -491
- package/kit/framework/bin/tools.cjs +918 -918
- package/kit/framework/commands/workstreams.md +63 -63
- package/kit/framework/references/checkpoints.md +778 -778
- package/kit/framework/references/continuation-format.md +249 -249
- package/kit/framework/references/decimal-phase-calculation.md +64 -64
- package/kit/framework/references/git-integration.md +295 -295
- package/kit/framework/references/git-planning-commit.md +38 -38
- package/kit/framework/references/model-profile-resolution.md +36 -36
- package/kit/framework/references/model-profiles.md +139 -139
- package/kit/framework/references/phase-argument-parsing.md +61 -61
- package/kit/framework/references/planning-config.md +202 -202
- package/kit/framework/references/questioning.md +162 -162
- package/kit/framework/references/tdd.md +263 -263
- package/kit/framework/references/ui-brand.md +160 -160
- package/kit/framework/references/user-profiling.md +657 -657
- package/kit/framework/references/verification-patterns.md +612 -612
- package/kit/framework/references/workstream-flag.md +58 -58
- package/kit/framework/templates/DEBUG.md +164 -164
- package/kit/framework/templates/UAT.md +265 -265
- package/kit/framework/templates/UI-SPEC.md +100 -100
- package/kit/framework/templates/VALIDATION.md +76 -76
- package/kit/framework/templates/claude-md.md +122 -122
- package/kit/framework/templates/codebase/architecture.md +185 -185
- package/kit/framework/templates/codebase/concerns.md +205 -205
- package/kit/framework/templates/codebase/conventions.md +204 -204
- package/kit/framework/templates/codebase/integrations.md +192 -192
- package/kit/framework/templates/codebase/stack.md +158 -158
- package/kit/framework/templates/codebase/structure.md +199 -199
- package/kit/framework/templates/codebase/testing.md +301 -301
- package/kit/framework/templates/config.json +44 -44
- package/kit/framework/templates/context.md +352 -352
- package/kit/framework/templates/continue-here.md +78 -78
- package/kit/framework/templates/copilot-instructions.md +7 -7
- package/kit/framework/templates/debug-subagent-prompt.md +91 -91
- package/kit/framework/templates/dev-preferences.md +20 -20
- package/kit/framework/templates/discovery.md +146 -146
- package/kit/framework/templates/discussion-log.md +63 -63
- package/kit/framework/templates/milestone-archive.md +123 -123
- package/kit/framework/templates/milestone.md +115 -115
- package/kit/framework/templates/phase-prompt.md +610 -610
- package/kit/framework/templates/planner-subagent-prompt.md +117 -117
- package/kit/framework/templates/project.md +186 -186
- package/kit/framework/templates/requirements.md +231 -231
- package/kit/framework/templates/research-project/ARCHITECTURE.md +204 -204
- package/kit/framework/templates/research-project/FEATURES.md +147 -147
- package/kit/framework/templates/research-project/PITFALLS.md +200 -200
- package/kit/framework/templates/research-project/STACK.md +120 -120
- package/kit/framework/templates/research-project/SUMMARY.md +170 -170
- package/kit/framework/templates/research.md +419 -419
- package/kit/framework/templates/retrospective.md +54 -54
- package/kit/framework/templates/roadmap.md +202 -202
- package/kit/framework/templates/state.md +176 -176
- package/kit/framework/templates/summary-complex.md +59 -59
- package/kit/framework/templates/summary-minimal.md +41 -41
- package/kit/framework/templates/summary-standard.md +48 -48
- package/kit/framework/templates/summary.md +209 -209
- package/kit/framework/templates/user-profile.md +146 -146
- package/kit/framework/templates/user-setup.md +256 -256
- package/kit/framework/templates/verification-report.md +258 -258
- package/kit/framework/workflows/add-phase.md +112 -112
- package/kit/framework/workflows/add-tests.md +351 -351
- package/kit/framework/workflows/add-todo.md +158 -158
- package/kit/framework/workflows/audit-milestone.md +340 -340
- package/kit/framework/workflows/audit-uat.md +109 -109
- package/kit/framework/workflows/autonomous.md +891 -891
- package/kit/framework/workflows/check-todos.md +177 -177
- package/kit/framework/workflows/cleanup.md +152 -152
- package/kit/framework/workflows/complete-milestone.md +696 -696
- package/kit/framework/workflows/diagnose-issues.md +231 -231
- package/kit/framework/workflows/discovery-phase.md +289 -289
- package/kit/framework/workflows/discuss-phase-assumptions.md +653 -653
- package/kit/framework/workflows/discuss-phase.md +784 -784
- package/kit/framework/workflows/do.md +104 -104
- package/kit/framework/workflows/execute-phase.md +838 -838
- package/kit/framework/workflows/execute-plan.md +510 -510
- package/kit/framework/workflows/fast.md +102 -102
- package/kit/framework/workflows/forensics.md +265 -265
- package/kit/framework/workflows/health.md +181 -181
- package/kit/framework/workflows/help.md +619 -619
- package/kit/framework/workflows/insert-phase.md +130 -130
- package/kit/framework/workflows/list-phase-assumptions.md +178 -178
- package/kit/framework/workflows/list-workspaces.md +56 -56
- package/kit/framework/workflows/manager.md +362 -362
- package/kit/framework/workflows/map-codebase.md +377 -377
- package/kit/framework/workflows/milestone-summary.md +223 -223
- package/kit/framework/workflows/new-milestone.md +486 -486
- package/kit/framework/workflows/new-project.md +1159 -1159
- package/kit/framework/workflows/new-workspace.md +237 -237
- package/kit/framework/workflows/next.md +97 -97
- package/kit/framework/workflows/node-repair.md +92 -92
- package/kit/framework/workflows/note.md +156 -156
- package/kit/framework/workflows/pause-work.md +176 -176
- package/kit/framework/workflows/plan-milestone-gaps.md +273 -273
- package/kit/framework/workflows/plan-phase.md +765 -765
- package/kit/framework/workflows/plant-seed.md +169 -169
- package/kit/framework/workflows/pr-branch.md +129 -129
- package/kit/framework/workflows/profile-user.md +450 -450
- package/kit/framework/workflows/progress.md +507 -507
- package/kit/framework/workflows/quick.md +757 -757
- package/kit/framework/workflows/remove-phase.md +155 -155
- package/kit/framework/workflows/remove-workspace.md +90 -90
- package/kit/framework/workflows/research-phase.md +82 -82
- package/kit/framework/workflows/resume-project.md +326 -326
- package/kit/framework/workflows/review.md +228 -228
- package/kit/framework/workflows/session-report.md +146 -146
- package/kit/framework/workflows/settings.md +283 -283
- package/kit/framework/workflows/ship.md +228 -228
- package/kit/framework/workflows/stats.md +60 -60
- package/kit/framework/workflows/transition.md +671 -671
- package/kit/framework/workflows/ui-phase.md +302 -302
- package/kit/framework/workflows/ui-review.md +165 -165
- package/kit/framework/workflows/update.md +323 -323
- package/kit/framework/workflows/validate-phase.md +174 -174
- package/kit/framework/workflows/verify-phase.md +252 -252
- package/kit/framework/workflows/verify-work.md +637 -637
- package/kit/hooks/check-update.js +118 -118
- package/kit/hooks/context-monitor.js +163 -163
- package/kit/hooks/kit-attribution-reminder.cjs +92 -92
- package/kit/hooks/kit-router.cjs +137 -137
- package/kit/hooks/prompt-guard.js +103 -103
- package/kit/hooks/statusline.js +125 -125
- package/kit/hooks/workflow-guard.js +101 -101
- package/kit/settings.json +45 -45
- package/kit/skills/ai-prompt-characterization/SKILL.md +335 -335
- package/kit/skills/armadilhas-sistemas-distribuidos/SKILL.md +447 -447
- package/kit/skills/audit-log-multi-tenant/SKILL.md +340 -340
- package/kit/skills/b2b-saas-architecture/SKILL.md +300 -300
- package/kit/skills/consistencia-leitura-replica/SKILL.md +385 -385
- package/kit/skills/crm-lead-pipeline-patterns/SKILL.md +343 -343
- package/kit/skills/escolha-modelo-consistencia/SKILL.md +494 -494
- package/kit/skills/evolucao-schema-compativel/SKILL.md +448 -448
- package/kit/skills/evolution-go-whatsapp-integration/SKILL.md +322 -322
- package/kit/skills/example-skill/SKILL.md +42 -42
- package/kit/skills/legacy-api-only-applications/SKILL.md +358 -358
- package/kit/skills/legacy-characterization-tests/SKILL.md +330 -330
- package/kit/skills/legacy-effect-analysis/SKILL.md +331 -331
- package/kit/skills/legacy-extract-class/SKILL.md +203 -203
- package/kit/skills/legacy-programming-by-difference/SKILL.md +252 -252
- package/kit/skills/legacy-seams-and-test-harness/SKILL.md +460 -460
- package/kit/skills/legacy-shotgun-surgery/SKILL.md +286 -286
- package/kit/skills/legacy-sprout-wrap-techniques/SKILL.md +434 -434
- package/kit/skills/legacy-storytelling-naked-crc/SKILL.md +270 -270
- package/kit/skills/lgpd-multi-tenant-compliance/SKILL.md +340 -340
- package/kit/skills/member-invite-flow/SKILL.md +305 -305
- package/kit/skills/member-management-react-shadcn/SKILL.md +328 -328
- package/kit/skills/multi-tenant-performance-scaling/SKILL.md +316 -316
- package/kit/skills/multi-tenant-rls-hierarchy/SKILL.md +342 -342
- package/kit/skills/org-onboarding-flow/SKILL.md +257 -257
- package/kit/skills/org-switcher-react-pattern/SKILL.md +349 -349
- package/kit/skills/permission-gate-react-pattern/SKILL.md +271 -271
- package/kit/skills/postgres-isolamento-concorrencia/SKILL.md +552 -552
- package/kit/skills/pre-refactor-characterization/SKILL.md +421 -421
- package/kit/skills/rbac-permissions-matrix-supabase/SKILL.md +338 -338
- package/kit/skills/streams-eventos-cdc/SKILL.md +711 -711
- package/kit/skills/supabase-auth-hardening/SKILL.md +674 -674
- package/kit/skills/supabase-auth-hooks/SKILL.md +875 -875
- package/kit/skills/supabase-auth-methods/SKILL.md +486 -486
- package/kit/skills/supabase-auth-sessions/SKILL.md +579 -579
- package/kit/skills/supabase-auth-ssr/SKILL.md +306 -306
- package/kit/skills/supabase-branching-workflow/SKILL.md +544 -544
- package/kit/skills/supabase-ci-cd-github-actions/SKILL.md +880 -880
- package/kit/skills/supabase-column-level-security/SKILL.md +426 -426
- package/kit/skills/supabase-config-toml-remotes/SKILL.md +807 -807
- package/kit/skills/supabase-custom-claims-rbac/SKILL.md +472 -472
- package/kit/skills/supabase-edge-functions/SKILL.md +330 -330
- package/kit/skills/supabase-edge-functions-auth/SKILL.md +309 -309
- package/kit/skills/supabase-edge-functions-limits/SKILL.md +302 -302
- package/kit/skills/supabase-edge-functions-mcp-server/SKILL.md +279 -279
- package/kit/skills/supabase-edge-functions-testing/SKILL.md +277 -277
- package/kit/skills/supabase-edge-runtime-builtins/SKILL.md +357 -357
- package/kit/skills/supabase-enterprise-sso-saml/SKILL.md +545 -545
- package/kit/skills/supabase-jwt-signing-keys/SKILL.md +399 -399
- package/kit/skills/supabase-mfa/SKILL.md +488 -488
- package/kit/skills/supabase-migration-repair/SKILL.md +823 -823
- package/kit/skills/supabase-migrations/SKILL.md +297 -297
- package/kit/skills/supabase-oauth-server/SKILL.md +537 -537
- package/kit/skills/supabase-pgtap-testing/SKILL.md +1053 -1053
- package/kit/skills/supabase-postgres-roles/SKILL.md +392 -392
- package/kit/skills/supabase-realtime/SKILL.md +460 -460
- package/kit/skills/supabase-rls-defense-in-depth/SKILL.md +418 -418
- package/kit/skills/supabase-rls-policies/SKILL.md +635 -635
- package/kit/skills/supabase-social-oauth/SKILL.md +480 -480
- package/kit/skills/supabase-third-party-auth/SKILL.md +450 -450
- package/kit/skills/super-admin-platform-pattern/SKILL.md +326 -326
- package/kit/skills/tenant-quente-mitigacao/SKILL.md +605 -605
- package/kit/skills/ui-anti-padroes-ia/SKILL.md +261 -0
- package/kit/skills/ui-contexto-produto/SKILL.md +248 -0
- package/kit/skills/ui-cor-estrategia/SKILL.md +213 -0
- package/kit/skills/ui-critica-auditoria/SKILL.md +260 -0
- package/kit/skills/ui-motion-funcional/SKILL.md +264 -0
- package/kit/skills/ui-ritmo-espacial/SKILL.md +259 -0
- package/kit/skills/ui-tipografia/SKILL.md +211 -0
- package/kit/skills/whatsapp-conversation-state-machine/SKILL.md +287 -287
- package/kit/workflows/auditar-observabilidade-cobertura.workflow.js +250 -0
- package/package.json +65 -63
- package/src/core/kit.js +333 -216
- package/src/core/reflect.js +247 -247
- package/src/core/registry.js +123 -112
- package/src/core/reverse-sync.js +448 -372
- package/src/core/sync.js +477 -437
- package/src/core/watch.js +121 -121
- package/src/mcp-server/index.js +794 -794
|
@@ -1,44 +1,44 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: novo-workspace
|
|
3
|
-
description: Cria um workspace isolado com cópias de repos e .planning/ independente
|
|
4
|
-
argument-hint: "--name <name> [--repos repo1,repo2] [--path /target] [--strategy worktree|clone] [--branch name] [--auto]"
|
|
5
|
-
allowed-tools:
|
|
6
|
-
- Read
|
|
7
|
-
- Bash
|
|
8
|
-
- Write
|
|
9
|
-
- AskUserQuestion
|
|
10
|
-
---
|
|
11
|
-
<context>
|
|
12
|
-
**Flags:**
|
|
13
|
-
- `--name` (obrigatório) — Nome do workspace
|
|
14
|
-
- `--repos` — Caminhos ou nomes de repos separados por vírgula. Se omitido, seleção interativa dos repos git filhos no cwd
|
|
15
|
-
- `--path` — Diretório de destino. Padrão: `~/workspaces/<name>`
|
|
16
|
-
- `--strategy` — `worktree` (padrão, leve) ou `clone` (totalmente independente)
|
|
17
|
-
- `--branch` — Branch para fazer checkout. Padrão: `workspace/<name>`
|
|
18
|
-
- `--auto` — Pular perguntas interativas, usar padrões
|
|
19
|
-
</context>
|
|
20
|
-
|
|
21
|
-
<objective>
|
|
22
|
-
Criar um diretório de workspace físico contendo cópias dos repos git especificados (como worktrees ou clones) com um diretório `.planning/` independente para sessões framework isoladas.
|
|
23
|
-
|
|
24
|
-
**Casos de uso:**
|
|
25
|
-
- Orquestração multi-repo: trabalhar em um subconjunto de repos em paralelo com estado framework isolado
|
|
26
|
-
- Isolamento de feature branch: criar um worktree do repo atual com seu próprio `.planning/`
|
|
27
|
-
|
|
28
|
-
**Cria:**
|
|
29
|
-
- `<path>/WORKSPACE.md` — manifesto do workspace
|
|
30
|
-
- `<path>/.planning/` — diretório de planejamento independente
|
|
31
|
-
- `<path>/<repo>/` — git worktree ou clone para cada repo especificado
|
|
32
|
-
|
|
33
|
-
**Após este comando:** `cd` no workspace e execute `/novo-projeto` para inicializar o framework.
|
|
34
|
-
</objective>
|
|
35
|
-
|
|
36
|
-
<execution_context>
|
|
37
|
-
@./.claude/framework/workflows/new-workspace.md
|
|
38
|
-
@./.claude/framework/references/ui-brand.md
|
|
39
|
-
</execution_context>
|
|
40
|
-
|
|
41
|
-
<process>
|
|
42
|
-
Execute o workflow new-workspace de @./.claude/framework/workflows/new-workspace.md do início ao fim.
|
|
43
|
-
Preserve todos os checkpoints do workflow (validação, aprovações, commits, roteamento).
|
|
1
|
+
---
|
|
2
|
+
name: novo-workspace
|
|
3
|
+
description: Cria um workspace isolado com cópias de repos e .planning/ independente
|
|
4
|
+
argument-hint: "--name <name> [--repos repo1,repo2] [--path /target] [--strategy worktree|clone] [--branch name] [--auto]"
|
|
5
|
+
allowed-tools:
|
|
6
|
+
- Read
|
|
7
|
+
- Bash
|
|
8
|
+
- Write
|
|
9
|
+
- AskUserQuestion
|
|
10
|
+
---
|
|
11
|
+
<context>
|
|
12
|
+
**Flags:**
|
|
13
|
+
- `--name` (obrigatório) — Nome do workspace
|
|
14
|
+
- `--repos` — Caminhos ou nomes de repos separados por vírgula. Se omitido, seleção interativa dos repos git filhos no cwd
|
|
15
|
+
- `--path` — Diretório de destino. Padrão: `~/workspaces/<name>`
|
|
16
|
+
- `--strategy` — `worktree` (padrão, leve) ou `clone` (totalmente independente)
|
|
17
|
+
- `--branch` — Branch para fazer checkout. Padrão: `workspace/<name>`
|
|
18
|
+
- `--auto` — Pular perguntas interativas, usar padrões
|
|
19
|
+
</context>
|
|
20
|
+
|
|
21
|
+
<objective>
|
|
22
|
+
Criar um diretório de workspace físico contendo cópias dos repos git especificados (como worktrees ou clones) com um diretório `.planning/` independente para sessões framework isoladas.
|
|
23
|
+
|
|
24
|
+
**Casos de uso:**
|
|
25
|
+
- Orquestração multi-repo: trabalhar em um subconjunto de repos em paralelo com estado framework isolado
|
|
26
|
+
- Isolamento de feature branch: criar um worktree do repo atual com seu próprio `.planning/`
|
|
27
|
+
|
|
28
|
+
**Cria:**
|
|
29
|
+
- `<path>/WORKSPACE.md` — manifesto do workspace
|
|
30
|
+
- `<path>/.planning/` — diretório de planejamento independente
|
|
31
|
+
- `<path>/<repo>/` — git worktree ou clone para cada repo especificado
|
|
32
|
+
|
|
33
|
+
**Após este comando:** `cd` no workspace e execute `/novo-projeto` para inicializar o framework.
|
|
34
|
+
</objective>
|
|
35
|
+
|
|
36
|
+
<execution_context>
|
|
37
|
+
@./.claude/framework/workflows/new-workspace.md
|
|
38
|
+
@./.claude/framework/references/ui-brand.md
|
|
39
|
+
</execution_context>
|
|
40
|
+
|
|
41
|
+
<process>
|
|
42
|
+
Execute o workflow new-workspace de @./.claude/framework/workflows/new-workspace.md do início ao fim.
|
|
43
|
+
Preserve todos os checkpoints do workflow (validação, aprovações, commits, roteamento).
|
|
44
44
|
</process>
|
|
@@ -1,38 +1,38 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: pausar-trabalho
|
|
3
|
-
description: Cria handoff de contexto ao pausar trabalho no meio de uma fase
|
|
4
|
-
allowed-tools:
|
|
5
|
-
- Read
|
|
6
|
-
- Write
|
|
7
|
-
- Bash
|
|
8
|
-
---
|
|
9
|
-
|
|
10
|
-
<objective>
|
|
11
|
-
Criar arquivo de handoff `.continue-here.md` para preservar o estado completo do trabalho entre sessões.
|
|
12
|
-
|
|
13
|
-
Encaminha para o workflow pause-work que cuida de:
|
|
14
|
-
- Detecção da fase atual a partir de arquivos recentes
|
|
15
|
-
- Coleta completa de estado (posição, trabalho concluído, trabalho restante, decisões, bloqueadores)
|
|
16
|
-
- Criação do arquivo de handoff com todas as seções de contexto
|
|
17
|
-
- Commit git como WIP
|
|
18
|
-
- Instruções de retomada
|
|
19
|
-
</objective>
|
|
20
|
-
|
|
21
|
-
<execution_context>
|
|
22
|
-
@./.claude/framework/workflows/pause-work.md
|
|
23
|
-
</execution_context>
|
|
24
|
-
|
|
25
|
-
<context>
|
|
26
|
-
Estado e progresso da fase são coletados no workflow com leituras específicas.
|
|
27
|
-
</context>
|
|
28
|
-
|
|
29
|
-
<process>
|
|
30
|
-
**Seguir o workflow pause-work** de `@./.claude/framework/workflows/pause-work.md`.
|
|
31
|
-
|
|
32
|
-
O workflow cuida de toda a lógica, incluindo:
|
|
33
|
-
1. Detecção do diretório de fase
|
|
34
|
-
2. Coleta de estado com esclarecimentos do usuário
|
|
35
|
-
3. Escrita do arquivo de handoff com timestamp
|
|
36
|
-
4. Commit git
|
|
37
|
-
5. Confirmação com instruções de retomada
|
|
1
|
+
---
|
|
2
|
+
name: pausar-trabalho
|
|
3
|
+
description: Cria handoff de contexto ao pausar trabalho no meio de uma fase
|
|
4
|
+
allowed-tools:
|
|
5
|
+
- Read
|
|
6
|
+
- Write
|
|
7
|
+
- Bash
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
<objective>
|
|
11
|
+
Criar arquivo de handoff `.continue-here.md` para preservar o estado completo do trabalho entre sessões.
|
|
12
|
+
|
|
13
|
+
Encaminha para o workflow pause-work que cuida de:
|
|
14
|
+
- Detecção da fase atual a partir de arquivos recentes
|
|
15
|
+
- Coleta completa de estado (posição, trabalho concluído, trabalho restante, decisões, bloqueadores)
|
|
16
|
+
- Criação do arquivo de handoff com todas as seções de contexto
|
|
17
|
+
- Commit git como WIP
|
|
18
|
+
- Instruções de retomada
|
|
19
|
+
</objective>
|
|
20
|
+
|
|
21
|
+
<execution_context>
|
|
22
|
+
@./.claude/framework/workflows/pause-work.md
|
|
23
|
+
</execution_context>
|
|
24
|
+
|
|
25
|
+
<context>
|
|
26
|
+
Estado e progresso da fase são coletados no workflow com leituras específicas.
|
|
27
|
+
</context>
|
|
28
|
+
|
|
29
|
+
<process>
|
|
30
|
+
**Seguir o workflow pause-work** de `@./.claude/framework/workflows/pause-work.md`.
|
|
31
|
+
|
|
32
|
+
O workflow cuida de toda a lógica, incluindo:
|
|
33
|
+
1. Detecção do diretório de fase
|
|
34
|
+
2. Coleta de estado com esclarecimentos do usuário
|
|
35
|
+
3. Escrita do arquivo de handoff com timestamp
|
|
36
|
+
4. Commit git
|
|
37
|
+
5. Confirmação com instruções de retomada
|
|
38
38
|
</process>
|
|
@@ -1,46 +1,46 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: perfil-usuario
|
|
3
|
-
description: Gera perfil comportamental do desenvolvedor e cria artefatos descobríveis pelo Claude
|
|
4
|
-
argument-hint: "[--questionnaire] [--refresh]"
|
|
5
|
-
allowed-tools:
|
|
6
|
-
- Read
|
|
7
|
-
- Write
|
|
8
|
-
- Bash
|
|
9
|
-
- Glob
|
|
10
|
-
- Grep
|
|
11
|
-
- AskUserQuestion
|
|
12
|
-
- Task
|
|
13
|
-
---
|
|
14
|
-
|
|
15
|
-
<objective>
|
|
16
|
-
Gerar um perfil comportamental do desenvolvedor a partir de análise de sessão (ou questionário) e produzir artefatos (USER-PROFILE.md, /preferencias-dev, seção CLAUDE.md) que personalizam as respostas do Claude.
|
|
17
|
-
|
|
18
|
-
Encaminha para o workflow profile-user que orquestra o fluxo completo: gate de consentimento, análise de sessão ou fallback de questionário, geração de perfil, exibição de resultados e seleção de artefatos.
|
|
19
|
-
</objective>
|
|
20
|
-
|
|
21
|
-
<execution_context>
|
|
22
|
-
@./.claude/framework/workflows/profile-user.md
|
|
23
|
-
@./.claude/framework/references/ui-brand.md
|
|
24
|
-
</execution_context>
|
|
25
|
-
|
|
26
|
-
<context>
|
|
27
|
-
Flags de $ARGUMENTS:
|
|
28
|
-
- `--questionnaire` -- Pular análise de sessão completamente, usar apenas questionário
|
|
29
|
-
- `--refresh` -- Reconstruir perfil mesmo quando existe, fazer backup do perfil antigo, mostrar diff de dimensão
|
|
30
|
-
</context>
|
|
31
|
-
|
|
32
|
-
<process>
|
|
33
|
-
Execute o workflow profile-user do início ao fim.
|
|
34
|
-
|
|
35
|
-
O workflow cuida de toda a lógica, incluindo:
|
|
36
|
-
1. Inicialização e detecção de perfil existente
|
|
37
|
-
2. Gate de consentimento antes da análise de sessão
|
|
38
|
-
3. Escaneamento de sessão e verificações de suficiência de dados
|
|
39
|
-
4. Análise de sessão (agente profiler) ou fallback de questionário
|
|
40
|
-
5. Resolução de divisão entre projetos
|
|
41
|
-
6. Escrita do perfil em USER-PROFILE.md
|
|
42
|
-
7. Exibição de resultado com card de relatório e destaques
|
|
43
|
-
8. Seleção de artefato (preferencias-dev, seções CLAUDE.md)
|
|
44
|
-
9. Geração sequencial de artefatos
|
|
45
|
-
10. Resumo com diff de atualização (se aplicável)
|
|
1
|
+
---
|
|
2
|
+
name: perfil-usuario
|
|
3
|
+
description: Gera perfil comportamental do desenvolvedor e cria artefatos descobríveis pelo Claude
|
|
4
|
+
argument-hint: "[--questionnaire] [--refresh]"
|
|
5
|
+
allowed-tools:
|
|
6
|
+
- Read
|
|
7
|
+
- Write
|
|
8
|
+
- Bash
|
|
9
|
+
- Glob
|
|
10
|
+
- Grep
|
|
11
|
+
- AskUserQuestion
|
|
12
|
+
- Task
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
<objective>
|
|
16
|
+
Gerar um perfil comportamental do desenvolvedor a partir de análise de sessão (ou questionário) e produzir artefatos (USER-PROFILE.md, /preferencias-dev, seção CLAUDE.md) que personalizam as respostas do Claude.
|
|
17
|
+
|
|
18
|
+
Encaminha para o workflow profile-user que orquestra o fluxo completo: gate de consentimento, análise de sessão ou fallback de questionário, geração de perfil, exibição de resultados e seleção de artefatos.
|
|
19
|
+
</objective>
|
|
20
|
+
|
|
21
|
+
<execution_context>
|
|
22
|
+
@./.claude/framework/workflows/profile-user.md
|
|
23
|
+
@./.claude/framework/references/ui-brand.md
|
|
24
|
+
</execution_context>
|
|
25
|
+
|
|
26
|
+
<context>
|
|
27
|
+
Flags de $ARGUMENTS:
|
|
28
|
+
- `--questionnaire` -- Pular análise de sessão completamente, usar apenas questionário
|
|
29
|
+
- `--refresh` -- Reconstruir perfil mesmo quando existe, fazer backup do perfil antigo, mostrar diff de dimensão
|
|
30
|
+
</context>
|
|
31
|
+
|
|
32
|
+
<process>
|
|
33
|
+
Execute o workflow profile-user do início ao fim.
|
|
34
|
+
|
|
35
|
+
O workflow cuida de toda a lógica, incluindo:
|
|
36
|
+
1. Inicialização e detecção de perfil existente
|
|
37
|
+
2. Gate de consentimento antes da análise de sessão
|
|
38
|
+
3. Escaneamento de sessão e verificações de suficiência de dados
|
|
39
|
+
4. Análise de sessão (agente profiler) ou fallback de questionário
|
|
40
|
+
5. Resolução de divisão entre projetos
|
|
41
|
+
6. Escrita do perfil em USER-PROFILE.md
|
|
42
|
+
7. Exibição de resultado com card de relatório e destaques
|
|
43
|
+
8. Seleção de artefato (preferencias-dev, seções CLAUDE.md)
|
|
44
|
+
9. Geração sequencial de artefatos
|
|
45
|
+
10. Resumo com diff de atualização (se aplicável)
|
|
46
46
|
</process>
|
|
@@ -1,195 +1,195 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: pesquisar-fase
|
|
3
|
-
description: Pesquisa como implementar uma fase (standalone — geralmente use /planejar-fase)
|
|
4
|
-
argument-hint: "[fase]"
|
|
5
|
-
allowed-tools:
|
|
6
|
-
- Read
|
|
7
|
-
- Bash
|
|
8
|
-
- Task
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
<objective>
|
|
12
|
-
Pesquisa como implementar uma fase. Invoca o agente phase-researcher com o contexto da fase.
|
|
13
|
-
|
|
14
|
-
**Nota:** Este é um comando de pesquisa standalone. Para a maioria dos fluxos, use `/planejar-fase` que integra a pesquisa automaticamente.
|
|
15
|
-
|
|
16
|
-
**Use este comando quando:**
|
|
17
|
-
- Você quer pesquisar sem planejar ainda
|
|
18
|
-
- Você quer re-pesquisar após o planejamento estar completo
|
|
19
|
-
- Você precisa investigar antes de decidir se uma fase é viável
|
|
20
|
-
|
|
21
|
-
**Papel do orquestrador:** Analisar fase, validar contra o roadmap, verificar pesquisa existente, reunir contexto, invocar agente pesquisador, apresentar resultados.
|
|
22
|
-
|
|
23
|
-
**Por que subagente:** Pesquisa consome contexto rapidamente (WebSearch, consultas Context7, verificação de fontes). Contexto fresco de 200k para investigação. Contexto principal fica enxuto para interação com o usuário.
|
|
24
|
-
</objective>
|
|
25
|
-
|
|
26
|
-
<available_agent_types>
|
|
27
|
-
Tipos de subagentes framework válidos (use nomes exatos — não use 'general-purpose' como fallback):
|
|
28
|
-
- phase-researcher — Pesquisa abordagens técnicas para uma fase
|
|
29
|
-
</available_agent_types>
|
|
30
|
-
|
|
31
|
-
<context>
|
|
32
|
-
Número da fase: $ARGUMENTS (obrigatório)
|
|
33
|
-
|
|
34
|
-
Normalizar entrada da fase no passo 1 antes de qualquer busca de diretório.
|
|
35
|
-
</context>
|
|
36
|
-
|
|
37
|
-
<process>
|
|
38
|
-
|
|
39
|
-
## 0. Inicializar Contexto
|
|
40
|
-
|
|
41
|
-
```bash
|
|
42
|
-
INIT=$(node "./.claude/framework/bin/tools.cjs" init phase-op "$ARGUMENTS")
|
|
43
|
-
if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
|
|
44
|
-
```
|
|
45
|
-
|
|
46
|
-
Extrair do JSON de init: `phase_dir`, `phase_number`, `phase_name`, `phase_found`, `commit_docs`, `has_research`, `state_path`, `requirements_path`, `context_path`, `research_path`.
|
|
47
|
-
|
|
48
|
-
Resolver modelo do pesquisador:
|
|
49
|
-
```bash
|
|
50
|
-
RESEARCHER_MODEL=$(node "./.claude/framework/bin/tools.cjs" resolve-model phase-researcher --raw)
|
|
51
|
-
```
|
|
52
|
-
|
|
53
|
-
## 1. Validar Fase
|
|
54
|
-
|
|
55
|
-
```bash
|
|
56
|
-
PHASE_INFO=$(node "./.claude/framework/bin/tools.cjs" roadmap get-phase "${phase_number}")
|
|
57
|
-
```
|
|
58
|
-
|
|
59
|
-
**Se `found` for false:** Erro e sair. **Se `found` for true:** Extrair `phase_number`, `phase_name`, `goal` do JSON.
|
|
60
|
-
|
|
61
|
-
## 2. Verificar Pesquisa Existente
|
|
62
|
-
|
|
63
|
-
```bash
|
|
64
|
-
ls .planning/phases/${PHASE}-*/RESEARCH.md 2>/dev/null
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
**Se existir:** Oferecer: 1) Atualizar pesquisa, 2) Ver existente, 3) Pular. Aguardar resposta.
|
|
68
|
-
|
|
69
|
-
**Se não existir:** Continuar.
|
|
70
|
-
|
|
71
|
-
## 3. Reunir Contexto da Fase
|
|
72
|
-
|
|
73
|
-
Usar caminhos do INIT (não colocar conteúdo de arquivos inline no contexto do orquestrador):
|
|
74
|
-
- `requirements_path`
|
|
75
|
-
- `context_path`
|
|
76
|
-
- `state_path`
|
|
77
|
-
|
|
78
|
-
Apresentar resumo com descrição da fase e quais arquivos o pesquisador vai carregar.
|
|
79
|
-
|
|
80
|
-
## 4. Invocar Agente phase-researcher
|
|
81
|
-
|
|
82
|
-
Modos de pesquisa: ecosystem (padrão), feasibility, implementation, comparison.
|
|
83
|
-
|
|
84
|
-
```markdown
|
|
85
|
-
<research_type>
|
|
86
|
-
Pesquisa de Fase — investigando COMO implementar uma fase específica bem.
|
|
87
|
-
</research_type>
|
|
88
|
-
|
|
89
|
-
<key_insight>
|
|
90
|
-
A questão NÃO é "qual biblioteca devo usar?"
|
|
91
|
-
|
|
92
|
-
A questão é: "O que eu não sei que não sei?"
|
|
93
|
-
|
|
94
|
-
Para esta fase, descobrir:
|
|
95
|
-
- Qual é o padrão de arquitetura estabelecido?
|
|
96
|
-
- Quais bibliotecas formam o stack padrão?
|
|
97
|
-
- Quais problemas as pessoas comumente encontram?
|
|
98
|
-
- Qual é o SOTA vs o que o treinamento do Claude acha que é SOTA?
|
|
99
|
-
- O que NÃO deve ser feito manualmente?
|
|
100
|
-
</key_insight>
|
|
101
|
-
|
|
102
|
-
<objective>
|
|
103
|
-
Pesquisar abordagem de implementação para Fase {phase_number}: {phase_name}
|
|
104
|
-
Modo: ecosystem
|
|
105
|
-
</objective>
|
|
106
|
-
|
|
107
|
-
<files_to_read>
|
|
108
|
-
- {requirements_path} (Requisitos)
|
|
109
|
-
- {context_path} (Contexto da fase do discutir-fase, se existir)
|
|
110
|
-
- {state_path} (Decisões e bloqueadores anteriores do projeto)
|
|
111
|
-
</files_to_read>
|
|
112
|
-
|
|
113
|
-
<additional_context>
|
|
114
|
-
**Descrição da fase:** {phase_description}
|
|
115
|
-
</additional_context>
|
|
116
|
-
|
|
117
|
-
<downstream_consumer>
|
|
118
|
-
Seu RESEARCH.md será carregado pelo `/planejar-fase` que usa seções específicas:
|
|
119
|
-
- `## Standard Stack` → Planos usam essas bibliotecas
|
|
120
|
-
- `## Architecture Patterns` → Estrutura de tarefas segue esses padrões
|
|
121
|
-
- `## Don't Hand-Roll` → Tarefas NUNCA constroem soluções customizadas para problemas listados
|
|
122
|
-
- `## Common Pitfalls` → Etapas de verificação checam por esses problemas
|
|
123
|
-
- `## Code Examples` → Ações de tarefas referenciam esses padrões
|
|
124
|
-
|
|
125
|
-
Seja prescritivo, não exploratório. "Use X" não "Considere X ou Y."
|
|
126
|
-
</downstream_consumer>
|
|
127
|
-
|
|
128
|
-
<quality_gate>
|
|
129
|
-
Antes de declarar completo, verificar:
|
|
130
|
-
- [ ] Todos os domínios investigados (não apenas alguns)
|
|
131
|
-
- [ ] Afirmações negativas verificadas com documentação oficial
|
|
132
|
-
- [ ] Múltiplas fontes para afirmações críticas
|
|
133
|
-
- [ ] Níveis de confiança atribuídos honestamente
|
|
134
|
-
- [ ] Nomes de seções correspondem ao que o planejar-fase espera
|
|
135
|
-
</quality_gate>
|
|
136
|
-
|
|
137
|
-
<output>
|
|
138
|
-
Escrever em: .planning/phases/${PHASE}-{slug}/${PHASE}-RESEARCH.md
|
|
139
|
-
</output>
|
|
140
|
-
```
|
|
141
|
-
|
|
142
|
-
```
|
|
143
|
-
Task(
|
|
144
|
-
prompt=filled_prompt,
|
|
145
|
-
subagent_type="phase-researcher",
|
|
146
|
-
model="{researcher_model}",
|
|
147
|
-
description="Pesquisar Fase {phase}"
|
|
148
|
-
)
|
|
149
|
-
```
|
|
150
|
-
|
|
151
|
-
## 5. Tratar Retorno do Agente
|
|
152
|
-
|
|
153
|
-
**`## RESEARCH COMPLETE`:** Exibir resumo, oferecer: Planejar fase, Aprofundar, Revisar completo, Concluído.
|
|
154
|
-
|
|
155
|
-
**`## CHECKPOINT REACHED`:** Apresentar ao usuário, obter resposta, invocar continuação.
|
|
156
|
-
|
|
157
|
-
**`## RESEARCH INCONCLUSIVE`:** Mostrar o que foi tentado, oferecer: Adicionar contexto, Tentar modo diferente, Manual.
|
|
158
|
-
|
|
159
|
-
## 6. Invocar Agente de Continuação
|
|
160
|
-
|
|
161
|
-
```markdown
|
|
162
|
-
<objective>
|
|
163
|
-
Continuar pesquisa para Fase {phase_number}: {phase_name}
|
|
164
|
-
</objective>
|
|
165
|
-
|
|
166
|
-
<prior_state>
|
|
167
|
-
<files_to_read>
|
|
168
|
-
- .planning/phases/${PHASE}-{slug}/${PHASE}-RESEARCH.md (Pesquisa existente)
|
|
169
|
-
</files_to_read>
|
|
170
|
-
</prior_state>
|
|
171
|
-
|
|
172
|
-
<checkpoint_response>
|
|
173
|
-
**Tipo:** {checkpoint_type}
|
|
174
|
-
**Resposta:** {user_response}
|
|
175
|
-
</checkpoint_response>
|
|
176
|
-
```
|
|
177
|
-
|
|
178
|
-
```
|
|
179
|
-
Task(
|
|
180
|
-
prompt=continuation_prompt,
|
|
181
|
-
subagent_type="phase-researcher",
|
|
182
|
-
model="{researcher_model}",
|
|
183
|
-
description="Continuar pesquisa Fase {phase}"
|
|
184
|
-
)
|
|
185
|
-
```
|
|
186
|
-
|
|
187
|
-
</process>
|
|
188
|
-
|
|
189
|
-
<success_criteria>
|
|
190
|
-
- [ ] Fase validada contra o roadmap
|
|
191
|
-
- [ ] Pesquisa existente verificada
|
|
192
|
-
- [ ] phase-researcher invocado com contexto
|
|
193
|
-
- [ ] Checkpoints tratados corretamente
|
|
194
|
-
- [ ] Usuário sabe os próximos passos
|
|
195
|
-
</success_criteria>
|
|
1
|
+
---
|
|
2
|
+
name: pesquisar-fase
|
|
3
|
+
description: Pesquisa como implementar uma fase (standalone — geralmente use /planejar-fase)
|
|
4
|
+
argument-hint: "[fase]"
|
|
5
|
+
allowed-tools:
|
|
6
|
+
- Read
|
|
7
|
+
- Bash
|
|
8
|
+
- Task
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
<objective>
|
|
12
|
+
Pesquisa como implementar uma fase. Invoca o agente phase-researcher com o contexto da fase.
|
|
13
|
+
|
|
14
|
+
**Nota:** Este é um comando de pesquisa standalone. Para a maioria dos fluxos, use `/planejar-fase` que integra a pesquisa automaticamente.
|
|
15
|
+
|
|
16
|
+
**Use este comando quando:**
|
|
17
|
+
- Você quer pesquisar sem planejar ainda
|
|
18
|
+
- Você quer re-pesquisar após o planejamento estar completo
|
|
19
|
+
- Você precisa investigar antes de decidir se uma fase é viável
|
|
20
|
+
|
|
21
|
+
**Papel do orquestrador:** Analisar fase, validar contra o roadmap, verificar pesquisa existente, reunir contexto, invocar agente pesquisador, apresentar resultados.
|
|
22
|
+
|
|
23
|
+
**Por que subagente:** Pesquisa consome contexto rapidamente (WebSearch, consultas Context7, verificação de fontes). Contexto fresco de 200k para investigação. Contexto principal fica enxuto para interação com o usuário.
|
|
24
|
+
</objective>
|
|
25
|
+
|
|
26
|
+
<available_agent_types>
|
|
27
|
+
Tipos de subagentes framework válidos (use nomes exatos — não use 'general-purpose' como fallback):
|
|
28
|
+
- phase-researcher — Pesquisa abordagens técnicas para uma fase
|
|
29
|
+
</available_agent_types>
|
|
30
|
+
|
|
31
|
+
<context>
|
|
32
|
+
Número da fase: $ARGUMENTS (obrigatório)
|
|
33
|
+
|
|
34
|
+
Normalizar entrada da fase no passo 1 antes de qualquer busca de diretório.
|
|
35
|
+
</context>
|
|
36
|
+
|
|
37
|
+
<process>
|
|
38
|
+
|
|
39
|
+
## 0. Inicializar Contexto
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
INIT=$(node "./.claude/framework/bin/tools.cjs" init phase-op "$ARGUMENTS")
|
|
43
|
+
if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
Extrair do JSON de init: `phase_dir`, `phase_number`, `phase_name`, `phase_found`, `commit_docs`, `has_research`, `state_path`, `requirements_path`, `context_path`, `research_path`.
|
|
47
|
+
|
|
48
|
+
Resolver modelo do pesquisador:
|
|
49
|
+
```bash
|
|
50
|
+
RESEARCHER_MODEL=$(node "./.claude/framework/bin/tools.cjs" resolve-model phase-researcher --raw)
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
## 1. Validar Fase
|
|
54
|
+
|
|
55
|
+
```bash
|
|
56
|
+
PHASE_INFO=$(node "./.claude/framework/bin/tools.cjs" roadmap get-phase "${phase_number}")
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
**Se `found` for false:** Erro e sair. **Se `found` for true:** Extrair `phase_number`, `phase_name`, `goal` do JSON.
|
|
60
|
+
|
|
61
|
+
## 2. Verificar Pesquisa Existente
|
|
62
|
+
|
|
63
|
+
```bash
|
|
64
|
+
ls .planning/phases/${PHASE}-*/RESEARCH.md 2>/dev/null
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
**Se existir:** Oferecer: 1) Atualizar pesquisa, 2) Ver existente, 3) Pular. Aguardar resposta.
|
|
68
|
+
|
|
69
|
+
**Se não existir:** Continuar.
|
|
70
|
+
|
|
71
|
+
## 3. Reunir Contexto da Fase
|
|
72
|
+
|
|
73
|
+
Usar caminhos do INIT (não colocar conteúdo de arquivos inline no contexto do orquestrador):
|
|
74
|
+
- `requirements_path`
|
|
75
|
+
- `context_path`
|
|
76
|
+
- `state_path`
|
|
77
|
+
|
|
78
|
+
Apresentar resumo com descrição da fase e quais arquivos o pesquisador vai carregar.
|
|
79
|
+
|
|
80
|
+
## 4. Invocar Agente phase-researcher
|
|
81
|
+
|
|
82
|
+
Modos de pesquisa: ecosystem (padrão), feasibility, implementation, comparison.
|
|
83
|
+
|
|
84
|
+
```markdown
|
|
85
|
+
<research_type>
|
|
86
|
+
Pesquisa de Fase — investigando COMO implementar uma fase específica bem.
|
|
87
|
+
</research_type>
|
|
88
|
+
|
|
89
|
+
<key_insight>
|
|
90
|
+
A questão NÃO é "qual biblioteca devo usar?"
|
|
91
|
+
|
|
92
|
+
A questão é: "O que eu não sei que não sei?"
|
|
93
|
+
|
|
94
|
+
Para esta fase, descobrir:
|
|
95
|
+
- Qual é o padrão de arquitetura estabelecido?
|
|
96
|
+
- Quais bibliotecas formam o stack padrão?
|
|
97
|
+
- Quais problemas as pessoas comumente encontram?
|
|
98
|
+
- Qual é o SOTA vs o que o treinamento do Claude acha que é SOTA?
|
|
99
|
+
- O que NÃO deve ser feito manualmente?
|
|
100
|
+
</key_insight>
|
|
101
|
+
|
|
102
|
+
<objective>
|
|
103
|
+
Pesquisar abordagem de implementação para Fase {phase_number}: {phase_name}
|
|
104
|
+
Modo: ecosystem
|
|
105
|
+
</objective>
|
|
106
|
+
|
|
107
|
+
<files_to_read>
|
|
108
|
+
- {requirements_path} (Requisitos)
|
|
109
|
+
- {context_path} (Contexto da fase do discutir-fase, se existir)
|
|
110
|
+
- {state_path} (Decisões e bloqueadores anteriores do projeto)
|
|
111
|
+
</files_to_read>
|
|
112
|
+
|
|
113
|
+
<additional_context>
|
|
114
|
+
**Descrição da fase:** {phase_description}
|
|
115
|
+
</additional_context>
|
|
116
|
+
|
|
117
|
+
<downstream_consumer>
|
|
118
|
+
Seu RESEARCH.md será carregado pelo `/planejar-fase` que usa seções específicas:
|
|
119
|
+
- `## Standard Stack` → Planos usam essas bibliotecas
|
|
120
|
+
- `## Architecture Patterns` → Estrutura de tarefas segue esses padrões
|
|
121
|
+
- `## Don't Hand-Roll` → Tarefas NUNCA constroem soluções customizadas para problemas listados
|
|
122
|
+
- `## Common Pitfalls` → Etapas de verificação checam por esses problemas
|
|
123
|
+
- `## Code Examples` → Ações de tarefas referenciam esses padrões
|
|
124
|
+
|
|
125
|
+
Seja prescritivo, não exploratório. "Use X" não "Considere X ou Y."
|
|
126
|
+
</downstream_consumer>
|
|
127
|
+
|
|
128
|
+
<quality_gate>
|
|
129
|
+
Antes de declarar completo, verificar:
|
|
130
|
+
- [ ] Todos os domínios investigados (não apenas alguns)
|
|
131
|
+
- [ ] Afirmações negativas verificadas com documentação oficial
|
|
132
|
+
- [ ] Múltiplas fontes para afirmações críticas
|
|
133
|
+
- [ ] Níveis de confiança atribuídos honestamente
|
|
134
|
+
- [ ] Nomes de seções correspondem ao que o planejar-fase espera
|
|
135
|
+
</quality_gate>
|
|
136
|
+
|
|
137
|
+
<output>
|
|
138
|
+
Escrever em: .planning/phases/${PHASE}-{slug}/${PHASE}-RESEARCH.md
|
|
139
|
+
</output>
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
```
|
|
143
|
+
Task(
|
|
144
|
+
prompt=filled_prompt,
|
|
145
|
+
subagent_type="phase-researcher",
|
|
146
|
+
model="{researcher_model}",
|
|
147
|
+
description="Pesquisar Fase {phase}"
|
|
148
|
+
)
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
## 5. Tratar Retorno do Agente
|
|
152
|
+
|
|
153
|
+
**`## RESEARCH COMPLETE`:** Exibir resumo, oferecer: Planejar fase, Aprofundar, Revisar completo, Concluído.
|
|
154
|
+
|
|
155
|
+
**`## CHECKPOINT REACHED`:** Apresentar ao usuário, obter resposta, invocar continuação.
|
|
156
|
+
|
|
157
|
+
**`## RESEARCH INCONCLUSIVE`:** Mostrar o que foi tentado, oferecer: Adicionar contexto, Tentar modo diferente, Manual.
|
|
158
|
+
|
|
159
|
+
## 6. Invocar Agente de Continuação
|
|
160
|
+
|
|
161
|
+
```markdown
|
|
162
|
+
<objective>
|
|
163
|
+
Continuar pesquisa para Fase {phase_number}: {phase_name}
|
|
164
|
+
</objective>
|
|
165
|
+
|
|
166
|
+
<prior_state>
|
|
167
|
+
<files_to_read>
|
|
168
|
+
- .planning/phases/${PHASE}-{slug}/${PHASE}-RESEARCH.md (Pesquisa existente)
|
|
169
|
+
</files_to_read>
|
|
170
|
+
</prior_state>
|
|
171
|
+
|
|
172
|
+
<checkpoint_response>
|
|
173
|
+
**Tipo:** {checkpoint_type}
|
|
174
|
+
**Resposta:** {user_response}
|
|
175
|
+
</checkpoint_response>
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
```
|
|
179
|
+
Task(
|
|
180
|
+
prompt=continuation_prompt,
|
|
181
|
+
subagent_type="phase-researcher",
|
|
182
|
+
model="{researcher_model}",
|
|
183
|
+
description="Continuar pesquisa Fase {phase}"
|
|
184
|
+
)
|
|
185
|
+
```
|
|
186
|
+
|
|
187
|
+
</process>
|
|
188
|
+
|
|
189
|
+
<success_criteria>
|
|
190
|
+
- [ ] Fase validada contra o roadmap
|
|
191
|
+
- [ ] Pesquisa existente verificada
|
|
192
|
+
- [ ] phase-researcher invocado com contexto
|
|
193
|
+
- [ ] Checkpoints tratados corretamente
|
|
194
|
+
- [ ] Usuário sabe os próximos passos
|
|
195
|
+
</success_criteria>
|