doc-spec
/octopus:doc-spec cria o stub de especificação que ancora todo o
trabalho downstream — design, plano e implementação. É o ponto de
entrada pra qualquer feature não trivial que precisa de um design
escrito antes de o código ser tocado.
O que resolve
Implementar sem spec gera dois problemas recorrentes: os engenheiros partem de modelos mentais diferentes, e as decisões tomadas durante a implementação não ficam registradas em lugar nenhum. Um stub de spec criado no momento certo — depois do consenso, mas antes do trabalho de design — dá ao time um único documento pra preencher junto.
doc-spec cuida da parte mecânica: achar o template certo, fazer
link com um RFC existente se houver, e colocar o arquivo no caminho
canônico. A sessão de design preenche o conteúdo.
Como funciona
- Resolve o slug — a partir do argumento que você passa, ou perguntando.
- Verifica
docs/rfcs/em busca de um RFC correspondente e o linka nos metadados do spec, se encontrado. - Escreve o stub em
docs/specs/<slug>.mda partir do template do projeto. - Informa o caminho do arquivo, o link do RFC (quando encontrado), e lembra você de preencher as seções de design.
- Em sessões interativas, oferece continuar direto na sessão de
design — responder
yencadeia no/octopus:doc-design.
Posição no pipeline
doc-rfc → doc-spec → doc-design → doc-plan
O stub do spec é o ponto de handoff entre consenso e design
detalhado. Use /octopus:doc-design pra popular as seções de
Design, Implementation Plan, Testing Strategy e Context for Agents.
Uso & parâmetros
/octopus:doc-spec [slug][slug]— nome em kebab-case pro spec (ex:checkout-revamp). Se omitido, o comando pede antes de continuar.