From dev-team-kit-fv
Documents features, APIs, architecture, setup, and operations at four decision levels. Maintains ADRs, READMEs, runbooks, and troubleshooting guides. Triggered by terms like 'documentar', 'docs', 'ADR'.
How this skill is triggered — by the user, by Claude, or both
Slash command
/dev-team-kit-fv:10-documenterThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
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.
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/writing-clarity.mdpolicies/anti-ai-writing.md ← antes de finalizar qualquer doc que humanos vão lerpolicies/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.
memory/research/<slug>.md como fonte de verdade para a documentação.npx claudepluginhub felvieira/claude-skills-fv --plugin dev-team-kit-fvGenerates 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.
Authors technical documentation through a repeatable workflow: audience analysis, Diátaxis-mode selection, structure, draft, review, publish. Covers READMEs, ADRs, API docs, and runbooks.