Thanks to visit codestin.com
Credit goes to github.com

Skip to content

rubenCodeforges/codeforges-claude-plugin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

12 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

cf Dev Toolkit

Version License Claude Code

Make Claude Code production-ready. Get 8 specialized agents that understand complete context, verify before suggesting code, and never lose focus on complex tasks.


What This Does

Transforms Claude Code from a basic assistant into a team of specialists:

  • πŸ” Deep code analysis without reading only 20 lines
  • 🎯 Stays focused on multi-step tasks (no more losing track)
  • ⚑ Parallel execution with separate context windows (no token overflow)
  • βœ… Verifies first - checks actual code before suggesting changes
  • πŸš€ Instant activation - just talk naturally, agents trigger automatically

Use Cases: Bug investigation, performance optimization, refactoring, API mapping, dependency analysis, git history, website performance audits, codebase exploration.


Quick Start

1. Install Plugin

/plugin marketplace add rubenCodeforges/codeforges-claude-plugin
/plugin install cf-dev-toolkit

2. Add to Claude Memory (Important!)

Click "Add to memory" or "Personalize" and add:

Use cf-dev-toolkit plugin agents for all development tasks.
Always prefer using specialized agents over direct analysis.

Why this matters: Without this, Claude might not automatically use agents. This memory instruction ensures agents activate proactively.

3. Optional: Web Performance Setup

The web-performance-agent works immediately with zero config. For faster runs:

cd ~/.claude/plugins/cf-dev-toolkit
./setup.sh

4. Start Using

Just talk naturally:

"Find where calculateTotal is used"
"Check performance of https://mysite.com"
"Bug in checkout form - users can't submit"

No @ needed. Agents activate automatically.


What You Get

8 Specialized Agents

Agent What It Does Triggers On
code-analyst Deep file analysis, smart reading for large files "analyze", "review", "understand code"
usage-finder Tracks function/class usage across entire codebase "where used", "find usages", "what calls this"
performance-analyzer Finds bottlenecks, N+1 queries, algorithmic issues "slow", "performance", "optimize"
web-performance-agent Lighthouse analysis + runtime debugging (freezes, memory leaks) URLs, "page speed", "app freeze", "memory leak"
api-analyzer Maps all endpoints (Express, FastAPI, Django, Spring, Go) "API routes", "endpoints", "map API"
dependency-analyzer Security vulnerabilities, circular deps, bundle bloat "dependencies", "npm audit", "security"
git-analyzer Shows who wrote what, when, why "git blame", "who wrote", "recent changes"
code-scanner Project overview: structure, tech stack, patterns "codebase structure", "project overview"

Key Features:

  • Separate context windows (no token overflow)
  • Smart reading strategy (complete files < 1000 lines)
  • Verification before code suggestions
  • Automatic multi-agent coordination

5 Auto-Loading Skills

  • codebase-patterns - Pattern recognition
  • refactoring-guide - Refactoring techniques
  • performance-patterns - Optimization strategies
  • web-performance-optimization - Core Web Vitals, Lighthouse metrics
  • runtime-debugging - Debug freezes, memory leaks, performance issues

5 Quick Commands

  • /analyze-file <path> - Deep file analysis
  • /scan-codebase - Complete project scan
  • /check-web-perf - Web performance toolkit diagnostics
  • /map-class-usage <class> - Build usage map for a class
  • /diagnose-runtime <url> - Debug runtime issues (freezes, memory leaks)

Real Examples

Bug Investigation
You: "Users can't submit payment form"

Claude automatically:
β†’ Analyzes checkout code (code-analyst)
β†’ Finds where payment methods are called (usage-finder)
β†’ Maps payment API endpoints (api-analyzer)
β†’ Shows recent changes to payment flow (git-analyzer)

Result: "Found missing error handling in CheckoutForm.jsx:45"
Website Performance Audit
You: "Check performance of https://myapp.com"

Claude automatically:
β†’ Runs Lighthouse audit (web-performance-agent)
β†’ Analyzes Core Web Vitals

Result:
"Performance: 65/100
- LCP: 3.2s (needs improvement)
- 2.3MB unoptimized images
- 850ms render-blocking CSS

Fix 1: Convert images to WebP
Fix 2: Defer non-critical CSS
[...specific code examples...]"
Performance Optimization
You: "Dashboard loads slowly"

Claude automatically:
β†’ Scans for bottlenecks (performance-analyzer)
β†’ Checks bundle size (dependency-analyzer)
β†’ Reviews component structure (code-analyst)

Result: "Found 3 issues:
1. N+1 query in getUserPosts()
2. Missing React.memo on DataTable
3. 300KB lodash import (use lodash-es)"
Refactoring
You: "UserService is too large, help me refactor"

Claude automatically:
β†’ Analyzes structure (code-analyst)
β†’ Maps all usages (usage-finder)
β†’ Shows dependencies (dependency-analyzer)

Result: "Split into 3 services:
- UserAuth (login, tokens, sessions)
- UserProfile (CRUD, preferences)
- UserNotifications (emails, push)"

FAQ

Agents not triggering automatically?

Solution 1: Add to Claude Memory

Use cf-dev-toolkit plugin agents for all development tasks.

Solution 2: Add to project CLAUDE.md Create ./CLAUDE.md in your project:

# cf-dev-toolkit Plugin

For all coding tasks, prefer using cf-dev-toolkit agents:
- Code analysis/review β†’ code-analyst
- Finding usages β†’ usage-finder
- Performance issues β†’ performance-analyzer
- Web performance β†’ web-performance-agent
- API mapping β†’ api-analyzer
- Git history β†’ git-analyzer
- Dependencies β†’ dependency-analyzer

Solution 3: Explicit invocation Use @agent-name to force a specific agent.

Plugin disabled after update?

After updating the plugin, it sometimes gets disabled. To fix:

# Check plugin status
/plugin list

# Re-enable if needed
/plugin enable cf-dev-toolkit

# Restart Claude Code

This is a known behavior - plugins may disable on update as a safety measure.

Web performance agent fails?

Run diagnostics:

/check-web-perf

Common fixes:

  • Install Node.js 18+ if missing
  • Run ./setup.sh for optimal performance
  • First npx run downloads ~50MB (then cached)
  • Check internet connection for npx mode
How do I customize agents?

Edit .md files in the plugin directory:

~/.claude/plugins/cf-dev-toolkit/agents/*.md    # Agent behavior
~/.claude/plugins/cf-dev-toolkit/skills/*.md    # Knowledge base
~/.claude/plugins/cf-dev-toolkit/commands/*.md  # Slash commands

After editing, restart Claude Code.

Can I use agents explicitly?

Yes! Force a specific agent with @:

@code-analyst analyze src/components/Button.tsx
@usage-finder find usages of handleSubmit
@web-performance-agent analyze https://example.com

Advanced

Manual Installation
git clone https://github.com/rubenCodeforges/codeforges-claude-plugin.git
cp -r codeforges-claude-plugin ~/.claude/plugins/cf-dev-toolkit
# Restart Claude Code
Updating
/plugin update cf-dev-toolkit

Check version: /plugin list

Note: Plugin may be disabled after update - re-enable with /plugin enable cf-dev-toolkit


Changelog

1.1.1 - Custom agent colors, improved triggers (rework/improve/check), FAQ section, memory instructions, better README 1.1.0 - Web performance agent, Lighthouse integration, setup.sh installer, health check command 1.0.0 - Initial release with 7 agents, 3 skills, 2 commands


Contributing

We welcome improvements!

  1. Fork the repo
  2. Create feature branch
  3. Follow guidelines in CLAUDE.md
  4. Test in real projects
  5. Submit PR

See CONTRIBUTING.md for details.


Resources


Version 1.1.1 β€’ MIT License β€’ By codeforges

About

Open source claude code plugin to help with daily coding tasks.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages