Commit Graph

3 Commits

  • fix: address all 24 prompt engineering audit issues across 7 agents
    knowledge-graph-guide.md (6 issues):
    - Fix node types (5→16), edge types (18→29), tour schema (nodeId→nodeIds)
    - Add domain graph documentation, jq examples, expand content
    
    graph-reviewer.md (5 issues):
    - Add domain node types (domain/flow/step) and edge types (contains_flow/flow_step/cross_domain)
    - Relax layers/tour requirements for domain graphs
    - Soften Check 8 (remove overly strict config/resource/endpoint checks)
    
    domain-analyzer.md (6 issues):
    - Add input format specification, output file path, writing results section
    - Add critical constraints section with validation rules
    - Fix flow_step weight scheme to stay within 0-1 range
    - Change from "respond with JSON" to write-to-file pattern
    
    file-analyzer.md (6 issues):
    - Fix node type count description (13→accurate text)
    - Recommend Node.js over bash for extraction scripts
    - Replace "validate mentally" with actionable JSON validation instruction
    - Clarify exports vs contains edge relationship
    - Trim redundant tag guidance section
    - Document why direction is always forward
    
    architecture-analyzer.md (4 issues):
    - Allow Python fallback for script language
    - Clarify allEdges excludes sub-file edges
    - Define "common prefix" algorithm for directory grouping
    - Add layer count validation and empty group handling
    
    tour-builder.md (2 issues):
    - Fix BFS to start from code entry point, not README
    - Allow Python fallback for script language
    
    project-scanner.md (4 issues):
    - Clarify exclusions match full directory segments, not substrings
    - Stop excluding *.d.ts (may be hand-written)
    - Add .env secret leak warning
    - Document $PROJECT_ROOT variable, prefer Node.js
    
    Cross-agent (3 issues):
    - Consistent "prefer Node.js; fall back to Python" across all agents
    - Schema type/count consistency across all agents
    - Domain graph compatibility with graph-reviewer
    
    Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
  • fix: normalize LLM-generated type aliases before schema validation
    LLMs systematically abbreviate node types (e.g. "func" instead of
    "function") and edge types (e.g. "extends" instead of "inherits"),
    causing dashboard validation failures. This combines two fixes:
    
    Option A: Rename the ambiguous `func:` ID prefix to `function:` across
    all prompts, source code, tests, and example data so LLMs see consistent
    naming. Also fix `relates_to` ghost edge type in django.md.
    
    Option B: Add NODE_TYPE_ALIASES and EDGE_TYPE_ALIASES normalization maps
    in schema.ts that transparently correct common abbreviations before Zod
    validation, as a runtime safety net.
    
    Closes #36
    
    Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>