cursor-grok-4.5-{low,medium,high}[-fast] and kimi-k3-low were falling
back to composer-2.5 against live /v1/models (grok-4.5 + effort,
kimi-k3 + reasoning). Teach resolvePoolModel the mapping, document
when to pick each Grok effort in model-selection, and align plan/work
skills.
8.2 KiB
| name | description |
|---|---|
| plan-issue | Registra uma ou VÁRIAS ideias/features/débitos do Teqo como GitHub Issues rastreáveis — classifica, explora o código, produz plano completo em docs/plans/<slug>.md por item, sugere modelo × effort (model-selection) e passa por um GATE de confirmação (overview + wireframes ASCII) antes de criar qualquer Issue via `pnpm agent:register`. Usar quando o usuário pedir para adicionar/registrar algo ("adiciona ao roadmap", "registra essa ideia", "cria um plano para", "planeja a issue", "registra tudo isso"), em lote ou avulso. |
Planejar e registrar Issues (1..N ideias)
Esta skill transforma ideias soltas em: (1) um plano completo em docs/plans/<slug>.md por item, e (2) uma GitHub Issue rastreável por item (pnpm agent:register, frontmatter id/depends/serializes/priority/model). GitHub Issues são a fonte canônica de spec/status/deps/prio/modelo — docs/roadmap.md é legado congelado e nunca é editado aqui.
Gate de confirmação (obrigatório): nenhuma Issue é criada no GitHub antes do usuário aprovar o overview do lote (Passo 5). Planos locais podem ser rascunhados antes; Issues, não.
Divisão com work-issue: aqui se classifica a superfície UI (A–D), semeia âncoras de design e escreve o plano. Não se implementa código nem se roda Impeccable craft/critique/polish — isso pertence a work-issue.
Qualidade de decisão (não é tour): aplique decision-quality.md em silêncio — filtro caro vs barato, Opções+Recomendação+rejeitadas, appetite, rabbit holes, depth check, self-score ≥4 antes de gravar.
Dados → decisão → apresentação: se o item produz, agrega ou exibe números/séries/mapas/KPIs, aplique data-presentation.md em silêncio antes de travar a Abordagem. Se não há superfície de dados, Dados: N/A no plano.
Checklist do fluxo
- [ ] 1. Parse do lote + dedup (intra-lote, Issues existentes, docs/plans, roadmap legacy)
- [ ] 2. Reserva de IDs de uma vez por trilha (roadmap legacy + issuesById())
- [ ] 3. Por item (ordem topológica): classificar → explorar código → Impeccable A–D → dados → posicionamento → plano completo
- [ ] 4. Sugestão de modelo × effort via model-selection (uma linha por item)
- [ ] 5. GATE: overview do lote + wireframes ASCII das superfícies B/C/D → confirmar/iterar
- [ ] 6. Registro: pnpm agent:register (com --model) por item + commit dos planos
Passo 1 — Parse do lote e dedup
- Separe os itens. A entrada pode vir como 1 ideia ou N (lista, parágrafo, notas). Se a separação for ambígua, assuma a leitura mais provável e liste como você entendeu — a confirmação vai junto do gate.
- Deduplique dentro do lote. Desfechos: mesclar (um item, plano único), absorver (vira fase de plano existente, sem ID novo), ou manter separados com dependência explícita.
- Deduplique contra o que já existe:
gh issue list --state all(frontmatteridviaissuesById()emscripts/lib/agent-github.mjs), grep emdocs/plans/*.mde emdocs/roadmap.md(legado). Três desfechos por item: já coberto → aponte a Issue/plano existente e não crie nada; é fase de plano existente → adicione ao plano existente; realmente novo → siga.
Passo 2 — Reserva de IDs
Levante o último ID usado por trilha (A/B/C/D/E) olhando o roadmap legacy + issuesById() e distribua sequencialmente para os itens do lote antes de escrever qualquer plano (ex.: trilha B em B78 → os dois itens de B viram B79, B80). IDs fora de trilha (chore/ops) seguem o prefixo do seu domínio conforme precedentes (O0+, FD+, RS+) ou a trilha temática mais próxima.
Passo 3 — Por item: do tipo ao plano completo
Ordem topológica intra-lote (o plano do dependente cita o ID do dependido, que já existe). Por item:
- Classificar o tipo:
| Tipo | Destino |
|---|---|
Feature de /campanha ou site público com escopo próprio |
Issue kind:feature com plano |
| Tarefa pequena / chore / débito de engenharia | Issue kind:chore + plano curto (ou body direto se trivial) |
| Défice comportamental do fluxo de agentes | pnpm agent:file-miss (kind:agent-miss), não aqui |
| Bloqueio externo (jurídico/LGPD) | Issue blocked + label needs:consent/needs:migration; texto novo entra no lote jurídico existente, nunca rodada separada |
| Decisão de NÃO fazer | Comentário/doc, não Issue |
- Explorar o código (depth check): onde a feature se pluga, o que reusar de
src/utilities/*,src/components/campaign/*,src/lib/*; schema novo → migration (caro de reverter → Decisão travada com rejeitadas); pessoa → join comContact; opt-in/PII →Consentpor chave estável falhando fechado. Precedente análogo emdocs/plans/dita o nível de detalhe. - Classificar superfície UI (A–D) e semear âncoras:
PRODUCT.md/DESIGN.md, design-ref emdocs/design-refs/latest/se houver, shells existentes. Classe C exige brief compacto (persona, job, estratégia de cor, anti-goals) no plano. Proibido: rodar craft/critique/polish aqui. - Dados → decisão → apresentação (data-presentation.md) ou
Dados: N/A. - Posicionamento: prioridade
P0..P3(jurídico/caminho crítico > base de dados > operação de campo > inteligência > plataforma),depends(IDs duros), appetite, janela do calendário eleitoral quando relevante,serializesquando toca recurso compartilhado (ex.: migrations). - Plano completo em
docs/plans/<slug>.mdseguindo plan-template.md à risca — cabeçalho comIssue:/Priority:/Model:/Appetite, fases verificáveis com quota, tracer bullet, guardrails, rabbit holes, adiados, seção Dados, e wireframe ASCII se B/C/D com layout. Self-score ≥4/5 antes de gravar.
Passo 4 — Sugestão de modelo × effort
Aplique a skill model-selection (tabela canônica) por item e registre a sugestão no cabeçalho do plano (Model:) e no resumo do gate. Caminho feliz único:
composer-2.5— default (features, chores simples, fixes localizados, docs leves)cursor-grok-4.5-low|cursor-grok-4.5-medium|cursor-grok-4.5-high— Grok com effort explícito (ver model-selection: Low = mecânico com julgamento; Medium = discovery/análise; High = multi-domínio / falha cara)kimi-k3-low— só fase de execução de issues bipartidas (refactor / simplify / migration+RBAC de blast radius alto)
Issues muito complexas: registre duas Issues encadeadas — {id}-plan (model: cursor-grok-4.5-high, entregável = plano + critérios de aceite) e {id}/{id}-exec (model: kimi-k3-low, depends: [{id}-plan]). O valor vai ao frontmatter model: — propriedade da Issue, verificada (não recalculada) por work-issue.
Passo 5 — GATE de confirmação (obrigatório)
Apresente no chat, antes de criar qualquer Issue:
- Overview do lote — uma linha por plano: ID, título, prio, depends, appetite, modelo sugerido, link do plano local.
- Wireframes ASCII das superfícies B/C/D (copiados dos planos).
- Perguntas acumuladas (se houver) em uma única rodada
AskQuestion, recomendação primeiro.
O usuário confirma ou pede modificações; itere até confirmar. Só depois avance ao Passo 6. Planos em docs/plans/ podem ser rascunhados antes do gate (arquivos locais isolados); ajuste-os conforme a resposta.
Passo 6 — Registro
Por item confirmado:
pnpm agent:register -- --id <ID> --title "<título>" --prio <P0..P3> \
--depends <A,B> --kind <feature|chore|...> --plan docs/plans/<slug>.md \
--model <slug> [--blocked] [--labels extra]
A Issue nasce ready (ou blocked) com frontmatter id/depends/serializes/priority/model + spec + link do plano. Atualize o cabeçalho do plano (Issue: #N). Commit dos planos (commits lógicos por item ou por lote).
NÃO faz: editar docs/roadmap.md (legado congelado), implementar código, claim (pnpm agent:claim é de work-issue).
Resumo final
Tabela do lote (ID, título, prio, depends, appetite, modelo, Issue #N, plano) + em prosa: mesclados/absorvidos/descartados por duplicidade, decisões assumidas (validar com produto), e o que o gate decidiu.