feature-auditor

Subagent custom registrado em ~/.claude/agents/feature-auditor.md.

Quando invocar

SEMPRE apos qualquer alteracao de UI ou logica no projeto agencia-kodama-admin (CRM Kodama em https://crm.kodama.solutions), antes de reportar "deploy ok" ao user.

Tambem util para auditoria pre-merge em outros projetos Kodama, mas o checklist e ajustado pro admin (shadcn-first, OKLCH, SQLite, Better Auth, deploy VPS Hermes).

O que ele faz

Lista checklist em ~/.claude/agents/feature-auditor.md, mas resumo:

1. Logica da feature: golden path + edge cases (limpar/vazio/erro, state sync, async loading)
2. shadcn-first compliance: grep por classes legadas (font-display, text-fg-mute, etc) e HTML primitives crus (<button|<input|<table>)
3. Build: npx next build precisa terminar com tabela de rotas, sem type-check failure
4. Smoke prod: curl na rota + docker ps no VPS Hermes
5. Workflow obrigatorio: build local OK -> commit -> push -> ssh pull -> rebuild -> smoke

Como invocar

Via Agent tool com subagent_type: "feature-auditor". Se nao aparecer na lista (apos primeira criacao requer reload do CLI), fallback: invocar general-purpose passando as instrucoes do auditor inline.

Filosofia

NAO escreve codigo, so audita e reporta. NAO e simpatico - bug e bug. Cita file:line sempre.

Caso real de validacao (2026-05-27)

Encontrou bug em commit f98151d (filters-dialog.tsx): apos fix do "limpar campos + aplicar", state local do dialog dessincronizava com URL no browser back/forward, fazendo aplicar silenciosamente apagar filtros stale. Fix em d7ee23f: useEffect com deps em current.q/projeto/stage/origem.

Provou valor desde a primeira execucao - bug que so apareceria em uso real.

Relacionado

project_admin_workflow - workflow obrigatorio commit+push+deploy
feedback_shadcn_first - regra shadcn-first que o auditor valida