---
name: docs-kit
description: Instala num projeto o sistema de conhecimento do time — docs/ em 3 baldes (VIVE / ACONTECEU / GERADO), decision-log ADR, index.md por pasta, skills /journal e /handoff, regras de verdade (nada vira fato sem fonte) e seção no CLAUDE.md. Use quando o usuário disser "/docs-kit", "instala o sistema de docs", "configura journal e handoff aqui", "organiza o conhecimento desse projeto como no projeto de referência".
---

> **DEPRECATED 2026-09-22** — folded into [human-docs](../../human-docs/). Do not install. See [../README.md](../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.