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

•

Herramientas de Colaboración

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

Acerca de

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.

Características Principales

Iterative debate rounds with structured challenge and response cycles
Configurable convergence criteria including majority rule or hybrid synthesis
Multi-perspective simulation covering Security, Scalability, Cost, and more
Standardized Architecture Decision Record (ADR) generation and storage
17 GitHub stars
Automated facilitator synthesis using neutral architect and analyzer agents

Casos de Uso

Choosing between competing technologies like REST vs. GraphQL or SQL vs. NoSQL
Evaluating the long-term trade-offs of major infrastructure or framework migrations
Resolving technical stalemates by surfacing objective evidence for different implementation paths

Acerca de

Características Principales

Iterative debate rounds with structured challenge and response cycles
Configurable convergence criteria including majority rule or hybrid synthesis
Multi-perspective simulation covering Security, Scalability, Cost, and more
Standardized Architecture Decision Record (ADR) generation and storage
17 GitHub stars
Automated facilitator synthesis using neutral architect and analyzer agents

Casos de Uso

Choosing between competing technologies like REST vs. GraphQL or SQL vs. NoSQL
Evaluating the long-term trade-offs of major infrastructure or framework migrations
Resolving technical stalemates by surfacing objective evidence for different implementation paths