DevFlow

A developer productivity plugin for Claude Code with code analysis, debugging, testing, and refactoring workflows.

Installation

Copy this plugin to your Claude Code plugins directory:

cp -r devflow ~/.claude/plugins/

Commands

Command	Description
/review	Review code changes for quality, bugs, performance, and security
/dead-code	Scan repo for unused files/functions, generate removal patch
/dead-code-apply	Safely apply the dead code removal patch
/debug	Systematic 6-step debugging workflow
/commit	Generate conventional commit messages from staged changes
/test	Generate comprehensive tests with edge case coverage
/refactor	Guided refactoring with safety checks and incremental changes
/docs	Generate documentation from code (JSDoc, docstrings, etc.)

Agents

dead-code-hunter

Thorough static analysis agent for finding dead code. Performs 6-phase analysis:

1. Project discovery
2. Dependency graph building
3. Dead code detection
4. False positive filtering
5. Confidence scoring
6. Report generation

Output files:

• dead-code-report.md - Full analysis
• dead-code-removal.patch - Safe deletions (90%+ confidence)
• dead-code-review.md - Items needing human review

Skills

tdd (Test-Driven Development)

Enforces the Red-Green-Refactor cycle:

RED → Write failing test
GREEN → Write minimal code to pass
REFACTOR → Improve without breaking tests

Rules:

• No production code without a failing test
• Write minimum test to fail
• Write minimum code to pass
• Refactor only when green

code-patterns

Common code patterns and best practices reference for quick lookup.

Hooks

pre-commit

Runs before each commit to ensure code quality:

• Linting (ESLint, Pylint, etc.)
• Formatting (Prettier, Black, etc.)
• Type checking (TypeScript, mypy)

post-stage

Triggers after git add to offer commit message generation.

Example Workflows

Finding and Removing Dead Code

# 1. Scan for dead code
/dead-code

# 2. Review the generated report
cat dead-code-report.md

# 3. Apply safe deletions
/dead-code-apply

Test-Driven Feature Development

# 1. Activate TDD skill (enforces Red-Green-Refactor)
# 2. Write first failing test
# 3. Implement minimal code
# 4. Refactor
# 5. Repeat

Debugging an Issue

# 1. Start systematic debugging
/debug

# 2. Follow the 6-step process:
#    - Understand the problem
#    - Gather evidence
#    - Form hypotheses
#    - Test hypotheses
#    - Isolate the bug
#    - Fix and verify

Configuration

Edit .claude-plugin/plugin.json to customize:

{
  "name": "devflow",
  "version": "1.0.0",
  "author": {
    "name": "your-name",
    "email": "your-email@example.com"
  }
}

License

MIT