---
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 Claude Code.
---

# 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 Claude da skill.

- Use `Read`, `Glob`, `Grep`, `Edit` e `Bash` conforme necessário.
- Use a skill `/markdown-format` antes de concluir qualquer tarefa que altere Markdown.
- Mantenha `.claude/skills` alinhada com `.codex/skills`, preservando instruções específicas de Claude.

## Fonte de Verdade

- Regras de Markdown: [`MARKDOWN.md`](../../../MARKDOWN.md).
- Configuração markdownlint: [`.markdownlint.json`](../../../.markdownlint.json).
- Contextos ativos: [`CLAUDE.md`](../../../CLAUDE.md) e [`AGENTS.md`](../../../AGENTS.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 ou solicite a verificação da skill `/markdown-format`.

## Checklist Final

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