excalidash-modular-monolith

Generates and validates modular-monolith architecture diagrams in Excalidraw via MCP tools.

2|Updated Jun 17, 2026
One-click install
npx skills add https://github.com/gabedsam01/excalidash-v2 --skill excalidash-modular-monolith-gabedsam01
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: excalidash-modular-monolith
Source: https://github.com/gabedsam01/excalidash-v2/tree/main/skills/excalidash/excalidash-modular-monolith
Command: npx skills add https://github.com/gabedsam01/excalidash-v2 --skill excalidash-modular-monolith-gabedsam01

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Drawing or auditing a modular-monolith architecture by hand is error-prone: modules drift outside the deployable frame, a second database creeps in, or one module reaches into another module's tables. This Skill produces a correct modular-monolith diagram — one application-shell frame containing module cards over a single shared database with per-module schemas — and enforces the architectural invariants automatically. ## Core Features & Use Cases - Diagram generation: Creates the full modular-monolith layout (outer shell frame, module cards with public-API stubs, in-process event bus, one shared DB cylinder split into schema lanes) through the Excalidash MCP server, including reverse-engineering modules and schema ownership from a repository analysis. - Architecture validation: Runs lint, score, repair, and validate_architecture loops to guarantee one deployable, one shared database, no cross-schema reach-throughs, no module cycles, and a score of at least 95 with zero hard blockers. - Secrets hygiene: Redacts shared-database connection strings and API keys to typed placeholders before any tool call and re-scans exports. - Use Case: Ask to draw "Acme Commerce — one Spring Boot app with Catalog, Ordering, Billing, Identity, and Notifications modules over one shared Postgres" and receive a validated, exportable Excalidraw diagram proving each module owns only its own schema. ## Quick Start Ask the assistant to draw your application as a modular monolith, naming the single deployable, its modules, the allowed cross-module dependencies, and the shared database with its per-module schemas.

Frequently Asked Questions about excalidash-modular-monolith

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I draw a modular monolith architecture diagram?

Describe your single deployable, its modules with their public APIs, the allowed cross-module dependencies, and the one shared database with per-module schemas. The skill generates the shell frame, module cards, in-process bus, and shared DB cylinder via the Excalidash MCP tools, then validates the result.

How to check if modules reach into each other's database tables?

Run the validate_architecture step, which reports reachThroughs when a module's persistence edge lands on another module's schema. The fix routes the call through the other module's public API instead of its tables, then re-lints and re-scores the drawing.

Can I generate a modular monolith diagram from an existing repository?

Yes, the create_from_repo_analysis path reverse-engineers modules from package structure and schema ownership from migration folders. It surfaces warnings such as cross-schema queries, which the workflow then corrects in the diagram.

When should I use microservices topology instead of a modular monolith diagram?

Use the microservices topology skill when the system has many independently deployed services each with its own database behind a gateway. A modular monolith is exactly one deployable process and one shared database partitioned into per-module schemas.

What quality score must a modular monolith diagram reach?

The diagram must score at least 95 with zero hard blockers such as arrow-text intersections, frame title overlaps, or items outside the shell frame. Repair loops are mandatory below that threshold, and any pass that lowers the score is rolled back.