@0xlayne/graph-ipo-harness

MCP Server for GraphIPO — a design-first, AI-assisted software engineering methodology.

⚠️ Token Usage Advisory: GraphIPO's structured design process (discovery interview, node creation, context injection, auditing) consumes more tokens during the design phase than a direct "just build it" approach. However, for medium to large projects, the upfront design investment typically pays off by reducing rework, ambiguity, and wasted implementation cycles. For very small or throwaway projects, consider whether the design overhead is justified.

What is GraphIPO?

GraphIPO lets you design software architecture visually as a graph of Input-Process-Output nodes, then delegate implementation to AI agents that follow your design exactly.

Quick Start

Add to your IDE's MCP configuration:

{
  "mcpServers": {
    "graph-ipo": {
      "command": "npx",
      "args": ["-y", "@0xlayne/graph-ipo-harness"]
    }
  }
}

Then tell your AI agent:

"I want to build a task management app. Use start_discovery to begin."

Features

• 21 MCP tools for architecture design, node management, and code auditing
• Guided discovery — the agent interviews you and generates the architecture
• Existing project onboarding — scan code and import it as a design graph
• Per-node lifecycle tracking (Design → Specified → Implemented → Audited)
• Bidirectional Canvas UI — visual editing with real-time WebSocket sync
• Tree-Sitter AST auditing — verify code matches design
• Multi-agent support — node locking and task assignment

Links

• GitHub
• Documentation

License

MIT