rforge

RForge Plugin

R package ecosystem orchestrator for Claude Code — 16 commands, R-aware hooks, validation skills.

Self-contained R package analysis for Claude Code. As of v1.3.0 the plugin is fully self-sufficient — pure-Python lib/ modules handle discovery, dependencies, status, and init. No MCP server required.

Upcoming in v2.0.0 (BREAKING)

• 🔀 3 commands renamed for cleaner namespacing — /rforge:doc-check → /rforge:docs:check, /rforge:ecosystem-health → /rforge:health, /rforge:rpkg-check → /rforge:r:check. The other 13 commands are unchanged. Typing an old name produces a helpful rename-error pointing at the new name — no silent failures. See docs/migration/v2.0.0-rename.md for the full mapping table and a sed recipe to mass-update local scripts.

What's new in v1.3.0

• 🎯 MCP absorption complete — rforge-mcp has been absorbed into the plugin. All 7 implemented tools now ship as pure-Python lib/ modules. The MCP server is no longer required (and is being archived). See docs/migration/rforge-mcp-deprecation.md.
• 🐍 lib/status.py — ecosystem health snapshot (DESCRIPTION + .STATUS parsing). python3 -m lib.status [--path .] [--format text|json].
• 🌱 lib/init.py — initialize ~/.rforge/context.json for cross-package state. python3 -m lib.init [--quick]. New /rforge:init command.
• 📦 No runtime dependencies beyond Python 3.10+ — the plugin works on any system with a modern Python.

What's new in v1.2.0

• 🛒 Marketplace install — one-shot setup via /plugin marketplace add Data-Wise/rforge (no clone, no symlinks). See docs/configuration.md for tunable options (CRAN mirror, vignette engine, R version pin, CLAUDE.md budget).
• 🪝 R-aware PreToolUse hook — four rules that fire on every Write/Edit: blocks hand-edits to roxygen-generated man/*.Rd, warns when R/*.R edits may need NAMESPACE/DESCRIPTION sync, warns on non-SemVer DESCRIPTION Version bumps, warns on writes outside the active worktree. Diagnostic, not adversarial — only the man/*.Rd rule blocks. See docs/hooks-and-skills.md.
• 🔍 description-sync validation skill — pure-shell sanity check that DESCRIPTION Version matches the top entry in NEWS.md / CHANGELOG.md. Catches the most common pre-CRAN release-prep failure. No R required.
• 📐 Plugin Surface architecture diagram — new Mermaid diagram in docs/architecture.md showing how marketplace, config, commands, agents, hooks, and skills relate.

Full changelog: CHANGELOG.md.

Quick Start

# Quick analysis (< 30 seconds)
/rforge:analyze "Update RMediation bootstrap algorithm"

# Ultra-fast (< 10 seconds)
/rforge:quick

# Comprehensive (2-5 minutes)
/rforge:thorough "Prepare for CRAN release"

Features

✨ Auto-delegation - Recognizes task patterns, selects appropriate tools ⚡ Parallel execution - Invokes multiple lib/ modules simultaneously 📊 Live progress - Real-time updates as tools complete 🎯 Smart synthesis - Combines results into actionable summary 🧠 ADHD-friendly - Fast feedback, clear structure, visual progress 🐍 Pure-Python lib/ - lib/discovery.py, lib/deps.py, lib/status.py, lib/init.py. No R subprocess, no MCP server, no Node.js. See docs/lib-modules.md.

How It Works

User Request
    ↓
Pattern Recognition (CODE_CHANGE, BUG_FIX, etc.)
    ↓
Tool Selection (impact, tests, docs, health)
    ↓
Parallel `lib/` invocations (python3 -m lib.* in subprocess)
    ↓
Results Synthesis (impact + quality + maintenance + next steps)
    ↓
Actionable Summary

Skills

/rforge:analyze

Balanced analysis with recommendations (< 30 seconds)

/rforge:analyze "Update code"

/rforge:quick

Ultra-fast status check (< 10 seconds)

/rforge:quick

/rforge:thorough

Comprehensive analysis with R CMD check (2-5 minutes)

/rforge:thorough "Prepare for CRAN"

Requirements