start-doclisted
Install: claude install-skill pedroberaldo87/pedro-plugins
# start-doc — a documentação que só o humano tem
## O que é
O `/project-doc` minera: lê arquivos, git log, transcripts e grafo, e escreve o que o código já sabe.
Existe uma classe de documentação que **nenhuma mineração produz**, porque a informação não está em
arquivo nenhum — está na cabeça de quem decidiu:
- o que o sistema **prioriza** quando não dá para ter tudo;
- o que é **inegociável**, e por quê;
- onde o sistema **termina** e o mundo começa;
- as poucas decisões que explicam o **formato** de tudo;
- o vocabulário que **só a equipe** usa.
Esta skill produz esses cinco. Ela **entrevista**.
### O trio
| Skill | O que faz | Quando |
|---|---|---|
| **`/start-doc`** | entrevista o humano, escreve o autoral | concepção, e sempre que o autoral tiver lacuna |
| **`/project-doc`** | minera tudo e re-projeta a doc inteira | mudança estrutural, drift amplo, doc nunca minerada |
| **`/doc-touch`** | re-projeta só os docs que o diff tocou | entre FULLs, depois de um ciclo de código |
**A entrevista vem primeiro.** Num projeto sem documentação, `/start-doc` roda antes da mineração —
mesmo num codebase grande e antigo. O motivo é que o resultado da entrevista **guia a sessão inteira**,
não só o arquivo: sem saber o que o sistema prioriza, toda decisão posterior recomeça do zero.
## A REGRA DURA — a skill pergunta, a skill não responde
**Nunca preencha um campo autoral com conteúdo inferido.** Documentação de intenção fabricada por
máquina é ficção com aparência de autorid