modular-architecture-documentation
Systematically document multi-module system architectures including module boundaries, CLI commands, and architecture decisions.
Best use case
modular-architecture-documentation is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Systematically document multi-module system architectures including module boundaries, CLI commands, and architecture decisions.
Teams using modular-architecture-documentation should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/modular-architecture-documentation/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How modular-architecture-documentation Compares
| Feature / Agent | modular-architecture-documentation | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Systematically document multi-module system architectures including module boundaries, CLI commands, and architecture decisions.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Modular Architecture Documentation ## Overview This skill provides a systematic approach to documenting multi-module system architectures, including module boundary definition, CLI command specification, shared component identification, and architecture decision documentation following Agent OS decisions.md patterns. ## When to Use Use this skill when: - Documenting modular architecture in tech-stack.md - Implementing multi-module systems with independent CLI commands - Defining module boundaries and responsibilities - Identifying shared vs. module-specific components - Documenting pyproject.toml entry points for modules - Recording architecture decisions in decisions.md - Ensuring module independence and cohesion - Planning gradual feature adoption (Phase 1: Module A, Phase 2: Module B) ## Related Skills - **Product Documentation Modernization** - For documenting architecture in tech-stack.md - **Technology Stack Modernization** - For pyproject.toml configuration - **Workspace-Hub Standards Compliance** - For ensuring architectural compliance ## References ### Architecture Patterns - [Clean Architecture](https://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architecture.html) - [Modular Monolith](https://www.kamilgrzybek.com/blog/posts/modular-monolith-primer) - [Python Application Layouts](https://realpython.com/python-application-layouts/) ### CLI Design - [Click Documentation](https://click.palletsprojects.com/) - [CLI Best Practices](https://clig.dev/) ### Agent OS Resources - Agent OS Documentation: mission.md, tech-stack.md, roadmap.md, decisions.md - Agent OS Decision Template: decisions.md format ## Version History - **1.0.0** (2026-01-08): Initial release - comprehensive modular architecture documentation skill ## Sub-Skills - [Example: 3-Module Invoice/Tax System](example-3-module-invoicetax-system/SKILL.md) - [Module Naming (+4)](module-naming/SKILL.md) ## Sub-Skills - [1. Module Definition Framework (+9)](1-module-definition-framework/SKILL.md) - [Decision (+5)](decision/SKILL.md) - [Tech-Stack.md Modular Architecture Section](tech-stackmd-modular-architecture-section/SKILL.md) - [Overview (+7)](overview/SKILL.md) - [Decision (+6)](decision/SKILL.md) - [Overview (+6)](overview/SKILL.md) - [Decision (+6)](decision/SKILL.md) - [Success Criteria](success-criteria/SKILL.md)
Related Skills
improve-codebase-architecture
Find deepening opportunities in a codebase, informed by the domain language in CONTEXT.md and the decisions in docs/adr/. Use when the user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, or make a codebase more testable and AI-navigable.
label-driven-prompt-generation-architecture
Pattern for building automation scripts that classify GitHub issues into prompt templates using label-based routing and extract contextual data for batch processing
documentation-contract-plan-hardening
Harden a documentation/contract plan before adversarial review by mapping every issue-scope requirement to independent acceptance criteria and tests, especially for routing/indexing contracts.
repo-architecture-analysis
Scan a Python repo's package structure, count classes/functions, classify module maturity (PRODUCTION/DEVELOPMENT/SKELETON/GAP), and generate architecture reports with Mermaid diagrams. Use when asked to analyze codebase structure, find untested packages, or assess module maturity.
orcaflex-monolithic-to-modular
Convert monolithic OrcaFlex models (.dat/.yml) to spec-driven modular format with semantic validation for round-trip fidelity.
doc-extraction-naval-architecture
Layer 3 domain sub-skill for extracting naval architecture data from SNAME PNA, IMO stability codes, IACS structural rules, and classification society guidelines. Provides detection heuristics for stability constants, resistance equations, hull form coefficients, hydrostatic curves, IMO stability criteria, and structural scantling tables. type: reference
sparc-architecture
SPARC Architecture phase specialist for system design, component architecture, interface design, scalability planning, and technology selection
architecture-diagram
Dark-themed SVG architecture/cloud/infra diagrams as HTML.
multi-tool-architecture-assessment
Systematic comparison of competing tools/approaches before committing to a multi-account, multi-tool architecture. Uses parallel subagents for research, system-state audit, and data quality analysis. Produces a decision matrix with explicit trade-offs.
discipline-refactor-orchestration-architecture
Sub-skill of discipline-refactor: Orchestration Architecture.
web-artifacts-builder-self-contained-architecture
Sub-skill of web-artifacts-builder: Self-Contained Architecture (+1).
skill-creator-3-multi-stage-workflow-architecture
Sub-skill of skill-creator: 3. Multi-Stage Workflow Architecture (+1).