cyberneticlibrary

Map codebase architecture and dependencies

architecture-knowledge-graphskillsetup L2118
BV-Venky/excalidraw-architect-mcp
What it does

Map codebase services and dependencies into persistent knowledge graph

Best for

Creating an auditable, queryable service map across multiple repos when you need to track deployment units and their communication patterns.

Inputs
  • · service list with component_type/domain/owner
  • · communication edges (REST/gRPC/Kafka/DB)
Outputs
  • · architecture.md knowledge graph
  • · rendered Excalidraw diagrams
  • · lint reports (cycles, orphans)
Requires
  • · Excalidraw Architect MCP (kg_* tools)
  • · Read access to codebase
Preconditions

Discovery pass (identify all services) before linking pass (add edges); stable kebab-case IDs across sessions

Failure modes

Parallel edges not supported (same source/target pair replaces); id drift silently corrupts cumulative graph; dangling references fail lint

Trust signals
  • · Persistent graph (cumulative)
  • · Multi-pass workflow prevents errors
  • · Lint catches cycles and dangling refs
  • · Domain-based rendering for readability