Skip to content
decomplect-py logo

Decomplect-Py

decomplect-py

Architectural code analysis for Python design quality. Evaluates simplicity (Rich Hickey), functional core/imperative shell (Gary Bernhardt), and coupling (Constantine & Yourdon). Use for design review or architectural assessment of Python code.

SKILL.md

Full skill instructions

Decomplect-Py

Architectural analysis for Python design quality.

Usage

/​decomplect-py                # Run all 3 analyzers in parallel
/​decomplect-py --simplicity   # Specific analyzer
/​decomplect-py --fcis         # Specific analyzer
/​decomplect-py --coupling     # Specific analyzer

Analyzers

AnalyzerQuestion
simplicity-analyzerIs this truly simple or just easy?
fcis-analyzerIs pure logic separated from I/​O?
coupling-analyzerAre modules well-separated?

What It Checks

PillarFocus
SimplicityValues over state, decomplected concerns
FCISFunctional core (pure), imperative shell (I/​O)
CouplingHigh cohesion, low coupling

When to Use

  • Reviewing Python system design
  • Before major refactoring
  • Assessing architectural quality
  • Checking if code is "Rich Hickey approved"

Supported Languages

  • Python (.py files only)

Python-Specific Patterns

  • dataclasses(frozen=True) and NamedTuple for immutable values
  • Mutable default argument anti-patterns
  • Django/​Flask view architecture
  • Circular import detection
  • Module-level state analysis

Reference Documentation

See Also

  • /​decomplect - Analysis for TypeScript/​Go/​Rust
  • /​unslopify - Tactical code cleanup