teqo-backup/.agents/skills/work-issue/engineering-brief.md
Francisco Solla 0822cca82c chore: reduce token overhead in agent workflow
- Drop model-selection skill (dead, pool is dormant)
- Drop PNG rendering from UI planning (HTML-only, no pnpm ui-draft:render)
- Trim code-simplification: 331→~150 lines, Python/React examples moved to reference/
- Compress engineering-brief.md: remove redundant 'Pinhos do repo' (alwaysApply rules)
- Deduplicate capture-review-debts: reference decision-quality.md instead of re-explaining
- Create concise-output skill (35 lines) to enforce terse agent output
- Trim all 99 skill descriptions to ≤1 sentence
- Split AGENTS.md into layers: core (73 lines, always) + campaign/public/infra (on-demand)
- Decompose plan-issue: exploration sub-agent + parallel plan-writers + register sub-agent
- Decompose work-issue: exploration sub-agent + plan-writer + 2 parallel reviewers + debt sub-agent
- Update agent-work-issue to match sub-agent pattern
2026-08-21 20:38:56 -03:00

28 lines
1.5 KiB
Markdown

# Brief de engenharia (carregar antes do plano de implementação)
Leia o que for relevante **antes** de travar a abordagem no `*-impl.md`. Não invoque jornadas inteiras de skills — aplique o princípio no momento da decisão.
## Skills sob demanda (não tour)
| Situação | Skill / princípio |
| -------- | ----------------- |
| Onde colocar lógica / dependência | `clean-architecture` — Dependency Rule; core testável |
| Complexidade de módulo / API | `software-design-philosophy` — deep modules, anti-classitis |
| Escopo v1 / cortar especulação | `37signals-way` / `pragmatic-programmer` — build less, tracer bullet, DRY de conhecimento |
| Schema Payload | skill `payload-migrations` |
| DB local / Cloud sem Docker | skill `local-database` |
| KPI/mapa/série na UI | [data-presentation.md](../plan-issue/data-presentation.md) pergunta 3 no impl |
| Domínio `/campanha` específico | rules `projects/*` se o item tocar aquele projeto |
## Invariantes que o impl plan não pode violar
- Local API com `user` → `overrideAccess: false`
- Escrita multi-collection → transação + `req: { transactionID }`
- Pessoa → join com `Contact` (não collection paralela)
- Opt-in/PII → `Consent` por chave estável, fail-closed
- `leader` lockdown; sem `estimatedVotes` para liderança
- Copy pt-BR / identificadores em inglês
## Sistema de listas
Se a superfície for lista/tabela: reusar shells (`CampaignTable`, URL canônica, column visibility, pending boundary) — ver codebase-map. Não reinventar.