Agent skill
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.
Install this agent skill to your Project
npx add-skill https://github.com/zby/llm-do/tree/main/.claude/skills/decomplect-py
SKILL.md
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 (
.pyfiles only)
Python-Specific Patterns
dataclasses(frozen=True)andNamedTuplefor immutable values- Mutable default argument anti-patterns
- Django/Flask view architecture
- Circular import detection
- Module-level state analysis
Reference Documentation
- Rich Hickey Principles
- Functional Core/Imperative Shell
- Cohesion & Coupling
See Also
/decomplect- Analysis for TypeScript/Go/Rust/unslopify- Tactical code cleanup
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
tasks-system
ask-questions-if-underspecified
Clarify requirements before implementing. Do not use automatically, only when invoked explicitly.
refactor
Plan vault restructuring from config changes. Compares config.yaml against derivation.md, identifies dimension shifts, shows restructuring plan, executes on approval. Triggers on "/refactor", "restructure vault".
validate
Schema validation for notes. Checks against domain-specific templates. Validates required fields, enum values, description quality, and link health. Non-blocking — warns but doesn't prevent capture. Triggers on "/validate", "/validate [note]", "check schema", "validate note", "validate all".
tasks
View and manage the task stack and processing queue. Shows pending work, active tasks, completed items, and queue state. Triggers on "/tasks", "show tasks", "what's pending", "task list", "queue status".
ralph
Queue processing with fresh context per phase. Processes N tasks from the queue, spawning isolated subagents to prevent context contamination. Supports serial, parallel, batch filter, and dry run modes. Triggers on "/ralph", "/ralph N", "process queue", "run pipeline tasks".
Didn't find tool you were looking for?