> For the complete documentation index, see [llms.txt](https://lunarie.gitbook.io/lunarie-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://lunarie.gitbook.io/lunarie-docs/desenvolvimento/01-fluxo-de-desenvolvimento.md).

# Fluxo de Desenvolvimento

> **Última atualização:** 08/10/2026 Descreve o fluxo praticado hoje (beta, uma desenvolvedora com apoio do Claude), e não um processo ideal. As etapas de publicação estão em [Ambientes](/lunarie-docs/arquitetura/03-ambientes.md).

## Etapas

| Etapa                | O que acontece                                                                                                                                                                            | Registro                                                                         |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| 1. Tarefa            | Todo trabalho nasce de uma tarefa no Asana. Nada é feito sem tarefa. Tarefas com decisão em aberto ficam fora do desenvolvimento até serem decididas.                                     | Asana                                                                            |
| 2. Investigação      | Antes de propor qualquer mudança, o código, o banco (SQL) e os logs são consultados. Na dúvida, vale o que o código e o banco mostram, e não a memória nem a documentação.                |                                                                                  |
| 3. Decisão           | Se a mudança é estrutural, vira um ADR (contexto, alternativas, decisão e consequências).                                                                                                 | [Decisões Arquiteturais](/lunarie-docs/arquitetura/06-decisoes-arquiteturais.md) |
| 4. Implementação     | Edição direto no repositório e push. A edição pelo Lovable fica para o que não dá para fazer fora dele, porque custa créditos e o Lovable não é confiável para relatar o que implementou. | Git                                                                              |
| 5. Verificação local | `tsc`, `eslint` e `prettier` passam antes do push. Mudança de componente atualiza a story do Storybook.                                                                                   |                                                                                  |
| 6. Publicação        | Push, sincronização do Lovable e publicação manual. Edge Functions seguem pelo GitHub Actions. Migrações de banco são aplicadas direto.                                                   | [Deploy](/lunarie-docs/desenvolvimento/06-deploy.md)                             |
| 7. Validação         | A fundadora testa o fluxo alterado em produção.                                                                                                                                           |                                                                                  |
| 8. Documentação      | A documentação e o ADR acompanham o código. Quando os dois divergem, o produto é a referência e o texto é corrigido.                                                                      | `lunarie-docs`                                                                   |

## Regras que valem em todas as etapas

* **Regra crítica no banco.** Nenhuma regra de negócio importante vive só na interface ou numa Edge Function.
* **Impacto em dados reais pede cuidado dobrado.** Backup e rollback são pensados antes de qualquer mudança que apague ou altere dados de pessoas.
* **Segredos nunca entram em código nem em chat.**
* **Histórico publicado não é reescrito.** Sem `force push`, `rebase` ou `amend` em commits já enviados, porque o Lovable sincroniza o histórico.
* **O que faz parte da tarefa é só o que foi pedido.** Itens descobertos no caminho viram nova tarefa, e não são corrigidos sem aval.

## Documentos relacionados

* [Critérios de Priorização](/lunarie-docs/roadmap/04-criterios-de-priorizacao.md)
* [Controle de Versão](/lunarie-docs/desenvolvimento/03-controle-de-versao.md)
* [Testes](/lunarie-docs/desenvolvimento/05-testes.md)
* [Requisitos](/lunarie-docs/requisitos/04-requisitos.md)