documentation

name	documentation
description	Workflow mestre para gestão de documentação do SetupVibe. Use ao criar, revisar, traduzir ou sincronizar Markdown, READMEs, CHANGELOG e documentação de steps em Codex.

Documentation Workflow

Use esta skill para manter a documentação do SetupVibe sincronizada, traduzida e compatível com os padrões do projeto.

Plataforma

Esta é a versão Codex da skill.

• Use rg ou rg --files para localizar arquivos e referências.
• Use apply_patch para edições manuais em Markdown.
• Use exec_command para verificações como git diff, markdownlint, ls e rg.
• Mantenha .codex/skills alinhada com .claude/skills, preservando instruções específicas de Codex.

Fonte de Verdade

• Regras de Markdown: MARKDOWN.md.
• Configuração markdownlint: .markdownlint.json.
• Contextos ativos: AGENTS.md e CLAUDE.md.

Fluxo

1. Leia os arquivos relacionados antes de editar.
2. Quando desktop.sh ou server.sh mudarem, atualize as seções correspondentes no README.md da raiz e nos READMEs relevantes em todos os idiomas.
3. Quando a versão mudar, atualize desktop.sh, server.sh, CHANGELOG.md, README.md, AGENTS.md, CLAUDE.md e os READMEs em docs/.
4. Use inglês (docs/en) como fonte de verdade para traduções.
5. Não traduza comandos, aliases, nomes de pacote, paths ou variáveis de ambiente.
6. Verifique links relativos com ls ou leitura direta do arquivo de destino.
7. Rode a verificação da skill markdown-format antes de concluir.

Checklist Final

• Os arquivos alterados seguem MARKDOWN.md.
• AGENTS.md e CLAUDE.md continuam sincronizados nas regras compartilhadas.
• .codex/skills e .claude/skills continuam funcionalmente equivalentes.
• Não há novas referências a agentes fora de Codex e Claude como contexto ou pasta de skills ativa.