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:
- 30 Agents including specialists, planners, reviewers, and orchestrators
- 9 Grumpy Reviewers who find flaws others miss
- 34 Slash Commands for project planning, code review, deliberation, developer workflow, monitoring, and operations
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
Council Commands
| Command | Description |
|---|
/summon-council [task] | Orchestrate specialists + grumpy review cycle for complex tasks |
/summon-grumpy-reviewer | Quick, ruthless code review from a senior developer perspective |
/parliament-review | Full review using all 9 grumpy reviewers for maximum scrutiny |
/summon-specialist <agent> | Directly invoke a specialist agent on your current task |
/debate-topic [topic] | Run structured multi-agent deliberation with convergence detection |
Discovery Commands
| Command | Description |
|---|
/list-agents | Display all agents grouped by category |
/list-commands | Display all commands grouped by category |
/explain-agent <agent> | Detailed explanation of what an agent does and when to use it |
/version | Display current plugin version and metadata |
/readme | Display the full README in the session |
/changelog | Display the full version history |
Project Planning Commands
| 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) |
Codebase Analysis Commands
| Command | Description |
|---|
/onboard-codebase | Analyse an undocumented codebase in parallel and generate comprehensive docs/getting_started/ documentation |
Operations Commands
| Command | Description |
|---|
/parliament-optimize | Audit agent definitions and recommend effort/model settings |
/parliament-webhook | Configure webhook notification endpoints (Teams, Slack, Discord) |
/parliament-loop | Set up recurring Parliament commands via /loop integration |
/parliament-monitor | Manage background monitoring agents for continuous oversight |
/changelog-review | Review Claude Code changelog and propose new features |
Developer Workflow Commands
| Command | Description |
|---|
/pre-commit-check | Auto-detect and run all CI checks locally before committing |
/format-code | Auto-detect and run the project's code formatter |
/lint-fix | Auto-detect and run linter(s) with auto-fix |
/run-tests [--changed] [--explain] | Auto-detect and run the test suite with intelligent options |
/security-scan | Unified security check: dependencies, secrets, vulnerability patterns |
/clean-imports | Remove unused imports and organise import ordering |
/update-dependencies | Interactive dependency update with changelog review and test verification |
/dead-code-sweep | Find unreachable code, unused exports, and orphaned files |
/update-docs | Detect and update documentation affected by recent code changes |
Analytics & Plugin Commands
| Command | Description |
|---|
/debate-analytics [topic] | Generate comprehensive analytics dashboard with metrics and insights |
/plugin-install <name> | Install community agent plugins from the marketplace |
/plugin-list | List all installed plugins and marketplace summary |
Agents
Orchestration Agents (2)
JackScammell