Decomplect Py

Name: Decomplect Py
Author: zby

ASecurity

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.

21 stars
0 votes
0 copies
2 views
Added June 8, 2026

developmenttypescriptpythonrustgoshelldjangoflaskrefactoringdocumentation

Security analysis

A100/100

Pro scans all 10 files and shows the line behind each finding

Scanned June 8, 2026

npx -y skills add zby/llm-do --skill decomplect-py --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Decomplect Py?

Add the live security badge to your README. It updates with every re-scan.

[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/zby-decomplect-py/badge)](https://www.skillsdirectory.com/skills/zby-decomplect-py)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro

SKILL.md

---
name: decomplect-py
description: 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.
---

# 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

| Analyzer | Question |
|----------|----------|
| **simplicity-analyzer** | Is this truly simple or just easy? |
| **fcis-analyzer** | Is pure logic separated from I/O? |
| **coupling-analyzer** | Are modules well-separated? |

## What It Checks

| Pillar | Focus |
|--------|-------|
| **Simplicity** | Values over state, decomplected concerns |
| **FCIS** | Functional core (pure), imperative shell (I/O) |
| **Coupling** | High 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

- [Rich Hickey Principles](reference/rich-hickey.md)
- [Functional Core/Imperative Shell](reference/fcis.md)
- [Cohesion & Coupling](reference/coupling.md)

## See Also

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