docs-kit

Imported from gbueno10/claude-skills (deprecated/docs-kit/SKILL.md). Install upstream with npx skills add gbueno10/claude-skills --skill docs-kit. Copyright stays with the author.

DEPRECATED 2026-09-22 — folded into human-docs. Do not install. See ../README.md.

docs-kit — instalar o sistema de conhecimento num projeto

Objetivo: em uma passada, deixar o projeto com a mesma disciplina de documentação do projeto de referência: pastas com propósito explícito, decisões num log único com fonte, diário imutável, handoffs retomáveis, e regras que impedem suposição de virar "verdade".

Leia README.md desta skill antes de instalar — ele explica a filosofia e é o texto pra mostrar ao usuário se ele pedir "me explica o sistema".

Passos de instalação

Todos os arquivos-fonte estão em templates/ e skills/ nesta pasta (~/.claude/skills/docs-kit/).

1. Perguntar 3 coisas (ou inferir do repo e confirmar): nome do projeto, 1 frase do que é, link do epic/board se houver. Só isso — o resto vem preenchido.
2. Criar docs/ copiando templates/:
   • templates/docs-index.md → docs/index.md (substituir {{PROJECT}}, {{ONE_LINER}}, {{EPIC_LINK}}).
   • templates/indexes/*.md → docs/<pasta>/index.md para context, decisions, features, research, journal, meetings, handoff, archive. Criar as pastas.
   • templates/decision-log.md → docs/decisions/decision-log.md.
   • templates/features-backlog.md → docs/features/backlog.md.
   • Se já existe docs/: NÃO sobrescrever. Listar o que existe, propor onde cada arquivo cai nos 3 baldes, e só criar o que falta. Movimentos de arquivo só com ok do usuário.
3. Instalar skills do projeto: copiar skills/journal/ e skills/handoff/ para .claude/skills/ do repo. Se já existir skill com o mesmo nome, mostrar diff e perguntar.
4. CLAUDE.md: anexar templates/claude-md-section.md ao final do CLAUDE.md do projeto (criar se não existir). Não tocar em seções existentes.
5. Memória: gravar memória feedback no diretório de memória deste projeto, nome docs-truth-discipline, com o conteúdo de templates/memory-docs-truth-discipline.md. Adicionar linha no MEMORY.md.
6. Mostrar ao usuário a árvore criada e sugerir commit docs: instala sistema de docs (docs-kit) — não commitar sem pedido.

Regras que a skill instalada impõe (resumo — detalhe em docs/index.md)

1. Toda pasta tem index.md: propósito em 1 frase + o que tem + o que NÃO pertence ali.
2. 3 baldes: VIVE (features/, context/, decisions/ — edita no lugar), ACONTECEU (journal/, meetings/, handoff/ — datado, imutável), GERADO (research/ — regenera, não edita à mão).
3. Decisão SÓ em decisions/decision-log.md, com status ADR e Fonte. Sem fonte = Proposto, nunca Aceito.
4. Fato não confirmado leva tag 🟡 PROPOSTO ou ⏳ AGUARDANDO(quem).
5. Nada morre silenciosamente: superado vai pra archive/ com nota do que substituiu.
6. Antes de criar doc novo: existe pasta com esse propósito? O index dela aceita? Na dúvida, journal.

Idioma

Templates em português (padrão dos docs/ do time). Se o projeto for em inglês, traduzir os templates na instalação mantendo a estrutura e os nomes de pasta.