> 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/prompts-e-ia/01-estrategia-de-uso-de-ia.md).

# Estratégia de Uso de IA

> **Última atualização:** 08/10/2026 Como a IA é usada para construir a Lunarie hoje. Conferido com o fluxo de trabalho dos últimos meses e com os ADRs (002, 086 e 090).

## Papel da IA

A IA trabalha como assistente de desenvolvimento, de documentação e de auditoria. A fundadora decide, e a IA propõe, implementa e verifica o que foi pedido. Nenhuma decisão de produto ou de arquitetura é tomada pela IA sozinha.

## Ferramentas

| Ferramenta      | Uso hoje                                                                                                                                                                                                                                                                    |
| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Claude (Cowork) | Principal. Lê o repositório e o banco, implementa mudanças, escreve migrações, faz auditorias e mantém a documentação. Trabalha com os conectores do projeto (Supabase, GitHub, Asana, Figma) e com as skills da [Squad](/lunarie-docs/prompts-e-ia/06-squad-de-skills.md). |
| Lovable         | Hospedagem e publicação do app e da landing. A edição pelo Lovable ficou secundária: custa créditos, e ele não é confiável para relatar o que implementou (ADR-002).                                                                                                        |
| Figma           | Tokens, componentes e telas do design system, espelhando o código.                                                                                                                                                                                                          |
| Storybook       | Catálogo do design system, consumido por pessoas e pela IA ([Componentes](/lunarie-docs/experiencia-do-usuario/05-componentes.md)).                                                                                                                                         |

## Princípios

1. **A documentação é a fonte de verdade para a IA, e o código é a fonte de verdade para a documentação.** Quando divergem, o produto prevalece e o texto é corrigido (ADR-086).
2. **Verificar antes de confiar.** Toda mudança feita por IA é conferida no código, no banco ou por `tsc`, e não pelo relato da ferramenta.
3. **A IA propõe, a pessoa decide.** Decisões estruturais viram ADR. O que a IA encontra fora do escopo vira tarefa, e não é corrigido sem aval.
4. **Sem segredos no chat.** Chaves e tokens só entram por variáveis de ambiente.
5. **O push e a publicação são da fundadora.** A IA entrega o commit pronto e o comando.
6. **Contexto no lugar certo.** O conhecimento do projeto vive nas skills e nesta documentação, e não só na memória de uma conversa.

## O que a IA não faz

* Enviar código ao GitHub ou publicar no Lovable.
* Apagar dados de pessoas ou alterar o banco de produção sem pedido explícito.
* Escolher entre alternativas de produto.

## Documentos relacionados

* [Padrão de Prompts](/lunarie-docs/prompts-e-ia/02-padrao-de-prompts.md)
* [Squad de Skills](/lunarie-docs/prompts-e-ia/06-squad-de-skills.md)
* [Fluxo de Desenvolvimento](/lunarie-docs/desenvolvimento/01-fluxo-de-desenvolvimento.md)