debt-frameworks

Code-level issues that make the codebase harder to understand, modify, and maintain.

Content Preview
# tech-debt-tracker reference

## Technical Debt Classification Framework

### 1. Code Debt
Code-level issues that make the codebase harder to understand, modify, and maintain.

**Indicators:**
- Long functions (>50 lines for complex logic, >20 for simple operations)
- Deep nesting (>4 levels of indentation)
- High cyclomatic complexity (>10)
- Duplicate code patterns (>3 similar blocks)
- Missing or inadequate error handling
- Poor variable/function naming
- Magic numbers and hardcoded values
-
How to Use

Recommended: Install to project (local)

mkdir -p .claude/skills
curl -o .claude/skills/debt-frameworks.md \
  https://raw.githubusercontent.com/alirezarezvani/claude-skills/main/engineering/tech-debt-tracker/references/debt-frameworks.md

Skill is scoped to this project only. Add .claude/skills/ to your .gitignoreif you don't want to commit it.

Alternative: Clone full repo

git clone https://github.com/alirezarezvani/claude-skills

Then reference at engineering/tech-debt-tracker/references/debt-frameworks.md

Related Skills