# Modular Architecture Documentation Module Naming

> Sub-skill of modular-architecture-documentation: Module Naming (+4).

- Skill: `vamseeachanta/modular-architecture-documentation-module-naming` (Agent Skill)
- Install (CLI): `npx skillmds@latest add vamseeachanta/modular-architecture-documentation-module-naming`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vamseeachanta/modular-architecture-documentation-module-naming/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-module-naming

---


# Module Naming (+4)

## Module Naming

- **Use domain names, not technical terms:**
  - ✅ `invoice`, `tax_prep`, `tax_file`
  - ❌ `module1`, `processor`, `generator`

- **Keep names short and memorable:**
  - ✅ `invoice-gen` (CLI command)
  - ❌ `invoice_generation_automation_tool`


## Module Boundaries

- **One module = one CLI command = one purpose**
- **Clear inputs/outputs per module**
- **No circular dependencies between modules**
- **Minimize shared components** (only truly shared code)


## CLI Command Design

- **Consistent flag naming across modules:**
  - `--help`, `--verbose`, `--dry-run`, `--config`
- **Intuitive command names reflecting actions:**
  - `invoice-gen`, `tax-prep`, `tax-file`
- **Comprehensive help text with examples**


## Documentation Standards

- **Document in tech-stack.md:** Module structure, CLI commands, adoption path
- **Record in decisions.md:** Why modular, alternatives considered, consequences
- **Update roadmap.md:** Phased implementation per module
- **Maintain README:** Quick start per module


## Testing Independence

- **Each module has test directory:**
  ```
  tests/
  ├── invoice/
  ├── tax_prep/
  ├── tax_file/
  └── shared/
  ```
- **Mock other modules in tests** (don't depend on them)
- **80% coverage per module, 95% for critical**