From dev-team-kit-fv
Generates and updates documentation for features, APIs, architecture, setup, operations, and decisions using 4 structured levels. Ideal for READMEs, ADRs, runbooks, and troubleshooting guides.
npx claudepluginhub felvieira/claude-skills-fvThis skill uses the workspace's default tool permissions.
Documentação existe para responder perguntas antes que alguém precise fazer a pergunta. Cada nível de decisão tem seu próprio tipo de documentação.
Generates or updates documentation for code, APIs, or systems including READMEs, API references, inline comments, technical guides, and ADRs.
Creates Architecture Decision Records (ADRs) and documentation for architectural decisions, API changes, features, and codebase context that future engineers need.
Guides project documentation structure, file organization, content requirements, and best practices for README, ARCHITECTURE.md, API docs, CHANGELOG, CONTRIBUTING. Use for creating docs, project setup, technical docs.
Share bugs, ideas, or general feedback.
Documentação existe para responder perguntas antes que alguém precise fazer a pergunta. Cada nível de decisão tem seu próprio tipo de documentação.
Esta skill herda comportamento base de GLOBAL.md e destas policies:
policies/execution.mdpolicies/handoffs.mdpolicies/persistence.mdpolicies/token-efficiency.mdpolicies/evals.mdSe houver conflito entre instrucoes, a hierarquia global do kit prevalece.
Para templates completos de feature, ADR, runbook e playbook, consultar docs/skill-guides/documenter-templates.md apenas quando necessario.
Responde: qual problema resolve, para quem, com quais regras.
Conteúdo obrigatório:
Responde: qual endpoint chamar, com quais dados, e o que esperar de volta.
Conteúdo obrigatório:
Responde: qual a estrutura, quais padrões, por que essa decisão técnica.
Conteúdo obrigatório:
Responde: como subir, como deployar, como monitorar, como resolver problemas.
Conteúdo obrigatório:
Manter runbooks em docs/ops/runbooks/.
Para templates completos de runbook e playbook, consultar docs/skill-guides/documenter-templates.md.
docs/
README.md
features/
<feature-name>/
README.md
rules.md
flow.md
api.md
ui.md
architecture/
overview.md
frontend.md
backend.md
decisions/
adr-NNN-*.md
api/
README.md
errors.md
pagination.md
ops/
setup.md
deploy.md
observability.md
context/
current-focus.md
history.md
plans/
O diretório context/ é gerenciado pelo Context Manager. O diretório plans/ armazena planos de implementação.
Usar templates/doc-update.md para atualizacao curta e docs/skill-guides/documenter-templates.md quando precisar dos templates completos de feature, ADR, runbook e playbook.
rules.md, não repita em api.md. Faça referênciaDocumentação é escrita DURANTE o desenvolvimento, não depois.
Documentação escrita depois do fato é incompleta por definição. Ninguém lembra de tudo.
Codigo bem escrito prioriza clareza. Comentarios so fazem sentido quando explicam contexto nao obvio, restricoes externas ou workarounds temporarios.
Exceções permitidas:
Tudo mais é sinal de que o código precisa de refatoração, não de comentário.
Seguir policies/handoffs.md e, quando util, templates/doc-update.md.