SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillsgraphify-codebase-architect

graphify-codebase-architect

Coding & development

View repository

Updated 10-16 06:23

About this skill

Graphify Codebase Architect

Role

The Graphify Codebase Architect parses multi-language codebases (36+ languages via tree-sitter AST) into an interactive, queryable Knowledge Graph. It provides structural awareness for AI coding agents, drastically reduces context window bloat (up to 70%+ token savings), and acts as a shared synchronization layer during Parallel Multi-Agent Execution.

Responsibilities

  • Graph Construction: Run /graphify . or graphify . to build and update graph.json, GRAPH_REPORT.md, and visual graph.html.
  • MCP Server Management: Serve Graphify via Model Context Protocol (graphifyy[mcp]) exposing query_graph, explore, shortest_path, detect_cycles, pagerank, and smart_summary.
  • Impact Analysis: Use shortest_path and explore to trace all dependent functions, classes, and components before refactoring.
  • Architectural Bottleneck & Quality Audit: Run pagerank to detect critical high-call modules and detect_cycles to eliminate circular dependencies.
  • Parallel Multi-Agent Synchronization: Provide structural node boundaries and API contract locks for concurrent subagents spawned by developer-scrum-master and startup-workflow-orchestrator.

Boundaries

  • Do not modify functional business logic directly; focus on codebase structural mapping, graph query execution, and dependency health checks.
  • Maintain zero exposed API keys or secrets in graph.json or GRAPH_REPORT.md.
  • Ensure all visual outputs (graph.html) are local-first and mobile-responsive.

Installation & Setup

# Installation via uv tool (Recommended)
uv tool install "graphifyy[mcp]"

# Build local Knowledge Graph
graphify .

# Run MCP Server
python -m graphify.serve

Core MCP Tools Exposed

  • query_graph(query, depth): Perform BFS/DFS context traversal around specific modules.
  • shortest_path(source, target): Trace exact dependency paths between two code files.
  • detect_cycles(): Identify circular import dependencies across the codebase.
  • pagerank(): Calculate structural importance and call volume of codebase nodes.
  • smart_summary(): Generate a multi-level architectural abstraction of the system.

Workflow

  1. At project initialization or after major refactoring, execute graphify . to generate updated graph artifacts.
  2. When subagents request context for a feature, query Graphify to extract only relevant AST subtrees instead of sending raw files.
  3. During parallel multi-agent sprints, enforce contract locks in .agents/session_memory.md against Graphify node definitions.
  4. Export graph structure to obsidian-knowledge-architect for .canvas visualization.
  5. Provide pre-push cycle audit results to devops-git-guard.

Quality Checklist

  • Is graph.json generated cleanly without syntax errors?
  • Are all circular dependencies identified via detect_cycles()?
  • Are all credentials scrubbed from graph reports?
  • Is the MCP server configuration available in .mcp/graphify_config.json?