chaos

Parliament of Chaos

A Claude Code plugin that summons a council of opinionated AI specialists to plan, build, review, and refine your projects through structured debate and iteration.

---

What Is This?

Parliament of Chaos transforms Claude Code into a multi-agent development team. Instead of a single AI assistant, you get:

• 33 Agents including specialists, planners, reviewers, and orchestrators
• 12 Grumpy Reviewers who find flaws others miss (security, quality, privacy, i18n, cost, and more)
• 66 Slash Commands across 15 categories: project planning, code review, deliberation, developer workflow, hygiene, quality, release, observability, decisions, lifecycle, and operations
• commands/manifest.yaml — declarative registry that acts as the source of truth for every command, reconciled by /parliament-doctor

The result: thoroughly planned projects, battle-tested code, and solutions that have survived scrutiny from multiple perspectives.

---

Quick Start

Install the Plugin

claude plugin marketplace add https://github.com/JackScammell/Parliament-Of-Chaos.git
claude plugin install chaos@chaos

Your First Command

For code review and development tasks:

/summon-council Design an authentication system with JWT and RBAC

For onboarding to an undocumented codebase:

/onboard-codebase

For planning a new project:

/plan-project A CLI tool for managing Docker containers

---

Commands

All 66 commands are declared in commands/manifest.yaml, which acts as the source of truth for command name, status, owner agent, effort tier, and category. Run /parliament-doctor to reconcile the manifest against the filesystem and skill registry.

Not the same as Claude Code's built-in /code-review. Parliament's review commands (/summon-grumpy-reviewer, /parliament-review) run the plugin's grumpy-reviewer fleet against your working changes and are invoked directly. Claude Code also ships a separate built-in /code-review (as of recent versions, manual-only and dispatched to a background subagent) that is unrelated to Parliament and applies its own review model. When you want the Parliament governance flow, use the /chaos: review commands; the bare /code-review is the upstream feature.

Agent Invocation

Command	Description
/ask-council <question>	Ask the council a question. Auto-selects 2–5 specialists, consults them in parallel, and returns a single synthesised answer with consensus and disagreements surfaced. No fix loop, no artifact, no code edits
/summon-council [plan|implement] [task]	Two-mode orchestrator — plan writes a spec to .project-files/plans/, implement runs full specialist + 9-grump cycle. Always opens with an Explore inventory pass so the council extends existing capabilities rather than creating duplicates
/summon-specialist <agent>	Directly invoke a specialist agent on your current task
/summon-grumpy-reviewer	Quick, ruthless code review from a senior developer perspective
/parliament-review	Full review using all 12 grumpy reviewers for maximum scrutiny

Deliberation

Command	Description
/debate-topic [topic]	Structured multi-agent deliberation with convergence detection
/debate-analytics [topic]	Analytics dashboard with metrics and insights for a debate
/debate-replay <session>	Deterministic replay of a past debate from a session snapshot

Project Planning

Command	Description
/plan-project [description]	Interactive Q&A to create project-outline.md, feature-implementation.md, and Roadmap.md
/project-status	Dashboard showing roadmap progress across all phases
/roadmap-add-item <name> --phase <n>	Add a new item to an existing roadmap
/roadmap-item-scope <item>	Create detailed Spec.md and tasks.md for a roadmap item
/implement-task-list [item]	Execute tasks with full council review (specialists + grumpy approval)

Developer Workflow