simplify: skills-map/AGENTS.md pós I2 — vocab do plan-issue sem herança teqo, update não-interativo (Related #4)
All checks were successful
Agent PR Ready + auto-merge / ready-automerge (pull_request) Has been skipped
CI / checks (pull_request) Successful in 11s
CI / deploy (pull_request) Has been skipped
Main merge flips claimed issues to done + in-prod / issue-done (pull_request) Successful in 4s
Promote plan-issue Related on main merge / plan-issue-ready (pull_request) Successful in 4s
CI / checks (push) Successful in 12s
CI / deploy (push) Successful in 4s

This commit is contained in:
Francisco Solla 2026-08-18 11:26:11 -03:00
parent f1f83ed80a
commit 38a309517e
2 changed files with 9 additions and 9 deletions

View file

@ -21,15 +21,15 @@ Na Iara: **idea-refine / interview** antes se vago; **spec + plan + tasks** = es
| ----- | ----------------------------- | ----------------------- |
| **idea-refine** | Se a ideia for vaga: HMW + 3–5 sharpening Qs + Not Doing + assumptions a validar **antes** do plano. Gate: "ainda não dá para registrar". | Sessão divergente completa (5–8 variações); salvar em `docs/ideas/` |
| **interview-me** | Só se o usuário não sabe o que quer (rotear). | Extrair requirements longos aqui |
| **spec-driven-development** | Premissas explícitas; objetivos como critérios de aceite testáveis; Boundaries Always/Ask/Never da Iara; reframing de pedido vago → sucesso mensurável | Spec de 6 seções / fase IMPLEMENT |
| **planning-and-task-breakdown** | Fatias **verticais**; fases com aceite + verificação; grafo de deps; high-risk cedo; XL → bipartir `{id}-plan`/`{id}-exec` | Checkpoint humano entre cada fase na implementação |
| **incremental-implementation** | Tracer bullet = 1ª fase; risco-primeiro se incerteza; cada fase deixa o sistema compilável | Ciclo implement→test→commit (é `work-issue`) |
| **doubt-driven-development** | Em decisão **cara** (protocolo WS, schema de settings, URL/contrato imutável): CLAIM curto + adversarial self-check antes de travar | Doubt em cada bullet; cross-model CLI; doubt pós-código |
| **source-driven-development** | Se a Abordagem depende de API externa (gateway ZeroClaw, Web Speech): anotar "verificar docs na implementação" + versão em `package.json` | Fetch de docs e citações no plano |
| **spec-driven-development** | Premissas explícitas; objetivos como critérios de aceite testáveis; invariantes do AGENTS.md (token nunca logado, aprovações nunca auto-aprovadas); reframing de pedido vago → sucesso mensurável | Template de spec completo no plano / fase IMPLEMENT |
| **planning-and-task-breakdown** | Fatias **verticais**; fases com aceite + verificação; grafo de deps; high-risk cedo; pedido grande → fatiar em Issues | Checkpoint humano entre cada fase na implementação |
| **incremental-implementation** | Risco-primeiro se incerteza de direção; incrementos pequenos e verificáveis | Tracer bullet, fases, ciclo implement→test→commit (é `work-issue`) |
| **doubt-driven-development** | Em decisão **cara** que o humano levanta (ex.: contrato público, dado sensível): CLAIM curto + adversarial self-check antes de travar | Doubt em cada bullet; cross-model CLI; doubt pós-código |
| **source-driven-development** | Se a direção do plano depende de API externa (gateway ZeroClaw, Web Speech): anotar "verificar docs na implementação" + versão em `package.json` | Fetch de docs e citações no plano |
| **documentation-and-adrs** | Decisões travadas = ADR-lite do item (contexto + rejeitadas). Repo-wide → apontar follow-up em `docs/` | Criar `docs/decisions/` novo sem precedente |
| **domain-driven-design** / **clean-architecture** / **software-design-philosophy** | Vocabulário, Dependency Rule, deep modules — via [decision-quality.md](../work-issue/decision-quality.md) sob demanda | Modelar bounded contexts do zero num item de lista |
| **test-driven-development** | Na fase: "Verify: pin unit/int …" | RED/GREEN no planning |
| **api-and-interface-design** | Contratos de action/URL no Abordagem quando há API nova | Desenhar OpenAPI completo |
| **test-driven-development** | Aceite cita verificação (unit/int) | RED/GREEN no planning |
| **api-and-interface-design** | Contrato público (URL/slug) quando o humano levantar; resto → `work-issue` | Desenhar OpenAPI completo |
| **context-engineering** | Plano cita arquivos reais (não dump do repo) | Carregar contexto de implementação aqui |
**Nota:** o que o teqo emprestava de `37signals-way` (appetite, rabbit holes, no-gos) e de `design-code-architecture` (caro/barato, depth) já está destilado em [shaping.md](shaping.md) e [decision-quality.md](../work-issue/decision-quality.md) — essas skills não estão no pack da Iara (sem produto/marketing).

View file

@ -13,8 +13,6 @@ usuário.
- `bun run gate` — gate local: `lint` (oxlint) + `build` (typecheck + build). Rode antes de push.
- `bun run test:e2e` — **e2e Playwright; roda SÓ no CI, nunca local** (decisão do fluxo: não rodar e2e local para não divergir do CI).
**Pack de skills de engenharia:** em `.agents/skills/` (além das 5 de fluxo custom), com proveniência/hashes em `skills-lock.json` na raiz — fonte de verdade; upgrade deliberado via `npx skills update`.
## Arquitetura do código
- `src/lib/ws.ts` — protocolo WebSocket `zeroclaw.v1` (tipos de mensagens, conecta em `<gateway>/ws/chat?token=&agent=&name=`). **Contrato**: mudar tipos de protocolo é breaking.
@ -32,6 +30,8 @@ identificadores em inglês; assets offline em `globPatterns` do PWA.
## Workflow de trabalho (fluxo tipo teqo)
**Pack de skills de engenharia:** em `.agents/skills/` (além das 5 de fluxo custom), com proveniência/hashes em `skills-lock.json` na raiz — fonte de verdade; upgrade deliberado via `npx skills update -y`.
Issues do Forgejo (`git.solla.dev/amana/iara-pwa`) são a fonte canônica de
spec/status/deps/prio. Estado em labels: `ready | in-progress | blocked | done`
(+ `in-prod`). Frontmatter no body da Issue: