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

1.5 KiB

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 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.