mcp-toolbox-workflows

MCP Toolbox Workflows Plugin

Composite workflows that orchestrate Julie (code intelligence), Sherpa (workflow guidance), and Goldfish (persistent memory) for powerful, systematic development patterns.

Overview

This plugin provides composite Skills that combine the strengths of all three MCP toolbox servers:

• Julie: Fast code intelligence, semantic search, safe refactoring
• Sherpa: Workflow guidance with behavioral adoption
• Goldfish: Persistent memory and progress tracking

Together, they create workflows that are greater than the sum of their parts.

Requirements

This plugin requires all three MCP servers installed and configured:

1. Julie - Code intelligence server Fast semantic search, symbol navigation, safe refactoring

2. Sherpa - Workflow guidance server Systematic development phases with behavioral adoption

3. Goldfish - Persistent memory server Checkpoint progress, recall context, manage plans

Install all three MCP servers first by following the installation instructions in each repository above.

Installation

Step 1: Install MCP Servers

Install the three required MCP servers by following the instructions in each repository:

1. Julie Installation - Download binary or build from source
2. Sherpa Installation - Bun + TypeScript setup
3. Goldfish Installation - Bun + TypeScript setup

Make sure all three are added to your Claude Desktop claude_desktop_config.json and working.

Step 2: Install This Plugin

# Clone this repository
git clone https://github.com/anortham/mcp-toolbox-workflows.git

Then install the plugin in Claude Code according to the Claude Code plugin documentation.

That's it! The composite skills will automatically activate when appropriate based on your task context.

Composite Skills

🧪 TDD Powerhouse

Complete Test-Driven Development

Orchestrates all three tools for systematic TDD:

• Sherpa guides through 4 phases
• Julie searches patterns and provides safe refactoring
• Goldfish checkpoints after each phase

Phases:

1. Define Contract - Julie finds similar patterns
2. Write Tests - Julie shows test examples
3. Implement - Julie aids navigation
4. Refactor - Julie enables safe refactoring

Activates when: Implementing new features, building from scratch

Example:

User: "Implement Stripe payment processing"

→ TDD Powerhouse activates
→ Sherpa guides through phases
→ Julie finds payment patterns in codebase
→ Goldfish checkpoints: design, tests, implementation, refactor
→ Result: Clean, tested payment processing with full history

🕵️ Bug Detective

Systematic Bug Hunting

Combines investigation tools for methodical debugging:

• Sherpa guides 4-phase bug hunt
• Julie traces execution and finds errors
• Goldfish documents investigation trail

Phases:

1. Reproduce & Isolate - Julie traces execution paths
2. Capture in Test - Julie finds test patterns
3. Fix the Bug - Julie enables safe fixes
4. Verify & Prevent - Julie checks impact

Activates when: Fixing bugs, debugging errors

Example:

User: "Users randomly getting logged out"

→ Bug Detective activates
→ Julie traces session.destroy() execution
→ Discovers race condition
→ Goldfish checkpoints investigation steps
→ Sherpa guides to test, fix, verify
→ Result: Bug fixed with test coverage and documented solution

🚀 Smart Session Start

Intelligent Context Restoration (MANDATORY)

Automatically restores full working context:

• Goldfish recalls last 7 days of work
• Julie re-indexes if needed
• Sherpa suggests appropriate workflow

Activates at: Every session start (automatic!)

What it does:

1. Recalls recent checkpoints and plans
2. Analyzes work patterns
3. Ensures workspace indexed
4. Suggests next workflow
5. Presents actionable next steps

Example:

[Claude Code starts]

→ Smart Session Start activates automatically
→ Goldfish: "Last session 2 hours ago - wrote 8 tests for PaymentService"
→ Julie: Workspace indexed, 247 files ready
→ Sherpa: "TDD Phase 2 complete, ready for Phase 3: Implementation"
→ Present: "Welcome back! Ready to implement PaymentService?"

🔄 Refactor with Confidence

Safe Code Improvement

Systematic refactoring with test protection:

• Sherpa guides refactor workflow
• Julie provides safe rename and reference checking
• Goldfish preserves before/after state

Phases:

1. Tests First - Ensure coverage
2. Refactor Code - Julie safe tools
3. Verify - Tests stay green

Activates when: Refactoring, code cleanup, reorganizing