spring-crew

Spring Crew

Five specialists that don't just write code: they think about it, they challenge you, they design it, build it, and hold it accountable.

A five-agent AI development pipeline for Spring Boot · Clean Architecture · UseCase pattern · Production-ready · Automated workflow orchestration

---

🤖 For LLM Agents

Paste this into any coding agent to install and configure Spring Crew:

Install and configure by following the instructions here:
https://raw.githubusercontent.com/marcelorodrigo/spring-crew-plugin/master/README.md

---

🔁 The Pipeline

Spring Crew works best as a pipeline.

You start with a rough idea and end with reviewed, production-ready code: each agent handing off to the next like a relay race, each one knowing exactly what to expect from the previous and what to produce for the next.

flowchart TD
    User["👤 User Request"] -->|"Jira Ticket / Feature"| ORCH["🎯 Orchestrator"]
    ORCH -->|"Delegates"| RD["🦆 Rubber Duck"]
    RD -->|"Brainstorm Brief"| ORCH
    ORCH -->|"Approval Gate (HITL)"| ORCH
    ORCH -->|"Delegates"| AR["🏛️ Architect"]
    AR -->|"Architecture Spec"| ORCH
    ORCH -->|"Approval Gate (HITL)"| ORCH
    ORCH -->|"Delegates"| IM["🔨 Implementer"]
    IM -->|"Implementation Summary"| ORCH
    ORCH -->|"Approval Gate (HITL)"| ORCH
    ORCH -->|"Delegates"| CR["🔍 Code Reviewer"]
    CR -->|"Code Review"| ORCH
    ORCH -->|"Final Report"| User

Two ways to work: Manual or Automated

Option 1: Orchestrator (Automated Pipeline)

Use the Orchestrator agent to manage the full pipeline automatically:

# Start the orchestrator
/agent spring-crew:orchestrator

# Provide your task
Task: JIRA-123: Add user authentication with JWT tokens

The Orchestrator will:

• ✅ Manage the full pipeline from Rubber Duck → Architect → Implementer → Code Reviewer
• ✅ Validate artifacts between each step
• ✅ Request approval at each stage (human-in-the-loop mode)
• ✅ Or run autonomously without approval gates (autonomous mode)
• ✅ Generate a complete execution report with all artifacts

Two execution modes:

1. Human-in-the-Loop (default): Pauses after each agent for approval

   Task: Add user authentication
   

2. Autonomous: Runs full pipeline without interruption

   Mode: autonomous
   Task: Add logging to PaymentService
   

Option 2: Manual Agent Switching

You don't switch context. You switch agents.

1. Start a conversation with the Rubber Duck: describe your idea, even half-baked or a rough draft is fine. The Rubber Duck will ask sharp questions, challenge your assumptions, and widen your thinking before you commit to anything. When the thinking is done, it produces a Brainstorm Brief right there in the conversation. Take that output, open a new session with the Architect, and paste it in.

2. The Architect reads the brief, explores your codebase, makes every binding technical decision: class names, package paths, API contracts, error handling, and produces an Architecture Spec. Take that spec to the Implementer.

3. The Implementer reads the spec, matches your codebase's conventions, writes production code with tests, runs the build, and produces an Implementation Summary with everything the reviewer needs to know. Take that to the Code Reviewer.

4. The Code Reviewer diffs against master, validates the implementation against the spec and Clean Architecture principles, and delivers a categorized review. Nothing ships past it without earning it.

You can also enter at any stage.

• Already know the direction? Skip the Rubber Duck and start with the Architect.
• Already have a spec? Hand it straight to the Implementer.
• Want an expert eye on existing code? Point the Code Reviewer at a branch.
• Use the Orchestrator to automate the full pipeline.

The pipeline is the recommended path, but each agent stands on its own.

---

⚡ Quick Start

opencode

One-liner install (global):

opencode plugin @marcelorodrigo/opencode-spring-crew --global

Or add manually to your opencode.json:

{
  "plugin": [
    "@marcelorodrigo/opencode-spring-crew"
  ]
}

Claude Code

Step 1 — Add the Spring Crew marketplace:

claude plugin marketplace add marcelorodrigo/spring-crew-plugin

Step 2 — Install the plugin:

claude plugin install spring-crew@spring-crew-plugin

Step 3 — Verify:

/agents
# Rubber Duck, Architect, Implementer, Code Reviewer should appear

GitHub Copilot CLI

Step 1 — Register the Spring Crew marketplace:

copilot plugin marketplace add marcelorodrigo/spring-crew-plugin

Step 2 — Install the plugin: