felipecustodio Overview & Purpose
Collaborative Reasoning models multi-perspective discussions by simulating specialized domain experts (e.g. Security Specialist, Performance Engineer, UX Designer) to evaluate solutions fully.
When to Use
- Cross-Functional Architecture Reviews: Evaluating software designs across security, scalability, and developer experience.
- Consensus Building: Resolving conflicting priorities among stakeholders.
Execution Workflow
- Define Expert Personas: Assign distinct roles (e.g.,
Persona A: Security Lead,Persona B: Systems Architect). - Independent Persona Analysis: Generate feedback from each persona's strict domain perspective.
- Identify Conflicts & Trade-offs: Highlight where persona priorities clash (e.g. security vs convenience).
- Synthesize Consensus: Negotiate a balanced solution addressing key concerns from all personas.
Expected Output Contract
### Multi-Persona Panel Review
- **Perspectives**:
- `Security Lead`: [Domain Feedback]
- `Architecture Lead`: [Domain Feedback]
- **Identified Clashes**: [Conflict Summary]
- **Consensus Recommendation**: [Harmonized Solution]
Scripts
scripts/collaborative_reasoning.py- Deterministic evaluation, state validation, and CLI tool for collaborative-reasoning.