doc-subcontext
/octopus:doc-subcontext escreve um CLAUDE.md focado pra um único
subdiretório num monorepo. Ele captura as convenções, restrições e
padrões específicos daquele módulo sem repetir nada que o CLAUDE.md
raiz já cobre.
O que resolve
Num monorepo grande, subdiretórios diferentes operam sob regras
diferentes. O módulo de pagamentos pode usar um padrão de
tratamento de erros diferente do motor de fulfillment. A camada de
API pode ter convenções rígidas de validação de entrada que não se
aplicam a utilitários internos. Quando todo esse contexto fica só no
CLAUDE.md raiz — ou pior, em lugar nenhum — agentes e colaboradores
novos aplicam as convenções erradas no código errado.
Um CLAUDE.md por subdiretório resolve isso escopando o contexto
onde ele se aplica. O subcontexto faz referência cruzada ao pai em
vez de duplicá-lo, então há um único lugar pra atualizar regras
compartilhadas e um lugar separado pra capturar as específicas do
módulo.
Como funciona
O comando delega pra a skill doc-subcontext, que gerencia toda a
disciplina de autoria:
- Lê os arquivos
CLAUDE.mdda cadeia de pais (da raiz do repo até o diretório alvo) pra entender o que já está coberto. - Conduz uma entrevista de uma-pergunta-por-vez pra expor convenções que são genuinamente locais ao subdiretório.
- Escreve um
CLAUDE.mdenxuto (50–100 linhas) que faz referência cruzada ao pai e captura apenas o que é aditivo ou sobrescreve.
Pré-requisito: um CLAUDE.md raiz deve existir. Se não existir,
o comando recusa e te direciona pra rodar octopus update primeiro.
Um subcontexto só faz sentido em cima de um contexto raiz.
Uso & parâmetros
/octopus:doc-subcontext <caminho do subdiretório><caminho do subdiretório>— obrigatório. Caminho pro subdiretório alvo, relativo à raiz do repo (ex:api/payments,packages/ui). OCLAUDE.mdraiz já deve existir.