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
• Modular Monolith
• Python Application Layouts

CLI Design

• Click Documentation
• CLI Best Practices

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
• Module Naming (+4)

Sub-Skills

• 1. Module Definition Framework (+9)
• Decision (+5)
• Tech-Stack.md Modular Architecture Section
• Overview (+7)
• Decision (+6)
• Overview (+6)
• Decision (+6)
• Success Criteria