teqo/docs/research/README.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

50 lines
11 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# docs/research — embasamento de produto (campanha DF-BA)
Artefatos do ciclo de discovery "literatura → persona → entrevista → docs de produto" (2026-07-21). Servem de embasamento teórico para decisões de produto do `/campanha` — em especial métricas territoriais, o Mapa das Praças e o programa de inteligência.
| Artefato | O quê | Status |
| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ | ---------------------------------- |
| [`literatura-campanha-deputado-federal-ba.md`](literatura-campanha-deputado-federal-ba.md) | Compêndio da literatura (5 eixos + cartografia/métricas + agregações + alienação eleitoral), ~67 fontes e implicações | aprovado 2026-07-21 |
| [`persona-cientista-politico-campanha-ba.md`](persona-cientista-politico-campanha-ba.md) | Persona especialista sintética (Prof. Helena Rocha) grounded no compêndio | aprovado 2026-07-21 |
| [`roteiro-entrevista-persona-campanha.md`](roteiro-entrevista-persona-campanha.md) | Roteiro Mom Test/JTBD/Lean Analytics para a entrevista sintética | aprovado 2026-07-21 |
| [`relatorio-entrevista-persona-campanha.md`](relatorio-entrevista-persona-campanha.md) | Relatório da entrevista (6 rodadas): kernel, rankings, playbook dado→decisão (25 padrões), OST, anti-goals + transcrição | **aprovado 2026-07-21 — canônico** |
| [`sources/README.md`](sources/README.md) | Fila pause-and-fetch de obras sem acesso aberto (depósito legal de PDFs/EPUBs, gitignored) | ativa |
**Consumo pelo produto:** o relatório alimentou o programa **Inteligência de campanha** (E8–E15, B13, C12) — plano-mestre em [`docs/plans/inteligencia-campanha.md`](../plans/inteligencia-campanha.md), itens no [roadmap](../roadmap.md).
**Limitação metodológica:** a entrevista é sintética (persona construída a partir da literatura). Achados são **hipóteses de literatura/persona**, não fato de campo. A validação empírica é a sessão com o coordenador real (ver `docs/CUSTOMER.md`).
## Ciclo 2 — Discovery de finanças de campanha (2026-07-28)
Mesmo método (literatura → personas → entrevistas sintéticas → relatório → validação real), aplicado à **gestão financeira** de uma campanha de DF na Bahia, sob três ângulos (financeiro-operacional, jurídico, político). Notebook do projeto: `.agents/rules/projects/financas-campanha.mdc`.
| Artefato | O quê | Status |
| ------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- |
| [`literatura-financas-campanha-df-ba.md`](literatura-financas-campanha-df-ba.md) | Compêndio dos 3 eixos (regras 2026: Res. 23.752/2026, Conta+JE, FEFC/cotas; operação do dinheiro; economia política), 48 fontes | rascunho 2026-07-28 |
| [`persona-financas-contadora-eleitoral.md`](persona-financas-contadora-eleitoral.md) | Persona sintética "Márcia Anunciação" — contadora eleitoral (ângulo financeiro-operacional) | rascunho 2026-07-28 |
| [`persona-financas-advogado-eleitoral.md`](persona-financas-advogado-eleitoral.md) | Persona sintética "Dr. Rafael Guimarães" — advogado eleitoralista (ângulo jurídico) | rascunho 2026-07-28 |
| [`persona-financas-tesoureiro-politico.md`](persona-financas-tesoureiro-politico.md) | Persona sintética "Tonho Bastos" — tesoureiro político de campanha (ângulo político) | rascunho 2026-07-28 |
| [`roteiro-entrevista-financas-personas.md`](roteiro-entrevista-financas-personas.md) | Roteiro Mom Test adaptado (blocos A–F + sondas por persona), aplicado às 3 personas em subagents isolados | rascunho 2026-07-28 |
| [`relatorio-entrevistas-financas-personas.md`](relatorio-entrevistas-financas-personas.md) | Relatório consolidado: kernel (2 gargalos em série), 12 dores ranqueadas, spec do "registro seguro", OST draft, anti-goals, 12 apostas + transcrições | rascunho 2026-07-28 — **a validar** |
| [`roteiro-entrevista-gestora-financeira-real.md`](roteiro-entrevista-gestora-financeira-real.md) | Roteiro Mom Test da sessão real com a gestora financeira da campanha (confirmar/derrubar as apostas; artefato-first) | **agendada — 2026-07-29** |
**Limitação metodológica (ciclo 2):** as três personas bebem do MESMO compêndio — convergência entre elas não é evidência independente. Nada entra no roadmap antes da entrevista real com a gestora e da revisão do advogado da campanha (o compêndio não é parecer jurídico).
**Decisão 2026-07-28 (origem do discovery: pedido do candidato):** não complicar o Teqo sem uma dificuldade real validada — módulo financeiro completo descartado para o ciclo 2026; a avaliação pré-validação (P0–P2 + condições de morte/vida da trilha) está no notebook do projeto e será confrontada com a entrevista real de 2026-07-29.
## Ciclo 3 — Discovery de emendas parlamentares (mandato/comunicação) (2026-07-28)
Mesmo método (literatura → personas → entrevistas sintéticas em subagents isolados, 2 rodadas com acareação → relatório → roteiro para a sessão real), aplicado ao **registro e acompanhamento das emendas parlamentares do mandato** — a visão de produto por trás (contexto, NÃO decisão): um ledger de emendas numa vertical nova `/mandato`, consumido pela campanha (`/campanha`, ex.: dossiê de município — pedido real O6) e por uma vertical de comunicação (`/comunicacao`). Quatro ângulos: o deputado (dono político), a assessoria de orçamento (operadora da planilha), a comunicação do mandato (transforma execução em anúncio) e o coordenador de campanha (consumidor — persona ancorada na evidência real de 2026-07-23, campos [R]/[S]). Notebook do projeto: `.agents/rules/projects/emendas-mandato.mdc`.
| Artefato | O quê | Status |
| -------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- |
| [`literatura-emendas-mandato-df.md`](literatura-emendas-mandato-df.md) | Compêndio dos 4 eixos (A ciclo operacional-orçamentário 2025–2026; B jurídico-eleitoral do ano; C emenda como moeda/credit claiming; D dados públicos e APIs) | rascunho 2026-07-28 |
| [`persona-emendas-parlamentar.md`](persona-emendas-parlamentar.md) | Persona sintética "Almerindo Vasconcelos" — deputado federal, 3º mandato (o principal) | rascunho 2026-07-28 |
| [`persona-emendas-assessor-orcamento.md`](persona-emendas-assessor-orcamento.md) | Persona sintética "Cristiane Damasceno" — assessora de orçamento, a operadora da planilha | rascunho 2026-07-28 |
| [`persona-emendas-coordenador-comunicacao.md`](persona-emendas-coordenador-comunicacao.md) | Persona sintética "Soraia Meirelles" — coordenadora de comunicação do mandato (eixos B/C) | rascunho 2026-07-28 |
| [`persona-emendas-coordenador-campanha.md`](persona-emendas-coordenador-campanha.md) | Persona sintética "Nivaldo Cerqueira" — coordenador-geral de campanha, consumidor de dados de emenda (**ancorada em evidência real [R]** de 2026-07-23) | rascunho 2026-07-28 |
| [`roteiro-entrevista-emendas-personas.md`](roteiro-entrevista-emendas-personas.md) | Roteiro Mom Test adaptado (blocos A–F + sondas por persona + protocolo da rodada 2/acareação) | rascunho 2026-07-28 |
| [`relatorio-entrevistas-emendas-personas.md`](relatorio-entrevistas-emendas-personas.md) | Relatório consolidado: kernel, 12 dores ranqueadas (matriz 4 personas), fluxo as-is, 7 tensões resolvidas na acareação, OST mapeado às 3 verticais, anti-goals, 14 apostas + transcrições integrais | rascunho 2026-07-28 — **a validar** |
| [`roteiro-entrevista-emendas-responsavel-real.md`](roteiro-entrevista-emendas-responsavel-real.md) | Roteiro Mom Test da sessão real com a pessoa do gabinete que mantém a planilha de emendas (artefato-first; não é auditoria) | **aguardando agendamento** |
**Limitação metodológica (ciclo 3):** as quatro personas bebem do MESMO compêndio — convergência é consistência de leitura, não evidência independente; o que informa é a divergência entre lentes de papel. Exceção parcial: a persona 4 ancora os campos [R] na entrevista real de 2026-07-23 (`docs/CUSTOMER.md`). **Nada entra no roadmap nem vira código antes da validação com a pessoa real do gabinete — inclusive a criação das verticais `/mandato` e `/comunicacao`.** O eixo B do compêndio não é parecer jurídico; qualquer registro novo da camada política passa pelo advogado antes de existir.