fractal-architecture

What problem does it solve? Codebases grow until individual methods, classes, and modules exceed what a reader can hold in working memory, making reasoning slow and error-prone. This Skill provides concrete heuristics from Mark Seemann's "Code That Fits in Your Head" to keep every unit of code comprehensible at every scale. ## Core Features & Use Cases - Fractal Architecture: Structures systems so each zoom level (system, module, class, method) contains roughly seven well-named chunks that summarize the level below. - Numeric Heuristics: Applies default ceilings such as cyclomatic complexity ≤ 7, methods ≤ 24 lines, lines ≤ 80 characters, and ≤ 3 parameters per method. - Encapsulation via Invariants: Enforces preconditions, postconditions, and invariants so objects cannot exist in invalid states, plus functional core / imperative shell separation. - Use Case: When reviewing a 60-line method with nested conditionals, use this Skill to decompose it into named chunks, enforce guard clauses, and verify each extracted method fits the 80x24 window. ## Quick Start Ask Claude to review this class against the fractal-architecture heuristics and suggest where it exceeds working-memory limits.