> 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/05-prompts-de-documentacao.md).

# Prompts de Documentação

> **Última atualização:** 08/10/2026 Como pedir à IA que crie ou atualize a documentação, seguindo o [Padrão de Prompts](/lunarie-docs/prompts-e-ia/02-padrao-de-prompts.md). Skills: `lunarie-technical-writer` e `ux-writing`.

## Regras fixas

* A fonte é o código, o banco e os ADRs. A documentação só descreve o que existe. Se algo não pôde ser verificado, vai para "pontos a decidir", não para a página.
* Uma informação mora em uma página só. As outras páginas apontam para ela.
* Uma decisão estrutural vira ADR em [Decisões Arquiteturais](/lunarie-docs/arquitetura/06-decisoes-arquiteturais.md).
* Os textos usam linguagem neutra e seguem as regras do `ux-writing`.
* A IA altera apenas arquivos em `docs/`. Código e banco ficam como estão, e o que for achado vira relatório.
* Cada página tem data de última atualização no topo, e os links relativos são conferidos.

## Documentar uma mudança

> Mudamos \[o quê]. Identifique as páginas de `docs/` afetadas, confira cada afirmação no código e no banco, atualize o texto e o ADR. Liste o que divergia e o que ficou em aberto.

**Volta:** páginas alteradas, o que estava errado e os pontos a decidir.

## Auditar uma seção

> Revise a seção \[nome] página por página. Para cada página: verifique contra o código e o banco, remova o que está repetido ou obsoleto, reescreva e me envie o resultado com o comando de commit. Só siga para a próxima depois da minha confirmação.

**Volta:** uma página por vez, com o que estava errado, o que mudou, os pontos a decidir e o commit da página.

## Criar página a partir de template

> Crie \[documento] com o template de `templates/` correspondente. Preencha só com informação verificada e deixe explícito o que ainda não existe.

Os templates ficam na pasta `templates/` do repositório (fora do GitBook) e cobrem arquitetura, produto e UX.

## Fechamento

> Confira os links relativos e a data de cada página alterada. Dê o comando de commit limitado a essas páginas, sem enviar ao GitHub.

## Documentos relacionados

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