Back to browse
GitHub Repository

Visual architecture modeling for AI agents. Edit C4 diagrams in a drag-and-drop editor. AI reads, modifies, and implements the same model through built-in MCP server.

62 starsTypeScript

Scryer – Visual architecture modeling for AI agents

by prohobo·Mar 16, 2026·3 points·3 comments

AI Analysis

●●SolidBig BrainNiche Gem

C4 diagrams as shared context for AI agents beats prompt drift.

Strengths
  • Contract system with expect/ask/never rules inherited down architecture hierarchy.
  • MCP server enables real-time model sync with Claude Code and Codex out of box.
  • Status tracking separates wip from ready with test verification gates.
Weaknesses
  • Architecture modeling is crowded (Lucidchart, Draw.io) — AI angle is the only differentiator.
  • MCP adoption still early; limits which agents can actually connect today.
Target Audience

Developers using AI coding assistants like Claude Code or Cursor

Similar To

Lucidchart · Structurizr · IcePanel

Post Description

I've been working on this desktop tool (FSL license, free for commercial use) for the past month because I now spend more time in a terminal prompting Claude Code instead of using a code editor. It generally works quite well if I ask the right questions, but I still often find a lot of dead code, stubs, or poor architectural choices when I finish a session, and understanding the codebase itself can be jarring after making major changes through vibecoding.

The idea for Scryer is to provide a visual surface using C4 model diagrams to share with an AI so that we both understand the actual state of a codebase, and how proposed changes would affect it. It's basically model-driven development (like UML) but adapted for the LLM era. Because of that, I think using opinionated C4 (https://c4model.com/) is the best approach:

- It's simple enough to understand without putting the developer into a coma

- There's just enough context to guide the AI coherently

- Doesn't try to replace code, but defines structural guardrails and scope

Also, I've included some newer agent-oriented methodologies like "always/ask/never" contracts (which have turned out to be very useful), task decomposition, MCP + ACP connections, etc.

This is very experimental and early, so it's quite rough around the edges, but I'm already using it in my own dev workflow and I hope you guys check it out. I honestly think this might be the year of MDE/MDD - as we abstract away the code layer, software architecture fundamentals are becoming more important than ever.

Similar Projects

Design●●Solid

Napkin – desktop app for quick diagrams, with MCP support

Napkin keeps everything local while giving you an embeddable MCP endpoint so AI agents can draw and edit diagrams at http://127.0.0.1:21420/mcp. It combines Excalidraw-style hand-drawn tooling (rough.js, connectors, grid snapping, PNG/SVG export) with a Tauri/Rust desktop shell and delta-compressed version snapshots — a neat, concrete take on AI-assisted diagramming, though its impact hinges on MCP adoption and the surrounding agent ecosystem.

Niche GemWizardry
ipcrm
303mo ago