What is the Debate Workflow skill for Claude Code?

It is a specialized skill that uses multiple AI perspectives to simulate a technical debate, helping developers make and document complex architectural decisions.

Is this skill suitable for small code changes?

No, it is designed for high-impact decisions where multiple valid approaches exist. For routine feature additions or minor refactoring, a standard workflow is recommended.

Can I customize the viewpoints included in the debate?

Yes, you can configure between 3 and 7 perspectives, including specialized profiles for Security, Performance, Maintainability, Cost, and User Experience.

How do I trigger a debate session?

You can use the explicit command /amplihack:debate or it will auto-activate when Claude detects keywords like 'architectural decision' or 'design trade-off'.

What is the final output of a debate workflow?

The workflow produces a detailed Decision Record (ADR) containing the rationale, the full debate transcript, dissenting opinions, and implementation guidance.

Architectural Debate Workflow

Name: Architectural Debate Workflow
Author: rysweet

byrysweet

•

コラボレーションツール

Facilitates structured, multi-perspective debates to resolve complex architectural trade-offs and technical decisions using AI-driven simulation.

The Debate Workflow skill empowers Claude to perform rigorous technical analysis by simulating a panel of specialized agents representing diverse perspectives like Security, Performance, and Simplicity. When faced with high-stakes decisions—such as framework selection or system refactoring—this skill executes iterative rounds of position-stating, cross-examination, and synthesis. It surfaces hidden risks, evaluates evidence objectively, and produces a comprehensive Decision Record (ADR), ensuring that architectural choices are well-reasoned, documented, and balanced across competing technical priorities.

主な機能

01Iterative debate rounds with structured challenge and response cycles

02Configurable convergence criteria including majority rule or hybrid synthesis

03Multi-perspective simulation covering Security, Scalability, Cost, and more

04Standardized Architecture Decision Record (ADR) generation and storage

0517 GitHub stars

06Automated facilitator synthesis using neutral architect and analyzer agents

ユースケース

01Choosing between competing technologies like REST vs. GraphQL or SQL vs. NoSQL

02Evaluating the long-term trade-offs of major infrastructure or framework migrations

03Resolving technical stalemates by surfacing objective evidence for different implementation paths

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add rysweet/amplihack debate-workflow

For use in Claude.ai and ChatGPT

Download Skill