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.14.0

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, vinculadas à geração de tasks e de features, para alimentar as operações de IA da plataforma. Só os documentos refeitos na execução são reenviados (com --force, os sete). Se não houver produto fixado, ele gera os documentos do mesmo jeito e o comando avisa que não registrou.