futuregerald-claude-plugin

futuregerald-claude-plugin

A Claude Code plugin that adds a curated library of AI coding skills and agents, a cross-platform CLI installer, and an optional GitHub workflow integration with project management.

Table of Contents

• What This Plugin Does
  • CLAUDE.md — Your Project's AI Configuration
  • Skills — Teaching Claude How to Work
  • Agents — Specialized Sub-Agents
  • Development Workflow — A Structured Lifecycle
• Installation
• Skills and Agents Reference
• CLI Installer
• Configuration
• Codebase Memory MCP (Optional)
• Building from Source
• GitHub Workflow (Optional — Beta)
  • Slash Commands
  • Workflow Lifecycle
  • Review Modes
  • Issue Tracking
  • Git Worktrees
• Attribution

What This Plugin Does

This repository works in two ways:

• As a Claude Code plugin -- Installed via symlink or --plugin-dir. Provides slash commands, skills, and agents directly inside Claude Code sessions.
• As a standalone CLI tool (skill-installer) -- Installs skills, agents, and commands for Claude Code, GitHub Copilot, Cursor, OpenCode, and VS Code.

CLAUDE.md — Your Project's AI Configuration

A CLAUDE.md file sits at the root of your project and tells Claude Code how to work in that codebase. It defines:

• Project name and description — what the project is
• Key directories — where important code lives (src/, lib/, tests/, etc.)
• Commands — how to test (go test ./...), typecheck (npx tsc --noEmit), and build
• Development lifecycle — the phases Claude follows: plan, implement with TDD, test, simplify, review, commit
• Language-specific rules — coding conventions, style guides, and best practices for the detected framework

The plugin auto-detects your project type (Go, Node.js/React/Next.js/AdonisJS/Svelte/Express, Rust, Python, Ruby, PHP) and generates a CLAUDE.md with real values filled in — no manual editing of {{placeholders}} required.

Generate one with:

/init-claude-md my-project-name

Or via the CLI:

skill-installer --mode config-only --target claude --yes

Skills — Teaching Claude How to Work

Skills are markdown-based instruction sets that give Claude specialized knowledge and workflows. When invoked, Claude follows the skill's process exactly. The plugin includes 48 skills covering:

• Test-driven development — RED/GREEN/REFACTOR cycle
• Systematic debugging — root-cause-first protocol with feedback-loop construction
• Planning & specs — plans, PRDs, specs, and tracer-bullet tickets, with review checkpoints
• Code review & quality — parallel-agent review, simplification, and skill review
• Architecture & modeling — deep-module design, domain models, and ADRs
• Delivery & EM workflows — PR descriptions, ticket grooming, team pulse, Datadog dashboards

Skills are invoked by name in Claude Code:

/futuregerald-claude-plugin:systematic-debugging
/futuregerald-claude-plugin:test-driven-development
/futuregerald-claude-plugin:brainstorming

Agents — Specialized Sub-Agents

Agents are dispatched via the Task tool to handle focused work with fresh context. The plugin includes 9 agents: code quality reviewer, code simplifier (with Staff Engineer review), codebase searcher, context finder (index/memory-aware read-only search), debugger, implementer, security reviewer, spec reviewer, and SQL performance reviewer.

Development Workflow — A Structured Lifecycle

The plugin defines a 10-phase development lifecycle in the generated CLAUDE.md:

 1. RECEIVE     Understand task, create todo list
 2. PLAN        Write implementation plan
 3. REVIEW      Staff Engineer sub-agent reviews the plan
 4. IMPLEMENT   Write code following TDD
 5. TEST        Run tests and type checking
 6. SIMPLIFY    Code-simplifier agent analyzes for improvements
 7. CODE REVIEW Code-reviewer sub-agent reviews changes
 8. SQL REVIEW  Staff Engineer audits queries for performance, security, defensive coding
 9. COMMIT      Commit to feature branch
10. PUSH + PR   Push and create PR (if gh available)
11. VERIFY CI   Check CI passes; auto-merge when green

Each phase has a gate — the workflow doesn't advance until the gate passes. This works entirely locally. For teams using GitHub, an optional beta workflow adds issue tracking, worktrees, and autonomous PR review (see GitHub Workflow below).

Installation

As a Claude Code Plugin