idea_world_labDEV JOURNAL
quinta-feira, 18 de junho de 2026

18 de junho de 2026

  • Ontem, bebi cerca de 1 litro de café em um café e hoje me senti muito mal, não consegui programar adequadamente
  • Removi todas as entregas de chunking/post‑processamento do Godot RAG criadas em 17 de junho da linha de base
    • Excluí docs_chunks.jsonl v1, docs_chunks_v2.jsonl v2 e os artefatos de catálogo/índice/mapeamento v3/v3.1
    • Também deletei os scripts preliminares de chunking/post‑processamento/validação e o rascunho inicial do chat/index RAG
    • Deixei work/godot_rag/ vazio por enquanto, para que entregas incorretas não sirvam de referência
  • Registrei o motivo da limpeza como retrospectiva
    • Julguei que o problema foi iniciar o chunking antes de analisar suficientemente a estrutura da documentação oficial
    • O objetivo de usar toda a documentação oficial do Godot acabou sendo contaminado por “API MVP” escolhida arbitrariamente pela LLM e por direções de hard‑coding/over‑engineering
    • Observei que, sem minha instrução, o ChatGPT/Codex reduziu o escopo arbitrariamente ou assumiu que havia resposta antes do término da etapa, gerando entregas subsequentes indevidas
    • Concluí que, quando a proveniência de geração da LLM, candidatos regex, base da documentação oficial e regras aprovadas pelo usuário se misturam, não podem ser usadas como critério para rotuladores ou classificadores RAG
  • Anotei novamente as deficiências da arquitetura atual
    • Camada de análise estática é fraca
    • Falta validação baseada em AST/parser de GDScript
    • O grafo de dependências do projeto Godot é insuficiente
    • Validação de execução/sintaxe é fraca
    • A taxonomia de rótulos ainda é grosseira
    • A distinção de proveniência entre artefatos gerados pela LLM e respostas verificadas é fraca
    • O design de prevenção de vazamento e remoção de duplicatas é fraco
  • Redefini a direção do próximo trabalho para a análise original de godot_docs_full
    • Em vez de recriar imediatamente RAG ou catálogo, vamos primeiro analisar outputs/godot_docs_full/pages
    • Precisamos verificar como a documentação de referência de classe, migração e tutoriais está estruturada em Markdown
    • De acordo com a estrutura da documentação oficial do Godot, devemos redesenhar qual unidade de chunk usar: por página, por seção ou por membro de API
    • Concluí que, antes do chunking, devemos primeiro definir os critérios do relatório de validação
  • Retrospectiva de desenvolvimento: docs/retrospectives/2026-06-18-godot-rag-reset.md