Scenarios Index

Cada cenário é um par doc+spec lado a lado: scenarios/NNN-slug.md (Gherkin) + scenarios/NNN-slug.spec.ts (BDD). 1:1, sibling. Convenção: feature no topo, Scenario: por sub-fluxo, Given/When/Then/And em bullets. Spec traduz cada Scenario: num describe + it.

Detalhes da convenção em AGENTS.md ## Testing convention.

Green (16) — domain core estável

Cenários implementados, specs verdes, domínio in-memory.

• 000 — Custos mensais da casa — Budget aggregate + RecurringExpense entity.
• 001 — Importar fatura do cartão — Account + Invoice + Transaction VO.
• 002 — Meta de poupança do casal — Goal aggregate + Contribution VO.
• 003 — Custo variável (expected vs actual) — RecurringExpense.recordSpend + variance.
• 004 — Reconciliar fatura com expense — ExpenseReconciler Domain Service.
• 005 — Renda do casal (Household) — Household aggregate, Member Entity em shared-kernel.
• 006 — Viabilidade da meta — FeasibilityCheck cross-context.
• 007 — Persistir o orçamento — BudgetRepository port + fake + SQLite.
• 008 — Chat com agente conversacional — AgentChat stateless + read tools.
• 009 — Importar fatura Nubank via chat — multimodal PDF via ImportInvoiceTool.
• 010 — Persistir o resto — GoalRepository/HouseholdRepository/AccountRepository.
• 011 — Cotação FX viva — ExchangeRateProvider port em shared-kernel.
• 012 — Chat persistido + retrieval — AgentMemory + Mastra adapter.
• 013 — Agente escreve no domínio via write tools — propose → confirm + idempotência.
• 014 — Receita variável — Household.recordExtraIncome + forecastIncome.
• 015 — Alerts proativos do orçamento — BudgetAlerts Domain Service.

Red (14) — impl pendente

Cenários documentados (specs escritas, vermelhos), implementação pendente.

Referral + GTM (1):

• 016 — Referral attribution (sem fila) — Referrals aggregate, ReferralLink entity, attribution-only.

Agente conversacional avançado (5):

• 017 — Goal via conversa — CreateGoalTool cria meta via diálogo.
• 018 — Onboarding zero-state — chat captura member 2 + rendas + custos.
• 019 — Reminder proativo — ReminderService em planning.
• 020 — Gasto rápido sem confirm — RecordSpendTool fast-path.
• 021 — Agente admite limite — anti-hallucination, {found:false} shape.

Quality conversacional (2):

• 022 — Eval harness conversacional — EvalRunner + MelToneGuard + fixtures.
• 023 — Edge cases conversacionais — ConversationGuard preempt (frustração, loop, humano).

WhatsApp (3):

• wa-001 — Onboarding via WhatsApp — primeira msg oi cria Household direto; ref-<token> opcional dispara attribution.
• wa-002 — Fatura Nubank via WhatsApp — upload PDF via canal.
• wa-003 — Group com parceiro — chat 1:1 entre casal + bot.

Landing (3):

• landing-001 — Hero CTA direto — CTA “Falar com mel” direto pra wa.me/<bot>?text=oi.
• landing-002 — Share viral — ?ref=<token> attribution-only, sem fila.
• landing-003 — Blog + chat teaser — SEO post + CTA wa.me.

Convenção em uma linha

• “O casal observa…” → scenarios/.
• “Decidimos usar X porque Y” → decisions/.
• “Esse adapter mapeia row ↔ aggregate” → spec colocada em src/.../infrastructure/.

Cross-link: AGENTS.md ## Scenarios + ADR 003.