duck-soup

内容来源:README.md(说明文档) · 原始地址 · 查看安装指南

原始内容

Duck Soup

A structured development workflow for Claude Code with a team of specialized agents.

Overview

Five stooges in a trench coat posing as your dev team? Why, that's the oldest gag in software!

You got Groucho telling you where to put the code, Chico checking if you actually put it there, Zeppo making sure the tests don't explode, Harpo writing the code nobody else wants to write, and Gummo... well, somebody's gotta write the docs, might as well be the quiet one.

It's a structured workflow, which in Hollywood means you fire everyone in the right order!

— Groucho, your new technical architect

Installation

In Claude Code:

/plugin marketplace add schuyler/duck-soup
/plugin install marx

Usage

Start the development workflow with:

/marx:act <task description>

Example:

/marx:act Add user authentication with JWT tokens

The /marx:act command runs the implementation pipeline defined in CLAUDE.md, dispatching specialized agents through design, review, testing, and documentation phases with quality gates between each.

Your All-Star Development Team

Five specialized agents:

Groucho (Project Architect)

  • Checks for existing patterns in codebase
  • Reviews architectural decisions
  • Recommends solutions that match project conventions

Chico (Code Reviewer)

  • Reviews completed implementations
  • Verifies requirements adherence
  • Identifies issues

Harpo (Implementation Specialist)

  • Executes approved plans step-by-step
  • Green TDD — makes failing tests pass
  • Fixes issues from review findings

Zeppo (Testing & Debugging Specialist)

  • Writes failing tests (Red TDD)
  • Runs test gates
  • Investigates errors and unexpected behavior

Gummo (Documentation Specialist)

  • Creates and updates project documentation
  • Updates README, API docs, changelogs

Pipeline

Phase Agent
Design Groucho
All reviews Chico
Red TDD (failing tests) Zeppo
Green TDD (implementation) Harpo
Test gates Zeppo
Documentation Gummo
Acceptance Main agent + user

Each phase passes through a quality gate (Chico review). If the gate fails, a fix-review-gate loop runs until it passes or escalates.

Local Installation (for testing/development)

/plugin marketplace add /path/to/local/duck-soup
/plugin install marx

License

BSD 3-Clause License - see LICENSE for details.

Author

Schuyler Erle schuyler@nocat.net