code-qualities-assessment

# Code Qualities Assessment Evaluate code maintainability using 5 timeless design qualities with quantifiable scoring rubrics. ## Triggers - `assess code quality` - `evaluate maintainability` - `check code qualities` - `testability review` - `run quality assessment` --- ## Quick Start ```bash # Assess a single file python3 scripts/assess.py --target src/services/auth.py # Assess changed files from the PR base (CI mode) python3 scripts/assess.py --target . --changed-only --base origin/main --format json # Full module assessment with HTML report python3 scripts/assess.py --target src/services/ --format html --output quality-report.html ``` --- ## Scripts | Script | Purpose | Usage | |--------|---------|-------| | `scripts/assess.py` | Scores target code across the five quality axes. | `python3 scripts/assess.py --target <path> --format markdown` | Use `--changed-only` for diff-scoped checks and `--format json` for automation. --- ## The 5 Code Qualities | Quality | Question | Score 10 | Score 1-3 | |---------|----------|----------|-----------| | **Cohesion** | How related are responsibilities? | Single, well-defined responsibility | Unrelated responsibilities jammed together | | **Coupling** | How dependent on other code? | Minimal deps, depends on abstractions | Tightly coupled, hard-coded dependencies | | **Encapsulation** | How well are internals hidden? | All internals private, minimal API | Everything public, no information hiding | | **Testability** | How e...