Pular para o conteúdo

/ww:codebase-map

Monta o mapa do seu projeto: sete documentos em .dr_ai/codebase/ que descrevem stack, arquitetura, convenções, estrutura, testes, integrações e identidade visual. É o contexto que os outros comandos consultam depois, sem precisar reler o projeto inteiro toda vez.

/ww:codebase-map

CodebaseCompatível com ww 1.7.3

Uso

/ww:codebase-map
/ww:codebase-map --force

Argumentos

ArgumentoObrigatório?Descrição
--forceOpcionalReescreve os sete documentos, inclusive os que não mudaram desde a última vez.

Notas

Sem --force, ele só refaz os documentos cujos arquivos de origem mudaram — rodar de novo é barato.

Uma vez ao entrar no projeto, e depois sempre que mexer em algo estrutural — dependências, configuração de testes, tema, arquitetura. Rodar de novo é barato.

DocumentoO que descreve
STACKRuntime, dependências de produção e de desenvolvimento, scripts e notas do ferramental
ARCHITECTUREVisão geral, mapa de componentes, pontos de entrada e padrões de projeto
CONVENTIONSNomes de arquivo, organização de imports, nomenclatura no código, tratamento de erro, documentação e as regras próprias do projeto
STRUCTURETipo de layout, árvore de diretórios, membros do workspace, diretórios-chave e recursos compartilhados
TESTINGComo os testes rodam, suas configurações e os pontos que atrapalham execução em paralelo
INTEGRATIONSVariáveis de ambiente esperadas, endereços externos usados e SDKs
VISUALDesign system, tokens de tema, folhas de estilo globais, fontes e estilos representativos

Ele gera os sete como um conjunto — não dá para pedir um só.

Cada documento guarda a impressão digital dos arquivos que o originaram. Ao rodar de novo, o comando compara: se nada mudou, ele mantém o documento como está e te informa; se algum arquivo de origem mudou, aquele documento é refeito.

Com --force, ele ignora essa comparação e reescreve os sete.

  • Ele não toca no seu código. O comando só lê o projeto e escreve os sete documentos.
  • O mapa também vai para o WiseWork. Ele registra cada documento nas entradas de geração de IA do produto, para alimentar as operações de IA da plataforma. Se não houver produto fixado, ele gera os documentos do mesmo jeito e o comando avisa que não registrou.