# Pacote de Prompts — Adaptador de Planilhas Elo Pro

Este pacote foi preparado para construir o MVP do **Adaptador de Planilhas** dentro do ecossistema **Elo Pro** usando Cursor.

## Como usar

1. Coloque esta pasta dentro do repositório (por exemplo, `docs/cursor-prompts/spreadsheet-adapter/`) ou mantenha-a aberta ao lado do projeto.
2. Execute os prompts na ordem numérica. Não envie todos de uma vez.
3. Em cada etapa, peça ao Cursor para **primeiro inspecionar o repositório e apresentar um plano curto**, e somente então alterar código.
4. Após cada pacote, rode lint, typecheck e testes pertinentes, revise o diff e faça um commit antes de seguir.
5. Se o repositório Elo Pro já tiver implementações equivalentes (auth, workspace, RLS, design system, audit log, feature flags, Sentry, Supabase clients), **reutilize-as**. Não crie versões paralelas.
6. As pendências arquiteturais ainda não decididas (storage, job runner, TTL, biblioteca XLSX, soft delete) devem ser implementadas somente se houver uma decisão existente no repositório; caso contrário, documente a decisão necessária e use uma abstração que permita troca posterior.

## Ordem recomendada

- `01-MASTER-CONTEXT.md` — contexto fixo e regras que o agente deve respeitar em todas as etapas.
- `02-REPO-AUDIT-PLAN.md` — auditoria do repositório Elo Pro e plano de integração.
- `03-FOUNDATION-ROUTES-FEATURE-FLAG.md` — esqueleto do módulo e rotas.
- `04-AUTH-WORKSPACE-PERMISSIONS-RLS.md` — identidade única, workspace, autorização e RLS.
- `05-DATABASE-MIGRATIONS.md` — schema do módulo.
- `06-DESIGN-SYSTEM-APP-SHELL.md` — UI Elo Pro, shell e estados comuns.
- `07-MODEL-MANAGEMENT.md` — gestão de modelos e configuração de upload.
- `08-SOURCE-UPLOAD-VALIDATION.md` — fontes, validação, abas e cabeçalho.
- `09-MAPPING-PREVIEW.md` — mapeamento 1:1 e revisão.
- `10-JOBS-PROCESSING-EXPORTS.md` — jobs, processamento sequencial e saídas.
- `11-REDIS-PROGRESS-RESILIENCE.md` — lock, progresso, idempotência e falhas.
- `12-AUDIT-SENTRY-SECURITY.md` — auditoria, observabilidade e hardening.
- `13-TESTING-QA.md` — testes unitários, integração, RLS, E2E e performance.
- `14-DEPLOYMENT-OPERATIONS.md` — staging, migrations, feature flag e rollback.
- `15-FINAL-GAP-REVIEW.md` — revisão final contra o escopo.

## Regra de precedência

Quando houver conflito de informação, siga:

1. Regra de negócio validada do produto.
2. Arquitetura e segurança já existentes do Elo Pro.
3. Comportamento útil comprovado pelo primeiro MVP.
4. Documento V2 do Adaptador.
5. Fluxos/protótipos antigos.

Não invente regra de negócio para preencher lacunas. Registre a lacuna em `docs/decisions/` ou em uma seção `OPEN DECISIONS` no relatório da etapa.