modularity-design

Designs modular architectures from functional requirements and generates module design documents and test specifications.

9|Updated Jul 17, 2026
One-click install
npx skills add https://github.com/Yassimba/loom --skill modularity-design-yassimba
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: modularity-design
Source: https://github.com/Yassimba/loom/tree/main/skills/modularity-design
Command: npx skills add https://github.com/Yassimba/loom --skill modularity-design-yassimba

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning functional requirements into a sound modular architecture is hard: teams often end up with distributed monoliths or big balls of mud because coupling decisions are made ad hoc. This Skill guides an agent through a structured, approval-gated process that produces validated module boundaries, design documents, and test specifications grounded in the Balanced Coupling model. ## Core Features & Use Cases - Coupling-aware architecture design: Classifies subdomains (core/supporting/generic), assesses integration strength, distance, and volatility, and applies the balance rule to flag unbalanced coupling. - Complete design documentation: Generates per-module design.md files with responsibilities, encapsulated knowledge, integration contracts, and change vectors, plus an overall architecture.md. - Module test specifications: Produces unit, contract, boundary, and behavior test specs for every module, ready for developers to implement. - Use Case: You have a functional requirements document for a new ordering system. Run this Skill to iteratively validate subdomain classifications, design module boundaries, and receive a full docs/design folder with architecture, module designs, and test specs. ## Quick Start Use the modularity-design skill with docs/requirements.md to design the system architecture and produce module design documents.

Frequently Asked Questions about modularity-design

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

FAQPage Schema
How do I design a modular architecture from functional requirements?

Provide a functional requirements file as input, and the Skill walks through six steps: understanding requirements, designing the modular architecture, writing module design documents, writing test specifications, writing the architecture document, and a modularity review. Each major step requires explicit user approval before proceeding.

What is the Balanced Coupling model used in architecture design?

Balanced Coupling evaluates integrations across three dimensions: integration strength, distance, and volatility. The balance rule states that high-strength integrations should be co-located (low distance) while high-distance integrations should use contracts (low strength), especially for volatile core domains.

What output files does the modularity-design skill generate?

It creates a dated docs/design folder containing an architecture.md overview, plus a subdirectory per module with design.md (responsibilities, encapsulated knowledge, integration contracts, change vectors) and tests.md (unit, contract, boundary, and behavior test cases).

Does this skill require other skills to work?

Yes, it depends on the balanced-coupling skill, which is preloaded to provide the coupling model applied to all architectural decisions. Installers pull this dependency in transitively via the deps.yml declaration.

When should I not use a formal modular design process?

This process is heavyweight for small scripts, prototypes, or low-volatility supporting code where pragmatic shortcuts are acceptable. It is best suited for new systems or significant features where module boundaries and integration contracts have long-term consequences.