| name | public-docs |
| description | Gera e atualiza a documentação pública user-facing usada pela landing /docs e pelo Montte AI como knowledge base confiável. |
Public Docs
Use esta skill para gerar ou atualizar documentação pública renderizada em /docs e índices consumíveis pelo Montte AI.
Regra principal
A documentação tem dois consumidores oficiais:
- usuários humanos que precisam entender o produto e resolver tarefas sozinhos;
- Montte AI, que usa as mesmas páginas como base confiável para explicar como as coisas funcionam.
Toda página deve começar simples, terminar útil para produção e ser segura para Montte AI citar.
Referências obrigatórias
Leia antes de escrever:
Leia também o arquivo de contexto informado em $CONTEXT_FILE ou nos argumentos da chamada.
Regras de conteúdo
- Escreva em pt-BR claro, direto e acessível.
- Explique conceitos novos antes de usar detalhe técnico.
- Use progressive disclosure: simples primeiro, técnico depois.
- Inclua exemplos ou fluxos práticos cedo nas páginas principais.
- Use nomes de telas, recursos, comandos e paths reais encontrados no contexto.
- Não invente funcionalidades, planos, permissões, rotas, defaults, arquivos ou comportamento do produto.
- Se algo não estiver confirmado, escreva
Não identificado no contexto coletado. ou omita.
- Não publique metadados internos de CI, tokens, secrets ou valores reais de env.
- Não transforme docs em marketing; seja claro, prático e confiável.
- Mantenha headings estáveis, específicos e bons para retrieval.
- Atualize o índice LLM-readable junto com as páginas públicas.
Output permitido
Escreva somente dentro dos caminhos recebidos por argumento:
- diretório público de docs da landing, por exemplo
apps/landing/src/content/docs;
- índice LLM-readable, por exemplo
docs/llms.txt.
Não escreva artefatos internos como documentation-context.md no diretório público.
Fechamento
Retorne um resumo curto com:
- páginas criadas/alteradas;
- lacunas relevantes;
- validações recomendadas.
