ContextQMD
Back to Ruflo

ruflo-jujutsu

plugins/ruflo-jujutsu/README.md

3.6.302.8 KB
Original Source

ruflo-jujutsu

Advanced git workflows with diff analysis, risk scoring, and reviewer recommendations.

Install

/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-jujutsu@ruflo

Features

  • Diff analysis: Comprehensive change analysis with risk scoring
  • Change classification: Auto-categorize as feature, bugfix, refactor, etc.
  • Reviewer recommendations: Suggest reviewers based on code ownership
  • File-level risk: Per-file risk breakdown for targeted review

Commands

  • /jujutsu -- Analyze current diff with risk scoring

Skills

  • diff-analyze -- Analyze diffs for risk, reviewers, and classification
  • git-workflow -- Advanced branch management and PR lifecycle

MCP surface (6 tools)

All defined at v3/@claude-flow/cli/src/mcp-tools/analyze-tools.ts:

ToolPurpose
analyze_diffFull diff analysis (risk + classification + reviewers + stats)
analyze_diff-riskRisk score for the staged/unstaged diff
analyze_diff-classifyClassify change as feature, bugfix, refactor, perf, security, docs, …
analyze_diff-reviewersRecommend reviewers based on code ownership
analyze_file-riskPer-file risk breakdown
analyze_diff-statsLines added/removed, files touched, complexity delta

Compatibility

  • CLI: pinned to @claude-flow/cli v3.6 major+minor.
  • Verification: bash plugins/ruflo-jujutsu/scripts/smoke.sh is the contract.

ADR-compliance integration

This plugin's diff analysis is the substrate that ruflo-adr ADR-0001's /adr check runs on. When ADR compliance is queried for a diff:

  1. /adr check calls analyze_diff to get the structured diff
  2. Then analyze_diff-classify to determine change type
  3. Then cross-references the adr-patterns namespace for ADRs related to the touched files
  4. Flags violations: code referencing deprecated/superseded ADRs, or code contradicting accepted ADRs

Without this plugin, /adr check falls back to plain git diff parsing — usable but no risk scoring or reviewer recommendations.

Namespace coordination

This plugin owns the git-patterns AgentDB namespace (kebab-case, follows the convention from ruflo-agentdb ADR-0001 §"Namespace convention"). Reserved namespaces (pattern, claude-memories, default) MUST NOT be shadowed.

Verification

bash
bash plugins/ruflo-jujutsu/scripts/smoke.sh
# Expected: "10 passed, 0 failed"

Architecture Decisions

  • ruflo-adr — /adr check consumes this plugin's analyze_diff output
  • ruflo-agentdb — namespace convention owner