> ## Documentation Index
> Fetch the complete documentation index at: https://docs.migraflow.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Artefatos da CLI

> Como interpretar assessment.json, relatórios e scripts gerados.

| Arquivo                   | Responsabilidade                                               |
| ------------------------- | -------------------------------------------------------------- |
| `assessment.json`         | Manifesto estável com status, evidências, recomendações e gaps |
| `resultado_completo.json` | Resposta técnica integral da execução                          |
| `risk_report.md`          | Risk Score e Findings priorizados                              |
| `migration.sql`           | Rascunho técnico para revisão e testes                         |
| `rollback.sql`            | Rascunho de reversão a validar                                 |
| `review_report.md`        | Revisão opcional do SQL                                        |

<Note>
  Os arquivos gerados formam uma entrada para revisão consultiva. Somente itens com aprovação registrada devem ser tratados como decisão do cliente.
</Note>

## Estrutura do pacote

```text theme={null}
entrega_YYYYMMDD_HHMMSS/
├── assessment.json
├── migration.sql
├── rollback.sql
├── risk_report.md
├── review_report.md          # somente com --review
└── resultado_completo.json
```

## Regras de custódia

* armazene o pacote apenas no repositório ou cofre autorizado para o projeto;
* não versione DDL de cliente em repositórios públicos;
* preserve `resultado_completo.json` para rastreabilidade técnica;
* não edite silenciosamente `assessment.json`: registre a revisão e sua autoria;
* teste `migration.sql` e `rollback.sql` antes de qualquer janela de mudança;
* trate o log local `~/.migraflow/cli.log` como metadado do projeto.

## O que entregar ao cliente

O pacote técnico deve acompanhar a narrativa do assessment: escopo, evidências, gaps, decisões, alternativas, riscos, estimativas, critérios de aceite e responsáveis. Scripts isolados não representam a entrega completa.