Knowledge Architect

Fase 2: LINK — Construção do Grafo

1. Documentação em Mermaid: Criar ou atualizar o KNOWLEDGE-MAP.mermaid (Mapa da Mente do projeto).
2. Cross-Referencing: Inserir links bidirecionais ([[link]]) em arquivos Markdown para facilitar o caminhamento manual e automático.
3. Indexação de Contexto: Manter um índice de "vizinhos próximos" para entidades críticas.

Fase 3: TRAVERSE — Navegação Inteligente

1. Caminhamento de Impacto: Antes de uma alteração, seguir as conexões no grafo para identificar efeitos colaterais em módulos distantes.
2. Descoberta de Contexto: Usar o grafo para decidir quais arquivos adicionais devem ser lidos (além do arquivo alvo) para obter a visão completa.
3. Poda de Irrelevância: Ignorar ramos do grafo que não possuem conexão semântica com a tarefa atual, economizando tokens.

Fase 4: PRUNE — Evolução e Limpeza

1. Refatoração de Conhecimento: Remover conexões obsoletas ou entidades deletadas do código.
2. Consolidação de Clusters: Agrupar nós muito conectados em "Módulos de Conhecimento" para simplificar a visão macro.
3. Sync com Harness: Exportar o mapa de relações para que o harness-expert possa realizar a reidratação relacional.

Output Structure

A execução desta skill resulta nos seguintes artefatos mandatórios (geralmente em .specs/knowledge/ ou na raiz da skill):

Quality Rules

• Gold Standard Benchmark: Utilize os exemplos em examples/gold-standard/ como referência para mapeamentos complexos.
• Relation over Content: Foque em como as coisas se conectam, não apenas no que elas fazem.
• Visual-First: Todo grafo complexo deve ser visualizável via Mermaid.
• Bi-directional: Sempre que possível, as relações devem ser mapeadas nos dois sentidos (quem usa e quem é usado).
• KISS Graphing: Evite criar nós para detalhes triviais; foque em componentes arquiteturais e requisitos.

Prohibited

• NUNCA crie grafos que não possam ser renderizados (erros de sintaxe Mermaid).
• NUNCA mantenha relações órfãs (nós sem conexões relevantes).
• NUNCA use ferramentas externas de banco de dados de grafos; tudo deve ser persistido em arquivos de texto no repositório.
• NUNCA ignore a atualização do mapa após grandes refatorações de código.