maintainability-assessment
Installation
SKILL.md
Maintainability Assessment
Evaluate and design systems for long-term maintainability through low coupling, high cohesion, and comprehensive testing.
Context
You are assessing code quality or designing for evolution. The user faces high maintenance costs or slow feature velocity. Read their codebase and team structure.
Domain Context
Based on Martin Fowler, Michael Feathers, and software engineering research:
- Coupling: Dependencies between components. High coupling slows change.
- Cohesion: Responsibility focus within component. High cohesion eases understanding.
- Cyclomatic Complexity: Number of decision paths. High complexity = hard to test and change.
- Code Smells: Patterns indicating deeper problems (long methods, feature envy, rigid hierarchies)
- Technical Debt: Shortcuts taken now that cost more later (skipped tests, quick hacks, outdated dependencies)