# Clean Code File Size Decision Tree

> Sub-skill of clean-code: File Size Decision Tree.

- Skill: `vamseeachanta/clean-code-file-size-decision-tree` (Agent Skill)
- Install (CLI): `npx skillmds@latest add vamseeachanta/clean-code-file-size-decision-tree`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vamseeachanta/clean-code-file-size-decision-tree/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: vamseeachanta (https://skillmd.com/u/vamseeachanta)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/vamseeachanta/clean-code-file-size-decision-tree

---


# File Size Decision Tree

## File Size Decision Tree


When a file exceeds 400 lines:

```
Is it a God Object (does many unrelated things)?
  YES → Split by responsibility (see Decomposition Patterns below)
  NO  → Is it a report generator / long output formatter?
         YES → Extract: data-gathering logic → separate module
                        formatting/rendering → reporter.py / formatter.py
         NO  → Is it a data model / schema file?
                YES → Acceptable if types are coherent; add __all__
                NO  → Is it a legacy solver (low churn, full tests)?
                       YES → Add # noqa: clean-code; open WRK for future split
                       NO  → Split now
```

---