← ClaudeAtlas

start-doclisted

Cria e evolui a documentação AUTORAL de um projeto — as metas de qualidade, as restrições, o contexto/fronteiras, a estratégia e o glossário. É a entrevista, não a mineração: a skill pergunta e grava a resposta do humano, NUNCA inventa conteúdo. Terceira skill do plugin project-doc, ao lado do /project-doc (minera tudo) e do /doc-touch (incremental). Use quando Pedro diz "/start-doc", "vamos conceber", "começando um projeto novo", "documenta a intenção", "quais são as metas do sistema", "esse projeto não tem doc nenhuma". Dispare PROATIVAMENTE quando: o projeto não tem CLAUDE.md nem .claude/docs/; o projeto está nascendo (repositório novo, poucos commits); existe doc minerada mas os documentos autorais estão ausentes ou com lacunas; ou o gate de plano barrou um plano por falta de documentação. A entrevista vem SEMPRE antes da mineração — o porquê guia tudo que vem depois.
pedroberaldo87/pedro-plugins · ★ 0 · AI & Automation · score 62
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