teqo-backup/.agents/skills/work-issue/engineering-brief.md
Francisco Ignácio Fontoura Solla 896d957497 chore: migrate .cursor/ references to .agents/ folder
Replace all project-local .cursor/ path references with .agents/ across
rules, skills, environment config, hooks, and ignore files. Keep Cursor
editor paths (~/.cursor/, window.cursor, CURSOR_API_KEY) and vendored
Impeccable editor-hook paths unchanged.
2026-08-05 00:09:09 -03:00

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

Pinos do repo (sempre)

  • .agents/rules/codebase-map.mdc — direção lib/ → utilities/ → components/ → app/; dono da feature
  • .agents/rules/engineering-standards.mdc — gates, type honesty, client boundary, caching ladder, access
  • .agents/rules/security-critical.mdc — quando tocar access/Local API/overrideAccess
  • AGENTS.md — auth campanha, Consent fail-closed, transactions, naming, DB local
  • docs/ARCHITECTURE.md — se a mudança cruza verticais ou modelo de domínio

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.