vamseeachanta 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
CLI Design
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