# Modular Architecture Documentation

> Systematically document multi-module system architectures including module boundaries, CLI commands, and architecture decisions.

- Skill: `vamseeachanta/modular-architecture-documentation` (Agent Skill)
- Install (CLI): `npx skillmds@latest add vamseeachanta/modular-architecture-documentation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vamseeachanta/modular-architecture-documentation/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: vamseeachanta (https://skillmd.com/u/vamseeachanta)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/vamseeachanta/modular-architecture-documentation

---


# 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)