rubysmithing

Rubysmithing

Features

• Orchestrated agent suite — Thin routing orchestrator dispatches to domain sub-agents with parallel/sequential awareness, avoiding the telephone-game problem
• Auto-activating skills — Nine skill modules activate on trigger phrases; complex requests escalate automatically from hub to sub-skill
• Convention enforcement hooks — PostToolUse hook validates .rb files against RuboCop, StandardRB, or community idioms on every write
• Live gem API verification — Context7 MCP integration with SQLite-backed cache; tiered degradation (cache → registry → warning) never silently fails
• TUI scaffolding — Charm/Bubble ecosystem scaffolder with verified API patterns and a copy-paste skeleton template
• SIFT QA protocol — V1.0 quality assessment engine with optional meta-judge verification footer for 3+ file reviews
• SADD patterns — Subagent-Driven Development infrastructure (meta-judge, do-and-judge retry loop, scratchpad persistence) built into refactor and report agents
• Slash commands — Five user-invocable commands cover context warming, QA assessment, project scaffolding, refactoring, and YARD documentation

Prerequisites

Requires two external tools. The plugin degrades gracefully if either is absent, but functionality will be limited.

{ "context7": { "command": "npx", "args": ["-y", "@upstash/context7-mcp@latest"] } }

# macOS
brew install jq

# Ubuntu/Debian
apt install jq

Installation

Place the skills/ directory in the Claude Code skills path:

skills/

All agents, commands, and hooks are co-located inside their respective skill directory. Reference rubysmithing as the primary hub. Sub-skills activate automatically on trigger phrases.

Plugin Layout

Agents, commands, and hooks are co-located inside each skill directory.

skills/
  rubysmithing/                    # Hub — routes to sub-skills
    agents/
      rubysmithing-orchestrator.md # Thin router with parallel dispatch
      rubysmithing-main.md         # Hub for POROs, Rake, config wiring
    hooks/
      hooks.json                   # PostToolUse(Write|Edit) + Stop hooks
      scripts/check-ruby-conventions.sh  # RuboCop/StandardRB/community idiom validator
    references/
      convention-detection.md      # Canonical cascade (RuboCop → StandardRB → rubysmith → community)
      conventions.md               # Fallback community idiom patterns
  rubysmithing-context/            # Context7 + SQLite cache
    agents/rubysmithing-context.md
    commands/context.md
    references/
      gem-registry.md              # Context7 IDs × architectural roles (225 entries)
    scripts/
      context_cache.rb             # CLI: list, check, stale, evict
  rubysmithing-tui/                # Bubble/TUI scaffolding
    agents/rubysmithing-tui.md
    references/
      tui-patterns.md              # Context7-verified Bubble gem API patterns
      design-patterns.md           # Architecture decisions, layout paradigms, anti-patterns
    assets/skeleton/               # Bubble app template (rename app_name → your_app)
  rubysmithing-scaffold/           # rubysmith/gemsmith project init
    agents/rubysmithing-scaffold.md
    commands/scaffold.md
  rubysmithing-genai/              # LLM, RAG, DSPy, MCP, embeddings
    agents/rubysmithing-genai.md
  rubysmithing-refactor/           # Convention-targeted refactoring
    agents/rubysmithing-refactor.md
    commands/refactor.md
  rubysmithing-report/             # SIFT Protocol V1.0 QA
    agents/
      rubysmithing-report.md
      rubysmithing-meta-judge.md   # SADD: generates Ruby-calibrated YAML eval specs
      rubysmithing-judge.md        # SADD: applies eval specs with file:line evidence
    commands/report.md
  rubysmithing-yardoc/             # YARD docs with semantic AST analysis
    agents/rubysmithing-yardoc.md
    commands/yardoc.md
  rubysmithing-analyse/            # Gemba Walk, Muda, Root-Cause, Five Whys
    agents/rubysmithing-analyse.md
    commands/analyse.md
    references/
      analyse-methods.md           # Four methods with templates
    scripts/