Does it support web frameworks like Django and Flask?

Yes, it specifically analyzes view architectures and module-level state, which are common areas for architectural debt in Python web frameworks.

What does 'decomplect' mean in the context of this skill?

To decomplect means to disentangle or unknot concerns that have been bundled together. This skill identifies where logic, state, and I/O are mixed, making the code harder to reason about.

How does it help with Python-specific code quality?

It looks for specific Python patterns like mutable default arguments, circular imports, and recommends modern practices like using frozen dataclasses for immutable state.

Python Architectural Analyzer (Decomplect)

Name: Python Architectural Analyzer (Decomplect)
Author: zby

byzby

•

Developer Tools

Evaluates Python codebases for architectural quality using simplicity, coupling, and functional-core principles.

Decomplect-py provides deep architectural insights into Python codebases by evaluating them against rigorous design standards like Rich Hickey’s simplicity principles and Gary Bernhardt’s Functional Core/Imperative Shell (FCIS) pattern. It helps developers disentangle complex logic, detect high coupling between modules, and identify Python-specific anti-patterns such as mutable default arguments or circular imports. Ideal for design reviews and pre-refactoring assessments, this skill ensures your Python architecture remains scalable, testable, and maintainable by identifying exactly where concerns have become 'complected'.

Key Features

016 GitHub stars

02Simplicity analysis based on Rich Hickey’s philosophy of separating concerns.

03Analysis of immutable data patterns using frozen dataclasses and NamedTuples.

04Functional Core/Imperative Shell (FCIS) verification to isolate pure logic from I/O.

05Module coupling and cohesion evaluation using Constantine & Yourdon metrics.

06Detection of Python-specific anti-patterns like mutable default arguments and circular imports.

Use Cases

01Assessing design quality during code reviews to prevent technical debt accumulation.

02Validating the separation of business logic from framework-specific I/O in Django or Flask.

03Performing architectural audits before major refactoring or system migrations.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add zby/llm-do decomplect-py

For use in Claude.ai and ChatGPT

Download Skill