kentoshimizu/sw-agent-skills/architecture-monolith

Claude Code and agent skill by kentoshimizu/sw-agent-skills

Trust tier 2
  • community
LLM review pending
Source check pending

Checking that the SKILL.md file is still in the repository.

Modular monolith architecture workflow for strong domain boundaries, transactional consistency, and operational simplicity in a single deployable. Use when teams need fast delivery and coherent data consistency with controlled complexity; do not use when independent runtime scaling boundaries are mandatory.

Install

npx vskill@latest install kentoshimizu/sw-agent-skills/architecture-monolith

SKILL.md

The same SKILL.md was published earlier as kentoshimizu/sw-agent-skills/architecture-monolith.

Architecture Monolith

Overview

Use this skill to design modular monoliths that preserve internal autonomy without introducing distributed-system overhead.

Scope Boundaries

  • Product scope or team size favors a single deployable unit.
  • Cross-domain workflows require strong transactional consistency.
  • Operational simplicity is a top constraint.

Core Judgments

  • Module boundaries: domain cohesion and dependency direction inside one codebase.
  • Internal contracts: which module APIs are allowed and how enforced.
  • Data ownership in shared database: logical ownership and write access discipline.
  • Future extraction seams: where boundaries should support later service splits.

Practitioner Heuristics

  • Treat modules like products with stable public interfaces.
  • Forbid cross-module database writes except through explicit module APIs.
  • Keep shared kernel minimal and intentionally versioned.
  • In dynamic languages, define explicit module interface types to avoid ad hoc maps and pervasive casts at boundaries.

Workflow

  1. Partition core domains into modules with clear responsibility.
  2. Define allowed dependency directions and anti-corruption boundaries.
  3. Specify module-level contracts for commands, queries, and events.
  4. Align transactional scope with module invariants.
  5. Add observability by module to expose coupling hotspots.
  6. Record extraction candidates and triggers for future decomposition.

Common Failure Modes

  • Modular monolith degrades into "big ball of mud" via unrestricted imports.
  • Shared tables bypass module contracts and break ownership.
  • Runtime simplicity hides growing conceptual complexity.

Failure Conditions

  • Stop when module boundaries cannot be enforced in code review/tooling.
  • Stop when critical invariants span modules without clear ownership.
  • Escalate when required independent scaling/deployment is no longer feasible.

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewNot runA model review is scheduled for the next rescan.

Quality evaluation

  • Task evaluationWarning, 83 of 100Marginal. 1 run. Evaluated 8 months ago.

Source

Popularity

Repository stars
4
7-day trend score
8

Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 16 Mar 2026, 8 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/kentoshimizu/sw-agent-skills/architecture-monolith/badge)](https://verified-skill.com/skills/kentoshimizu/sw-agent-skills/architecture-monolith)

Something wrong with this skill or its page? Tell us.