
Recursive Synthesis
- 89 installs
- 178 repo stars
- Updated July 14, 2026
- erichowens/some_claude_skills
Orchestrate multi-agent document synthesis through 6 rigorous phases with adversarial review.
About
Produces authoritative founding documents (constitutions, charters, architecture records) via Divergence, Synthesis, Commentary, Consolidation, Reality Check, and Merge phases. Surfaces irreconcilable tensions rather than burying them.
- 6-phase orchestration with fresh-eyes practitioner review in phase 5
- Dissenting Appendix for tensions that cannot be resolved
Recursive Synthesis by the numbers
- 89 all-time installs (skills.sh)
- Ranked #275 of 782 Skill Development skills by installs in the Skillselion catalog
- Data as of Aug 4, 2026 (Skillselion catalog sync)
npx skills add https://github.com/erichowens/some_claude_skills --skill recursive-synthesisAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 89 |
|---|---|
| repo stars | ★ 178 |
| Last updated | July 14, 2026 |
| Repository | erichowens/some_claude_skills ↗ |
What it does
Orchestrate multi-agent document synthesis through 6 rigorous phases with adversarial review.
Files
Recursive Synthesis
You are an orchestrator of multi-agent collaborative document synthesis. You guide complex, multi-perspective inputs through a 6-phase process that produces authoritative founding documents - constitutions, charters, architectural decisions, and other documents that require rigorous adversarial review and synthesis.
When to Use
Use for:
- Constitutional documents (governance, principles, values)
- Architecture decision records requiring multiple stakeholder perspectives
- Organizational charters with competing concerns
- Founding documents that will govern future decisions
- Any document where "getting it right" matters more than speed
- Documents where irreconcilable tensions must be surfaced, not buried
NOT for:
- Simple documentation or README files
- Single-author technical writing
- Quick summaries or reports
- Documents with clear, uncontested scope
- Time-sensitive deliverables (this process takes 6+ phases)
---
The 6-Phase Process
Phase 0: SETUP
│
v
Phase 1: DIVERGENCE ──────────────────────────────────────┐
│ (10 agents write position papers in parallel) │
v │
Phase 2: SYNTHESIS │
│ (Synthesizer reads all 10, creates ranked hierarchy) │
v │
Phase 3: COMMENTARY ──────────────────────────────────────┤
│ (10 agents review synthesis, steel-man + critique) │
v │
Phase 4: CONSOLIDATION │
│ (Lead Architect merges into Soul Document) │
v │
Phase 5: REALITY CHECK │
│ (PM/EM/Design provide fresh-eyes practitioner review)│
v │
Phase 6: FINAL MERGE
│ (Polymath Editor produces Constitution + Guide)
v
OUTPUT: Constitution, Practitioner's Guide, Editorial Notes---
Phase 0: Setup
Purpose: Define the problem space, establish ground rules, select agents.
Key Decisions
1. Problem Definition: What question/document are we synthesizing? 2. Agent Selection: Which 10 intellectual traditions/perspectives? 3. Ground Rules:
- Steel-man requirement (acknowledge strengths before critiquing)
- Ranked choice voting for principle hierarchy
- Dissenting Appendix for irreconcilable tensions
- PM/EM/Design EXCLUDED from Phases 1-4 (fresh eyes for Phase 5)
Agent Selection Guidelines
Choose agents that represent genuinely different intellectual traditions:
| Domain | Example Agents |
|---|---|
| Philosophy | Pragmatist, Rationalist, Empiricist, Virtue Ethicist |
| Engineering | Systems Thinker, Reliability Engineer, Security Expert, Performance Optimizer |
| Design | User Advocate, Accessibility Champion, Minimalist, Brand Strategist |
| Business | Product Strategist, Risk Manager, Growth Expert, Sustainability Advocate |
| Academic | Complexity Theorist, Organizational Psychologist, Game Theorist |
Selection criteria:
- Maximum cognitive diversity (different thinking styles)
- Genuine expertise in their domain
- Ability to articulate clear principles
- Known for intellectual honesty
File Structure
Create this directory structure:
synthesis-project/
├── phase-0-setup/
│ ├── problem-definition.md
│ ├── agent-roster.md
│ └── ground-rules.md
├── phase-1-divergence/
│ ├── agent-1-position.md
│ ├── agent-2-position.md
│ └── ... (one per agent)
├── phase-2-synthesis/
│ ├── principle-hierarchy.md
│ └── structural-skeleton.md
├── phase-3-commentary/
│ ├── agent-1-commentary.md
│ ├── agent-2-commentary.md
│ └── ... (one per agent)
├── phase-4-consolidation/
│ ├── soul-document.md
│ └── dissenting-appendix.md
├── phase-5-reality-check/
│ ├── pm-reality-report.md
│ ├── em-reality-report.md
│ └── design-reality-report.md
├── phase-6-final/
│ ├── constitution.md
│ ├── practitioners-guide.md
│ └── editorial-notes.md
└── meta/
├── process-log.md
└── cost-tracking.md---
Phase 1: Divergence
Purpose: Generate maximum intellectual diversity. Each agent writes independently.
Execution
- Parallelization: All 10 agents run simultaneously
- No cross-talk: Agents cannot see each other's work
- Model selection: Use Opus for complex philosophical agents, Sonnet for domain-specific technical agents
Agent Prompt Template
You are [AGENT_NAME], an expert in [DOMAIN] with deep knowledge of [SPECIFIC_EXPERTISE].
## Your Task
Write a position paper (1500-2500 words) addressing this question:
[PROBLEM_DEFINITION]
## Your Intellectual Tradition
You approach this from the perspective of [TRADITION]. Your core beliefs include:
- [BELIEF_1]
- [BELIEF_2]
- [BELIEF_3]
## Requirements
1. State your non-negotiable principles clearly
2. Explain WHY these principles matter from your perspective
3. Acknowledge potential tensions with other viewpoints
4. Propose concrete structural recommendations
5. Include specific examples or case studies
## Format
- Start with a 3-sentence executive summary
- Use headers to organize your argument
- End with a ranked list of your top 5 principlesQuality Gate
Before proceeding to Phase 2, verify:
- [ ] All 10 position papers received
- [ ] Each paper has clear principle statements
- [ ] Papers represent genuinely different perspectives
- [ ] No agent simply restated another's position
---
Phase 2: Synthesis
Purpose: Find common ground and create a hierarchy of principles.
Execution
- Single agent: One Synthesizer reads all 10 papers
- Model selection: Opus (requires deep reasoning across long context)
- Output: Ranked principle hierarchy + structural skeleton
Synthesizer Prompt Template
You are the Synthesizer. You have read 10 position papers from different intellectual traditions on this question:
[PROBLEM_DEFINITION]
## Your Task
### Part 1: Principle Extraction
For each position paper, extract:
1. The 3-5 non-negotiable principles stated
2. The underlying values driving those principles
3. The specific recommendations made
### Part 2: Convergence Analysis
Identify:
1. **Universal principles**: Stated by 8+ agents
2. **Strong consensus**: Stated by 5-7 agents
3. **Significant minority**: Stated by 3-4 agents
4. **Unique contributions**: Stated by 1-2 agents but compelling
### Part 3: Tension Mapping
For each pair of conflicting principles:
1. State the tension clearly
2. Identify if it's reconcilable or fundamental
3. Propose resolution strategies (if reconcilable)
4. Flag for Dissenting Appendix (if fundamental)
### Part 4: Ranked Hierarchy
Using ranked-choice voting logic:
1. Rank all principles by consensus level
2. Break ties by reasoning about which principles subsume others
3. Create a hierarchy: foundational → derived → implementation
### Part 5: Structural Skeleton
Propose a document structure that:
1. Honors the principle hierarchy
2. Gives voice to minority positions
3. Provides actionable guidance
4. Separates philosophy from implementation
## Output Format
Produce two documents:
1. `principle-hierarchy.md`: The ranked principles with justification
2. `structural-skeleton.md`: The proposed document outlineQuality Gate
Before proceeding to Phase 3, verify:
- [ ] Principle hierarchy is clear and justified
- [ ] Tensions are explicitly mapped
- [ ] Structural skeleton addresses all major themes
- [ ] No position paper was ignored or misrepresented
---
Phase 3: Commentary
Purpose: Adversarial review of synthesis. Each original agent critiques.
Execution
- Parallelization: All 10 agents run simultaneously
- Steel-man requirement: MUST acknowledge what synthesis got right before critiquing
- Model selection: Same model used for that agent in Phase 1
Commentary Prompt Template
You are [AGENT_NAME]. You wrote a position paper in Phase 1.
You have now received the Synthesizer's work:
- Principle Hierarchy
- Structural Skeleton
## Your Task
### Part 1: Steel-Man (REQUIRED)
Before any critique, you MUST:
1. Identify 3 things the synthesis got RIGHT about your position
2. Acknowledge where the synthesis improved on your original thinking
3. Note any surprising connections to other agents' positions
### Part 2: Critique
Now you may critique:
1. Where your position was misrepresented
2. Where the ranking undervalues your principles
3. Where the structural skeleton fails to address your concerns
4. Specific wording that contradicts your intent
### Part 3: Constructive Amendments
Propose specific changes:
1. Exact wording modifications
2. Structural reorganization
3. Additional sections needed
4. Principles that should be elevated/demoted
### Part 4: Irreconcilable Tensions
If you believe a fundamental tension exists that CANNOT be resolved:
1. State the tension clearly
2. Explain why it's fundamental (not just difficult)
3. Propose how the Dissenting Appendix should handle it
## Format
- Start with steel-man section (mandatory)
- Use constructive language throughout
- Be specific (line numbers, exact quotes)
- Propose solutions, not just problemsQuality Gate
Before proceeding to Phase 4, verify:
- [ ] All 10 commentaries received
- [ ] Each commentary includes steel-man section
- [ ] Critiques are specific and actionable
- [ ] Irreconcilable tensions are clearly flagged
---
Phase 4: Consolidation
Purpose: Merge synthesis + commentaries into a unified Soul Document.
Execution
- Single agent: Lead Architect
- Model selection: Opus (requires nuanced judgment across many inputs)
- Output: Soul Document + Dissenting Appendix
Lead Architect Prompt Template
You are the Lead Architect. You have:
- The original 10 position papers
- The Synthesizer's principle hierarchy and skeleton
- 10 commentary documents from the original agents
## Your Task
### Part 1: Commentary Integration
For each of the 10 commentaries:
1. Document which critiques you're accepting (and why)
2. Document which critiques you're rejecting (and why)
3. Note any critique that reveals a flaw in the synthesis
### Part 2: Soul Document
Create a single document that:
1. Embodies the principle hierarchy (with accepted modifications)
2. Follows the structural skeleton (with accepted modifications)
3. Speaks with one coherent voice
4. Includes concrete, actionable guidance
5. Is honest about its scope and limitations
### Part 3: Dissenting Appendix
For tensions that could NOT be reconciled:
1. State each tension clearly
2. Present each side's strongest argument
3. Explain why this document took the position it did
4. Acknowledge the legitimate concerns of the minority position
5. Suggest conditions under which this might be revisited
### Part 4: Scope Documentation
Document:
1. What this document IS authoritative about
2. What this document explicitly does NOT address
3. What decisions are deferred to future work
4. What principles might be phased in over time
## Output Format
Produce two documents:
1. `soul-document.md`: The unified founding document
2. `dissenting-appendix.md`: The documented tensions and minority positionsQuality Gate
Before proceeding to Phase 5, verify:
- [ ] Soul Document has coherent voice
- [ ] All major positions are represented fairly
- [ ] Dissenting Appendix handles tensions honestly
- [ ] Scope is clearly documented
---
Phase 5: Reality Check
Purpose: Fresh-eyes practitioner review. PM/EM/Design were NOT in Phases 1-4.
Execution
- Three agents: Product Manager, Engineering Manager, Design Lead
- Fresh eyes: These agents have NOT seen any prior work
- Model selection: Opus (need senior judgment)
- Brutal honesty: License to be skeptical
Why Fresh Eyes Matter
The agents in Phases 1-4 developed shared context and vocabulary. They may have:
- Over-indexed on philosophical elegance
- Lost sight of practical implementation
- Used jargon that's impenetrable to outsiders
- Made assumptions that aren't obvious
Fresh practitioners catch these blind spots.
Reality Check Prompt Template
You are the [PM/EM/DESIGN_LEAD]. You are reviewing a founding document for the first time.
You were deliberately EXCLUDED from the creation process. Your job is to bring fresh eyes and practical skepticism.
## The Document
[SOUL_DOCUMENT]
## Your Task
### Part 1: First Impressions
Before deep analysis, note:
1. What's your gut reaction?
2. What's clear vs. confusing?
3. What's missing that you expected?
4. What's present that surprises you?
### Part 2: Practitioner Audit
From your [PM/EM/DESIGN] perspective:
1. Can this actually be implemented?
2. What's the realistic timeline?
3. What resources would this require?
4. What existing constraints does this ignore?
5. What stakeholders would object and why?
### Part 3: Jargon Check
Flag any:
1. Undefined terms
2. Circular definitions
3. Insider language
4. Concepts that need examples
### Part 4: Gap Analysis
What's missing?
1. Processes needed but not defined
2. Responsibilities unclear
3. Metrics undefined
4. Edge cases not addressed
### Part 5: Verdict
Choose ONE:
- **SHIP**: Ready for adoption with minor edits
- **BUILD**: Needs significant work in specific areas
- **COMPLEX**: Fundamentally needs rethinking
Include specific demands for what must change for you to upgrade your verdict.
## Format
- Be direct and concrete
- Use examples from your domain
- Propose solutions, not just problems
- Prioritize your concerns (P0/P1/P2)Quality Gate
Before proceeding to Phase 6, verify:
- [ ] All 3 reality reports received
- [ ] Each report includes verdict (SHIP/BUILD/COMPLEX)
- [ ] Specific demands are actionable
- [ ] Fresh perspective is genuinely fresh (not just restating Phase 1-4)
---
Phase 6: Final Merge
Purpose: Produce the final deliverables for different audiences.
Execution
- Single agent: Polymath Editor
- Model selection: Opus (highest quality writing)
- Output: Constitution + Practitioner's Guide + Editorial Notes
Polymath Editor Prompt Template
You are the Polymath Editor. You have:
- The Soul Document (from Phase 4)
- The Dissenting Appendix (from Phase 4)
- Three Reality Reports (from Phase 5)
## Your Task
### Part 1: Address Reality Check Demands
For each P0 and P1 demand from the three Reality Reports:
1. Implement the change OR
2. Document why you're rejecting it
### Part 2: Constitution
Create the definitive founding document:
1. Written for posterity (will be read in 5+ years)
2. Uncompromising on principles
3. Clear on scope and authority
4. Includes Dissenting Appendix (edited for clarity)
5. Stands alone without needing other documents
### Part 3: Practitioner's Guide
Create a practical implementation guide:
1. Written for someone starting TODAY
2. Outside-in structure (start with "what do I do?")
3. Examples and templates
4. FAQ section addressing common questions
5. Phased rollout plan if applicable
### Part 4: Editorial Notes
Document your editorial process:
1. What changed from Soul Document to Constitution
2. Which Reality Check demands were accepted/rejected
3. What you consider the most important principles
4. What you consider the biggest risks
5. Advice for future editors
## Output Format
Produce three documents:
1. `constitution.md`: The authoritative founding document
2. `practitioners-guide.md`: The practical how-to guide
3. `editorial-notes.md`: The editorial process documentationQuality Gate
Final checklist:
- [ ] Constitution is coherent and authoritative
- [ ] Practitioner's Guide is actionable
- [ ] Editorial Notes explain all major decisions
- [ ] All P0 Reality Check demands addressed
- [ ] Dissenting Appendix is honest about tensions
---
Model Selection Guidelines
| Phase | Recommended Model | Reasoning |
|---|---|---|
| Phase 1 (philosophical agents) | Opus | Deep reasoning, nuanced positions |
| Phase 1 (technical agents) | Sonnet | Faster, still high quality for domain expertise |
| Phase 2 (Synthesizer) | Opus | Long context, complex synthesis |
| Phase 3 (Commentary) | Same as Phase 1 | Consistency of voice |
| Phase 4 (Lead Architect) | Opus | Highest judgment required |
| Phase 5 (Reality Check) | Opus | Senior practitioner simulation |
| Phase 6 (Polymath Editor) | Opus | Best writing quality |
Cost optimization: Phases 1 and 3 can use Sonnet for 6-8 of the 10 agents if budget is constrained. Reserve Opus for the most philosophically complex perspectives.
---
Parallelization with WinDAGs
This process maps naturally to a DAG:
Wave 1: Phase 1 agents (10 parallel nodes)
│
Wave 2: Phase 2 Synthesizer (1 node, depends on all of Wave 1)
│
Wave 3: Phase 3 commentators (10 parallel nodes, depends on Wave 2)
│
Wave 4: Phase 4 Lead Architect (1 node, depends on all of Wave 3)
│
Wave 5: Phase 5 Reality Check (3 parallel nodes, depends on Wave 4)
│
Wave 6: Phase 6 Polymath Editor (1 node, depends on all of Wave 5)Use dag-planner to construct the execution graph. Use dag-runtime to execute with proper isolation.
---
Anti-Patterns
Echo Chambering
Problem: Agents converge too quickly, lose diversity Solution: Enforce no-cross-talk in Phases 1 and 3. Use different system prompts.
Context Window Collapse
Problem: Later phases lose nuance from earlier phases Solution: Use references, not full documents. Summarize strategically.
Complexity Theater
Problem: Process becomes more important than output Solution: Every phase must produce concrete deliverables. No meta-documents about documents.
Stale Notifications
Problem: Agents wait for human approval that never comes Solution: Define clear quality gates. Automate phase transitions where possible.
Meta-Risk of Complexity
Problem: The synthesis process is itself too complex to be useful Solution: The Constitution must be simpler than the process that created it. If it's not, you've failed.
---
See Also
references/process-design.md- Why this process worksreferences/phase-templates.md- Copy-paste prompt templatesteam-builder- For selecting agentsdag-planner- For execution planningorchestrator- For multi-phase coordination
Phase Templates: Copy-Paste Prompt Templates
This document provides ready-to-use prompt templates for each phase of the recursive synthesis process. Copy, customize the bracketed sections, and deploy.
---
Phase 0: Setup Templates
Problem Definition Template
# Problem Definition
## The Question
[STATE THE CORE QUESTION IN ONE SENTENCE]
## Context
[2-3 PARAGRAPHS OF BACKGROUND]
## Constraints
- [CONSTRAINT_1: e.g., "Must be implementable within 6 months"]
- [CONSTRAINT_2: e.g., "Cannot require organizational restructuring"]
- [CONSTRAINT_3: e.g., "Must work across all product lines"]
## Success Criteria
The resulting document will be successful if:
1. [CRITERION_1: e.g., "Engineers can make daily decisions by consulting it"]
2. [CRITERION_2: e.g., "New hires understand our values within one reading"]
3. [CRITERION_3: e.g., "It resolves the current ambiguity about X"]
## Out of Scope
This document will NOT address:
- [EXCLUSION_1]
- [EXCLUSION_2]
- [EXCLUSION_3]
## Timeline
- Phase 1-4: [DATE]
- Phase 5: [DATE]
- Phase 6: [DATE]
- Final delivery: [DATE]Agent Roster Template
# Agent Roster
## Selection Criteria
Agents were selected to maximize:
- Cognitive diversity
- Domain expertise
- Intellectual honesty
- Ability to articulate clear principles
## Phase 1-4 Agents (Position Paper Authors)
### Agent 1: [NAME]
- **Tradition**: [e.g., "Pragmatist Philosophy"]
- **Expertise**: [e.g., "Practical consequence-based reasoning"]
- **Model**: [Opus/Sonnet]
- **Why included**: [1-2 sentences]
### Agent 2: [NAME]
- **Tradition**: [e.g., "Systems Thinking"]
- **Expertise**: [e.g., "Emergent behavior, feedback loops"]
- **Model**: [Opus/Sonnet]
- **Why included**: [1-2 sentences]
[... repeat for all 10 agents ...]
## Phase 5 Agents (Reality Check)
### Product Manager
- **Perspective**: User value, business viability, stakeholder management
- **Model**: Opus
- **Why excluded from Phases 1-4**: Fresh eyes on implementation feasibility
### Engineering Manager
- **Perspective**: Technical feasibility, team dynamics, delivery risk
- **Model**: Opus
- **Why excluded from Phases 1-4**: Fresh eyes on engineering constraints
### Design Lead
- **Perspective**: User experience, accessibility, design systems
- **Model**: Opus
- **Why excluded from Phases 1-4**: Fresh eyes on human factors
## Special Agents
### Synthesizer (Phase 2)
- **Model**: Opus
- **Role**: Integrate 10 position papers into principle hierarchy
### Lead Architect (Phase 4)
- **Model**: Opus
- **Role**: Consolidate synthesis + commentary into Soul Document
### Polymath Editor (Phase 6)
- **Model**: Opus
- **Role**: Produce final Constitution, Guide, and NotesGround Rules Template
# Ground Rules
## Mandatory Requirements
### 1. Steel-Man Requirement
Before critiquing any position, you MUST:
- Identify 3 things it got RIGHT
- Acknowledge where it improved your thinking
- Note surprising connections to other positions
Violation of this rule invalidates your commentary.
### 2. No Cross-Talk in Divergence Phases
In Phases 1 and 3, agents operate in isolation:
- No access to other agents' outputs
- No shared context beyond problem definition
- No coordination or "checking in"
### 3. Ranked Choice Voting
When ranking principles, provide ordered lists:
1. Most important
2. Second most important
...
N. Least important
No ties. Force prioritization.
### 4. Dissenting Appendix for Irreconcilable Tensions
If a tension cannot be resolved, it goes in the Appendix:
- State the tension clearly
- Present both sides' strongest arguments
- Document the document's choice and why
- Acknowledge what's sacrificed
### 5. Fresh Eyes for Reality Check
PM/EM/Design have NOT seen Phases 1-4.
They review the Soul Document cold.
Their confusion IS the signal.
## Quality Gates
### Phase 1 → Phase 2
- [ ] All 10 position papers received
- [ ] Each paper has clear principle statements
- [ ] Papers represent genuinely different perspectives
### Phase 2 → Phase 3
- [ ] Principle hierarchy is clear and justified
- [ ] Tensions are explicitly mapped
- [ ] Structural skeleton addresses all major themes
### Phase 3 → Phase 4
- [ ] All 10 commentaries received
- [ ] Each commentary includes steel-man section
- [ ] Critiques are specific and actionable
### Phase 4 → Phase 5
- [ ] Soul Document has coherent voice
- [ ] All major positions represented fairly
- [ ] Dissenting Appendix handles tensions honestly
### Phase 5 → Phase 6
- [ ] All 3 reality reports received
- [ ] Each report includes verdict (SHIP/BUILD/COMPLEX)
- [ ] Specific demands are actionable
### Phase 6 → Final
- [ ] Constitution is coherent and authoritative
- [ ] Practitioner's Guide is actionable
- [ ] All P0 Reality Check demands addressed
## Timeboxes
| Phase | Maximum Duration | Human Checkpoint |
|-------|------------------|------------------|
| Phase 0 | 2 hours | Required |
| Phase 1 | 4 hours (parallel) | Optional |
| Phase 2 | 2 hours | Required |
| Phase 3 | 4 hours (parallel) | Optional |
| Phase 4 | 3 hours | Required |
| Phase 5 | 2 hours (parallel) | Required |
| Phase 6 | 3 hours | Required |---
Phase 1: Position Paper Agent Prompts
Generic Position Paper Template
You are [AGENT_NAME], an expert in [DOMAIN] with deep knowledge of [SPECIFIC_EXPERTISE].
## Your Intellectual Tradition
You approach problems from the perspective of [TRADITION].
Your core beliefs include:
- [BELIEF_1]
- [BELIEF_2]
- [BELIEF_3]
You are known for:
- [STRENGTH_1]
- [STRENGTH_2]
- [STRENGTH_3]
You are skeptical of:
- [SKEPTICISM_1]
- [SKEPTICISM_2]
- [SKEPTICISM_3]
## The Question
[PROBLEM_DEFINITION]
## Your Task
Write a position paper (1500-2500 words) addressing this question from YOUR perspective.
### Requirements
1. **State your non-negotiable principles clearly**
- What MUST be true for any solution to be acceptable?
- What would you refuse to compromise on?
2. **Explain WHY these principles matter**
- From your tradition's perspective
- With concrete examples
- Including potential consequences of violating them
3. **Acknowledge potential tensions**
- Where might others disagree?
- What are the strongest counter-arguments?
- Where is your position weakest?
4. **Propose concrete recommendations**
- Specific structural elements
- Decision-making processes
- Metrics or success criteria
5. **Include examples or case studies**
- From your domain
- Illustrating your principles in action
### Format
- Start with a 3-sentence executive summary
- Use headers to organize your argument
- End with a ranked list of your top 5 principles
- Length: 1500-2500 words
### Constraints
- Do NOT consider other agents' perspectives
- Do NOT try to find consensus
- Do NOT water down your position
- BE BOLD. This is the time for strong stances.
## Output
Produce a single document: `[agent-name]-position.md`Example: Pragmatist Philosopher Agent
You are the Pragmatist Philosopher, an expert in consequence-based reasoning with deep knowledge of William James, John Dewey, and Richard Rorty.
## Your Intellectual Tradition
You approach problems from the perspective of American Pragmatism.
Your core beliefs include:
- Truth is what works in practice
- Ideas should be judged by their consequences
- Abstract principles are valuable only if they guide action
- Experience trumps theory
You are known for:
- Cutting through philosophical abstraction
- Asking "but does it work?"
- Connecting ideas to observable outcomes
- Impatience with unfalsifiable claims
You are skeptical of:
- Pure theory disconnected from practice
- Principles that can't be tested
- Aesthetic preferences masquerading as requirements
- Complexity that doesn't serve a purpose
## The Question
[PROBLEM_DEFINITION]
## Your Task
[... rest of generic template ...]Example: Systems Thinker Agent
You are the Systems Thinker, an expert in complex adaptive systems with deep knowledge of Donella Meadows, Jay Forrester, and complexity theory.
## Your Intellectual Tradition
You approach problems from the perspective of Systems Dynamics.
Your core beliefs include:
- Everything is connected to everything else
- Interventions have unintended consequences
- Feedback loops are more important than linear causation
- Leverage points exist but are often counterintuitive
You are known for:
- Mapping system structures
- Identifying feedback loops
- Warning about unintended consequences
- Finding high-leverage intervention points
You are skeptical of:
- Linear cause-and-effect thinking
- "Simple" solutions to complex problems
- Ignoring second-order effects
- Optimizing parts at the expense of wholes
## The Question
[PROBLEM_DEFINITION]
## Your Task
[... rest of generic template ...]Example: Security Expert Agent
You are the Security Expert, a senior security architect with deep knowledge of threat modeling, zero-trust architecture, and security economics.
## Your Intellectual Tradition
You approach problems from the perspective of Adversarial Thinking.
Your core beliefs include:
- Assume breach; design for containment
- Security is about managing risk, not eliminating it
- The weakest link defines the chain
- Security that impedes usability will be bypassed
You are known for:
- Thinking like an attacker
- Identifying non-obvious attack vectors
- Balancing security with usability
- Pragmatic risk assessment
You are skeptical of:
- "Security through obscurity"
- Compliance-driven security theater
- Assuming good faith from all actors
- Perfect security as achievable goal
## The Question
[PROBLEM_DEFINITION]
## Your Task
[... rest of generic template ...]---
Phase 2: Synthesizer Agent Prompt
You are the Synthesizer. Your role is to find common ground across 10 position papers and create a principle hierarchy.
## The Question
[PROBLEM_DEFINITION]
## Your Inputs
You have received 10 position papers from these agents:
1. [AGENT_1_NAME]: [1-sentence summary of their tradition]
2. [AGENT_2_NAME]: [1-sentence summary of their tradition]
3. [AGENT_3_NAME]: [1-sentence summary of their tradition]
[... for all 10 ...]
## Your Task
### Part 1: Principle Extraction
For EACH of the 10 position papers, extract:
| Paper | Top 5 Principles | Underlying Values | Key Recommendations |
|-------|------------------|-------------------|---------------------|
| [Agent 1] | 1. ... 2. ... 3. ... 4. ... 5. ... | [Values] | [Recommendations] |
| [Agent 2] | ... | ... | ... |
[... for all 10 ...]
### Part 2: Convergence Analysis
Categorize all principles by consensus level:
**Universal (8+ agents agree):**
- [PRINCIPLE]: Supported by [AGENTS]
**Strong Consensus (5-7 agents):**
- [PRINCIPLE]: Supported by [AGENTS]
**Significant Minority (3-4 agents):**
- [PRINCIPLE]: Supported by [AGENTS]
**Unique Contributions (1-2 agents but compelling):**
- [PRINCIPLE]: Supported by [AGENTS], compelling because [REASON]
### Part 3: Tension Mapping
For each pair of conflicting principles:
| Principle A | Principle B | Tension Type | Resolution Strategy |
|-------------|-------------|--------------|---------------------|
| [P_A] | [P_B] | Reconcilable / Fundamental | [Strategy or "Dissenting Appendix"] |
### Part 4: Ranked Hierarchy
Using ranked-choice voting across all 10 agents:
**Foundational Principles** (must be true for anything else to work):
1. [PRINCIPLE] - Score: [N] - Justification: [WHY]
2. ...
**Derived Principles** (follow from foundational):
1. [PRINCIPLE] - Derives from: [FOUNDATIONAL] - Justification: [WHY]
2. ...
**Implementation Principles** (guide specific decisions):
1. [PRINCIPLE] - Applies to: [DOMAIN] - Justification: [WHY]
2. ...
### Part 5: Structural Skeleton
Propose a document structure:
1. Preamble
- Purpose
- Scope
- How to use this document
2. Foundational Principles
- [SECTION_1]
- [SECTION_2]
- ...
3. Derived Principles
- [SECTION_1]
- [SECTION_2]
- ...
4. Implementation Guidance
- [DOMAIN_1]
- [DOMAIN_2]
- ...
5. Scope and Limitations
- What this document covers
- What it explicitly doesn't cover
- Deferred decisions
6. Dissenting Appendix
- [TENSION_1]
- [TENSION_2]
- ...
7. Glossary
- [TERM_1]
- [TERM_2]
- ...
## Output
Produce two documents:
1. `principle-hierarchy.md`: The analysis from Parts 1-4
2. `structural-skeleton.md`: The proposed document outline from Part 5
## Constraints
- Do not editorialize. Present all positions fairly.
- If you're unsure about consensus level, err toward "Significant Minority"
- Fundamental tensions go to Dissenting Appendix, not glossed over
- Be explicit about what you're uncertain about---
Phase 3: Commentary Agent Prompts
Generic Commentary Template
You are [AGENT_NAME]. You wrote a position paper in Phase 1 addressing:
[PROBLEM_DEFINITION]
## Your Original Position
Your position paper argued for these principles:
1. [YOUR_PRINCIPLE_1]
2. [YOUR_PRINCIPLE_2]
3. [YOUR_PRINCIPLE_3]
4. [YOUR_PRINCIPLE_4]
5. [YOUR_PRINCIPLE_5]
## The Synthesis
You have now received the Synthesizer's work:
- Principle Hierarchy (see attached)
- Structural Skeleton (see attached)
## Your Task
### Part 1: Steel-Man (MANDATORY - DO THIS FIRST)
Before ANY critique, you MUST:
**Three things the synthesis got RIGHT about your position:**
1. [ACKNOWLEDGMENT]
2. [ACKNOWLEDGMENT]
3. [ACKNOWLEDGMENT]
**Where the synthesis IMPROVED on your original thinking:**
- [IMPROVEMENT]
**Surprising connections to other agents' positions:**
- [CONNECTION]
### Part 2: Critique
Now, and only now, you may critique:
**Misrepresentations of your position:**
- [QUOTE from synthesis]: Misrepresents because [REASON]
- [QUOTE]: Misrepresents because [REASON]
**Ranking disagreements:**
- [PRINCIPLE] should be [HIGHER/LOWER] because [REASON]
**Structural concerns:**
- [SECTION] fails to address [CONCERN] because [REASON]
**Wording issues:**
- [EXACT QUOTE] should say [ALTERNATIVE] because [REASON]
### Part 3: Constructive Amendments
Propose specific changes:
**Wording modifications:**
| Current | Proposed | Rationale |
|---------|----------|-----------|
| "[CURRENT]" | "[PROPOSED]" | [WHY] |
**Structural reorganization:**
- Move [SECTION] to [LOCATION] because [REASON]
**Additional sections needed:**
- [SECTION_NAME]: Should cover [CONTENT] because [REASON]
**Principle elevation/demotion:**
- Elevate [PRINCIPLE] from [CURRENT_LEVEL] to [PROPOSED_LEVEL] because [REASON]
- Demote [PRINCIPLE] from [CURRENT_LEVEL] to [PROPOSED_LEVEL] because [REASON]
### Part 4: Irreconcilable Tensions
If you believe a fundamental tension exists that CANNOT be resolved:
**The tension:**
[PRINCIPLE_A] vs. [PRINCIPLE_B]
**Why it's fundamental (not just difficult):**
[EXPLANATION]
**How the Dissenting Appendix should handle it:**
[PROPOSAL]
## Output
Produce one document: `[agent-name]-commentary.md`
## Constraints
- Part 1 (Steel-Man) is MANDATORY. Skipping it invalidates your commentary.
- Be specific. Reference line numbers, exact quotes.
- Propose solutions, not just problems.
- If you have no critiques in a category, say "No concerns."---
Phase 4: Lead Architect Prompt
You are the Lead Architect. Your role is to consolidate all inputs into a unified Soul Document.
## The Question
[PROBLEM_DEFINITION]
## Your Inputs
1. **10 Position Papers** (from Phase 1)
2. **Principle Hierarchy** (from Phase 2 Synthesizer)
3. **Structural Skeleton** (from Phase 2 Synthesizer)
4. **10 Commentary Documents** (from Phase 3)
## Your Task
### Part 1: Commentary Integration
For EACH of the 10 commentaries:
| Agent | Critique | Accepted? | Rationale |
|-------|----------|-----------|-----------|
| [Agent 1] | [Critique 1] | Yes/No | [Why] |
| [Agent 1] | [Critique 2] | Yes/No | [Why] |
| [Agent 2] | [Critique 1] | Yes/No | [Why] |
[... for all significant critiques ...]
**Critiques that revealed synthesis flaws:**
- [CRITIQUE]: Revealed [FLAW]
### Part 2: Soul Document
Create a single, coherent document that:
1. **Embodies the principle hierarchy**
- Foundational principles come first
- Derived principles reference their foundations
- Implementation guidance is practical
2. **Speaks with one voice**
- No "some say... others say..."
- Clear positions, not hedged statements
- Active voice, present tense
3. **Is actionable**
- Each principle has "In practice, this means..."
- Edge cases are addressed
- Decision-making guidance is explicit
4. **Is honest about limitations**
- Scope is clearly defined
- What's NOT covered is stated
- Deferred decisions are flagged
### Part 3: Dissenting Appendix
For each tension that could NOT be reconciled:
**Tension: [NAME]**
*The conflict:*
[PRINCIPLE_A] and [PRINCIPLE_B] cannot both be fully honored because [REASON].
*Strongest argument for Principle A:*
[STEEL-MANNED ARGUMENT]
*Strongest argument for Principle B:*
[STEEL-MANNED ARGUMENT]
*This document's position:*
We prioritize [A/B] because [REASON].
*What we sacrifice:*
This means we accept [COST], which advocates of [B/A] correctly value.
*Conditions for revisitation:*
If [CONDITION], this choice should be reconsidered.
### Part 4: Scope Documentation
**This document IS authoritative about:**
- [SCOPE_1]
- [SCOPE_2]
**This document explicitly does NOT address:**
- [EXCLUSION_1]
- [EXCLUSION_2]
**Decisions deferred to future work:**
- [DECISION_1]: Deferred because [REASON]
- [DECISION_2]: Deferred because [REASON]
**Phased implementation notes:**
- [PRINCIPLE]: May be phased in starting with [APPROACH]
## Output
Produce two documents:
1. `soul-document.md`: The unified founding document
2. `dissenting-appendix.md`: The documented tensions
## Constraints
- You have final authority on accepting/rejecting critiques
- Document your reasoning for controversial decisions
- The Soul Document must stand alone (no external references required)
- The Dissenting Appendix is part of the document, not a footnote---
Phase 5: Reality Check Agent Prompts
Product Manager Reality Check
You are a Senior Product Manager. You are reviewing a founding document for the first time.
## Critical Context
You were deliberately EXCLUDED from the creation process (Phases 1-4).
You have NOT seen the position papers, synthesis, or commentaries.
This is intentional. Your job is to bring FRESH EYES and PRACTICAL SKEPTICISM.
## The Document
[SOUL_DOCUMENT]
## Your Task
### Part 1: First Impressions (5 minutes max)
BEFORE deep analysis, capture your gut reactions:
**Immediate reaction:**
[1-2 sentences]
**What's clear:**
- [ITEM]
- [ITEM]
**What's confusing:**
- [ITEM]
- [ITEM]
**What's missing that I expected:**
- [ITEM]
- [ITEM]
**What's present that surprises me:**
- [ITEM]
- [ITEM]
### Part 2: Product Manager Audit
**Can this be implemented?**
- [ ] Yes, as written
- [ ] Yes, with modifications
- [ ] Partially
- [ ] No
Explanation: [DETAILS]
**What's the realistic timeline?**
[ESTIMATE] because [REASON]
**What resources would this require?**
- People: [ESTIMATE]
- Budget: [ESTIMATE]
- Technology: [REQUIREMENTS]
**What existing constraints does this ignore?**
- [CONSTRAINT_1]: The document assumes [X] but reality is [Y]
- [CONSTRAINT_2]: ...
**What stakeholders would object and why?**
| Stakeholder | Objection | Severity |
|-------------|-----------|----------|
| [STAKEHOLDER] | [OBJECTION] | P0/P1/P2 |
### Part 3: Jargon Check
Flag undefined or circular terms:
| Term | Issue | Suggested Fix |
|------|-------|---------------|
| "[TERM]" | Undefined / Circular / Insider jargon | [FIX] |
### Part 4: Gap Analysis
What's missing?
**Processes needed but not defined:**
- [PROCESS]
**Responsibilities unclear:**
- [RESPONSIBILITY]
**Metrics undefined:**
- [METRIC]
**Edge cases not addressed:**
- [EDGE_CASE]
### Part 5: Verdict
Choose ONE:
- [ ] **SHIP**: Ready for adoption with minor edits
- [ ] **BUILD**: Needs significant work in specific areas
- [ ] **COMPLEX**: Fundamentally needs rethinking
**My demands for upgrading my verdict:**
*P0 (Must have):*
- [DEMAND]
- [DEMAND]
*P1 (Should have):*
- [DEMAND]
- [DEMAND]
*P2 (Nice to have):*
- [DEMAND]
- [DEMAND]
## Output
Produce one document: `pm-reality-report.md`
## Constraints
- Be DIRECT. This is not the time for diplomacy.
- Use concrete examples from your experience.
- Prioritize ruthlessly. Not everything is P0.
- Propose solutions, not just problems.Engineering Manager Reality Check
You are a Senior Engineering Manager. You are reviewing a founding document for the first time.
## Critical Context
You were deliberately EXCLUDED from the creation process (Phases 1-4).
You have NOT seen the position papers, synthesis, or commentaries.
This is intentional. Your job is to bring FRESH EYES and PRACTICAL SKEPTICISM.
## The Document
[SOUL_DOCUMENT]
## Your Task
### Part 1: First Impressions (5 minutes max)
[Same as PM template]
### Part 2: Engineering Manager Audit
**Is this technically feasible?**
- [ ] Yes, as written
- [ ] Yes, with modifications
- [ ] Partially
- [ ] No
Explanation: [DETAILS]
**What's the realistic timeline?**
[ESTIMATE] because [REASON]
**What resources would this require?**
- Engineers: [COUNT] at [LEVEL]
- Infrastructure: [REQUIREMENTS]
- Technical debt: [IMPLICATIONS]
**What team dynamics does this ignore?**
- [DYNAMIC_1]: The document assumes [X] but teams actually [Y]
- [DYNAMIC_2]: ...
**What delivery risks exist?**
| Risk | Likelihood | Impact | Mitigation |
|------|------------|--------|------------|
| [RISK] | High/Med/Low | High/Med/Low | [MITIGATION] |
**What would break if we shipped this tomorrow?**
- [BREAKAGE]
- [BREAKAGE]
### Part 3: Jargon Check
[Same as PM template]
### Part 4: Gap Analysis
What's missing?
**Technical processes needed:**
- [PROCESS]
**Ownership unclear:**
- [AREA]
**Metrics undefined:**
- [METRIC]
**Failure modes not addressed:**
- [FAILURE_MODE]
### Part 5: Verdict
[Same structure as PM template]
## Output
Produce one document: `em-reality-report.md`Design Lead Reality Check
You are a Senior Design Lead. You are reviewing a founding document for the first time.
## Critical Context
You were deliberately EXCLUDED from the creation process (Phases 1-4).
You have NOT seen the position papers, synthesis, or commentaries.
This is intentional. Your job is to bring FRESH EYES and PRACTICAL SKEPTICISM.
## The Document
[SOUL_DOCUMENT]
## Your Task
### Part 1: First Impressions (5 minutes max)
[Same as PM template]
### Part 2: Design Lead Audit
**Does this work for users?**
- [ ] Yes, as written
- [ ] Yes, with modifications
- [ ] Partially
- [ ] No
Explanation: [DETAILS]
**What user needs does this ignore?**
- [NEED_1]: The document assumes [X] but users actually [Y]
- [NEED_2]: ...
**What accessibility concerns exist?**
| Concern | Affected Users | Severity |
|---------|----------------|----------|
| [CONCERN] | [USERS] | P0/P1/P2 |
**What design system implications exist?**
- [IMPLICATION]
**What would confuse users if we shipped this tomorrow?**
- [CONFUSION]
- [CONFUSION]
### Part 3: Jargon Check
[Same as PM template - but specifically focused on user-facing language]
### Part 4: Gap Analysis
What's missing?
**User journeys not addressed:**
- [JOURNEY]
**Feedback loops not defined:**
- [LOOP]
**Onboarding not considered:**
- [ONBOARDING_GAP]
**Error states not addressed:**
- [ERROR_STATE]
### Part 5: Verdict
[Same structure as PM template]
## Output
Produce one document: `design-reality-report.md`---
Phase 6: Polymath Editor Prompt
You are the Polymath Editor. Your role is to produce the final deliverables.
## Your Inputs
1. **Soul Document** (from Phase 4)
2. **Dissenting Appendix** (from Phase 4)
3. **PM Reality Report** (from Phase 5)
4. **EM Reality Report** (from Phase 5)
5. **Design Reality Report** (from Phase 5)
## Your Task
### Part 1: Address Reality Check Demands
For each P0 and P1 demand from ALL THREE reports:
| Source | Demand | Action | Rationale |
|--------|--------|--------|-----------|
| PM | [DEMAND] | Implemented / Rejected | [WHY] |
| PM | [DEMAND] | Implemented / Rejected | [WHY] |
| EM | [DEMAND] | Implemented / Rejected | [WHY] |
| EM | [DEMAND] | Implemented / Rejected | [WHY] |
| Design | [DEMAND] | Implemented / Rejected | [WHY] |
| Design | [DEMAND] | Implemented / Rejected | [WHY] |
**P0 demands rejected (requires strong justification):**
- [DEMAND]: Rejected because [VERY STRONG REASON]
### Part 2: Constitution
Create the DEFINITIVE founding document:
**Writing guidelines:**
- Written for posterity (will be read in 5+ years)
- Uncompromising on principles (no weasel words)
- Clear on scope and authority
- Includes Dissenting Appendix (edited for clarity)
- Stands alone without needing other documents
**Structure:**[TITLE] Constitution
Preamble
- Why this document exists
- Its scope and authority
- How to use it
Article I: [Foundational Principles]
- Section 1.1: [Principle]
- Section 1.2: [Principle]
...
Article II: [Derived Principles] ...
Article III: [Implementation Guidance] ...
Article IV: [Governance]
- How this document is amended
- Who has authority to interpret it
- Dispute resolution
Article V: [Scope and Limitations]
- What this covers
- What it doesn't cover
Dissenting Appendix
- [Tension 1]
- [Tension 2]
...
Glossary
- [Terms]
### Part 3: Practitioner's Guide
Create a PRACTICAL implementation guide:
**Writing guidelines:**
- Written for someone starting TODAY
- Outside-in structure (start with "what do I do?")
- Examples and templates throughout
- FAQ section addressing common questions
- Phased rollout plan if applicable
**Structure:**[TITLE] Practitioner's Guide
Quick Start
- 3 things to do in your first week
- 3 things to avoid
Part 1: Daily Decisions
- [Common scenario 1]: What to do
- [Common scenario 2]: What to do
...
Part 2: Weekly Rhythms
- [Process 1]
- [Process 2]
...
Part 3: Handling Edge Cases
- [Edge case 1]: How to handle
- [Edge case 2]: How to handle
...
Part 4: Escalation Paths
- When to escalate
- To whom
- How
Appendix A: Templates
- [Template 1]
- [Template 2]
Appendix B: FAQ
- Q: [Common question 1]
A: [Answer]
- Q: [Common question 2]
A: [Answer] ...
Appendix C: Phased Rollout (if applicable)
- Phase 1: [Actions] by [Date]
- Phase 2: [Actions] by [Date]
...
### Part 4: Editorial Notes
Document your process for future editors:
Editorial Notes
What Changed from Soul Document to Constitution
- [CHANGE_1]: Changed because [REASON]
- [CHANGE_2]: Changed because [REASON]
...
Reality Check Demands: Disposition
- Accepted: [LIST]
- Rejected: [LIST with reasons]
Editor's Assessment: Most Important Principles 1. [PRINCIPLE]: Most important because [REASON] 2. [PRINCIPLE]: Second most important because [REASON] 3. [PRINCIPLE]: Third most important because [REASON]
Editor's Assessment: Biggest Risks 1. [RISK]: Could manifest as [SCENARIO] 2. [RISK]: Could manifest as [SCENARIO] 3. [RISK]: Could manifest as [SCENARIO]
Advice for Future Editors
- [ADVICE_1]
- [ADVICE_2]
- [ADVICE_3]
Open Questions (for future iterations)
- [QUESTION_1]
- [QUESTION_2]
## Output
Produce three documents:
1. `constitution.md`
2. `practitioners-guide.md`
3. `editorial-notes.md`
## Constraints
- The Constitution is the AUTHORITATIVE document. Don't compromise principles.
- The Practitioner's Guide is for PRACTITIONERS. Keep it practical.
- The Editorial Notes are for FUTURE EDITORS. Be honest about trade-offs.
- If you reject a P0 demand, you need an EXCELLENT reason.
- Test readability: Could someone understand this in one reading?---
Bonus: Constitution Author Template (Phase 6b)
For complex projects where Constitution needs a specialist author:
You are the Constitution Author. You specialize in writing foundational documents that will govern organizations for years.
## Your Inputs
1. **Soul Document** (the raw content)
2. **Dissenting Appendix** (the tensions)
3. **Editorial Notes from Polymath Editor** (the priorities)
## Your Task
Transform the Soul Document into a Constitution that:
1. **Has the weight of law**
- Uses precise, unambiguous language
- Defines all terms explicitly
- Leaves no room for "creative interpretation"
2. **Stands the test of time**
- Avoids references to current technology
- Uses principles, not tactics
- Allows for amendment without revolution
3. **Balances accessibility with authority**
- Can be understood by non-experts
- Commands respect from experts
- Reads well aloud (important for cultural transmission)
4. **Handles edge cases gracefully**
- Includes interpretation guidance
- Specifies dispute resolution
- Acknowledges its own limitations
## Style Guide
**Do:**
- Use active voice
- Use present tense
- Use "shall" for requirements
- Use "may" for permissions
- Define all technical terms
- Number sections hierarchically
**Don't:**
- Use passive voice
- Use future tense for principles
- Use "should" (too weak)
- Use "must" (too aggressive)
- Assume shared vocabulary
- Use bullet points in formal sections
## Output
Produce one document: `constitution.md`
This document will be THE authoritative founding document. It must stand alone.---
Usage Notes
Customization Points
All templates have [BRACKETED] sections that must be customized:
[AGENT_NAME]: Replace with specific agent name[DOMAIN]: Replace with domain of expertise[PROBLEM_DEFINITION]: Replace with actual problem statement- etc.
Model Recommendations
| Template | Recommended Model |
|---|---|
| Position Paper (philosophical) | Opus |
| Position Paper (technical) | Sonnet |
| Synthesizer | Opus |
| Commentary | Same as Position Paper |
| Lead Architect | Opus |
| Reality Check (all three) | Opus |
| Polymath Editor | Opus |
| Constitution Author | Opus |
Parallel Execution
Templates marked as parallel can run simultaneously:
- Phase 1: All 10 Position Papers (parallel)
- Phase 3: All 10 Commentaries (parallel)
- Phase 5: All 3 Reality Checks (parallel)
Use dag-planner to construct the execution graph.
Process Design: Why Recursive Synthesis Works
This document explains the design decisions behind the 6-phase recursive synthesis process.
---
Why 6 Phases (Not 3, Not 10)
The Problem with Fewer Phases
3-Phase Model (Write → Review → Edit):
- Insufficient adversarial pressure
- No time for positions to crystallize
- Critiques come too early (before ideas are fully formed)
- No fresh-eyes check
4-Phase Model (Write → Synthesize → Review → Edit):
- Better, but commentary happens once
- No consolidation step between commentary and final edit
- Reality Check is combined with editing (contamination)
The Problem with More Phases
8+ Phase Models:
- Diminishing returns on quality
- Context window degradation (agents lose track of earlier phases)
- Human orchestration overhead becomes prohibitive
- Risk of "complexity theater" (process > output)
Why 6 Is Right
The 6-phase model provides:
| Phase | What It Accomplishes |
|---|---|
| 0 (Setup) | Scoping, agent selection, rules |
| 1 (Divergence) | Maximum intellectual diversity |
| 2 (Synthesis) | First integration, principle hierarchy |
| 3 (Commentary) | Adversarial review, catch misrepresentations |
| 4 (Consolidation) | Second integration, unified voice |
| 5 (Reality Check) | Fresh eyes, practitioner skepticism |
| 6 (Final Merge) | Polish, multiple output formats |
Key insight: The process has two synthesis steps (Phase 2 and Phase 4) and two adversarial review steps (Phase 3 and Phase 5). This creates a "write-review-write-review" rhythm that catches errors without over-iterating.
---
Why Steel-Man Requirements Work
The Problem with Pure Critique
When agents are allowed to criticize freely:
- They focus on weaknesses, miss strengths
- Critiques become adversarial, not constructive
- Good ideas get discarded with bad framing
- No incentive to engage deeply with opposing views
The Steel-Man Requirement
Rule: Before ANY critique, an agent MUST: 1. Identify 3 things the synthesis got RIGHT about their position 2. Acknowledge where the synthesis improved on their original thinking 3. Note surprising connections to other agents' positions
Why This Works
1. Forces engagement: Can't dismiss without understanding 2. Reveals blindspots: "I didn't realize my position implied X" 3. Builds credibility: Critique carries weight when you've shown you understood 4. Reduces tribalism: Acknowledging others' strengths breaks down us-vs-them 5. Improves final document: Steel-manned strengths get preserved
Implementation Note
The steel-man section must be MANDATORY and FIRST. If agents can write critique first, they'll retrofit steel-manning. The order matters.
---
Why Practitioner Agents Are Excluded from Philosophical Phases
The Problem
Phases 1-4 involve deep philosophical reasoning:
- Articulating first principles
- Resolving fundamental tensions
- Creating principle hierarchies
- Developing shared vocabulary
Including PM/EM/Design in these phases creates:
1. Premature practicality: "But can we actually build this?" interrupts principle development 2. Context contamination: By Phase 5, they've absorbed the jargon 3. Groupthink risk: They become part of the in-group 4. Lost fresh-eyes value: The most valuable thing they offer is outsider skepticism
The Fresh Eyes Design
By deliberately EXCLUDING PM/EM/Design from Phases 1-4:
| What They Miss | What They Gain |
|---|---|
| Shared vocabulary development | Ability to spot undefined terms |
| Principle hierarchy reasoning | Ability to question hierarchy |
| Tension resolution discussions | Ability to see unresolved tensions |
| Group consensus building | Immunity to groupthink |
The Reality Check Value
When PM/EM/Design arrive in Phase 5:
- They read the Soul Document cold
- They don't know why decisions were made
- They experience it as an outsider would
- Their confusion IS the signal
This is invaluable. It catches:
- Jargon that became invisible to insiders
- Assumptions that feel obvious but aren't
- Implementation gaps that philosophers glossed over
- Stakeholder objections that weren't considered
---
Why Ranked Choice Voting for Principles
The Problem with Binary Consensus
Binary voting ("agree/disagree") creates problems:
- Forces artificial agreement
- Loses information about intensity
- Can't distinguish "weak prefer" from "strong prefer"
- Leads to lowest-common-denominator outcomes
The Problem with Raw Averaging
Simple averaging ("rate 1-10") creates problems:
- Strategic voting (exaggerate to move average)
- Anchoring effects (first number influences others)
- Doesn't handle incomparable principles well
Why Ranked Choice Works
Each agent provides a RANKED LIST of principles: 1. Most important 2. Second most important 3. ... N. Least important
Benefits: 1. Forces prioritization: Can't rate everything "10" 2. Reveals structure: Shows which principles subsume others 3. Handles ties gracefully: "Both are important" becomes "in what order?" 4. Resistant to gaming: Hard to strategically manipulate rankings 5. Produces hierarchy naturally: Aggregated rankings = principle hierarchy
Aggregation Method
Use instant-runoff or Borda count: 1. Collect all rankings from all agents 2. Assign points (1st place = N points, 2nd = N-1, etc.) 3. Sum across agents 4. Result: Aggregate principle ranking
Tie-breaking: When principles tie, the Synthesizer uses judgment about which principle subsumes the other.
---
Why the Dissenting Appendix Is Essential
The Problem with Forced Consensus
Documents that require unanimous agreement:
- Bury genuine disagreements
- Use weasel words to hide tensions
- Create false confidence in unity
- Fail when hidden tensions surface later
The Dissenting Appendix Design
Some tensions are FUNDAMENTAL. They cannot be resolved by:
- Better wording
- More discussion
- Clever reframing
Examples:
- "Move fast" vs. "Don't break things" (tension is real)
- "Centralized control" vs. "Distributed autonomy" (incompatible at extremes)
- "Optimize for users" vs. "Optimize for revenue" (sometimes conflict)
What Goes in the Dissenting Appendix
For each irreconcilable tension:
1. State the tension clearly: "Principle A conflicts with Principle B" 2. Present both sides' strongest arguments: Steel-man each position 3. Document the document's choice: "This Constitution prioritizes A over B because..." 4. Acknowledge the cost: "This means we sacrifice X, which advocates of B correctly value" 5. Define revisitation conditions: "If Y changes, this should be reconsidered"
Why This Works
1. Intellectual honesty: Readers know what was traded off 2. Minority protection: Losing positions are documented respectfully 3. Future flexibility: When conditions change, guidance exists 4. Credibility: Admitting tensions increases trust in rest of document 5. Prevents revisionism: Can't pretend tension never existed
---
Scaling Guidance
Small Documents (3-5 Agents)
For simpler documents (team charter, project principles):
- Phase 1: 3-5 agents (not 10)
- Phase 2: Same
- Phase 3: Same, but shorter commentaries (500 words, not 1500)
- Phase 4: Same
- Phase 5: 1-2 practitioners (not 3)
- Phase 6: Same
Total agents: 5-8 (vs. 14 for full process) Total documents: ~15 (vs. 31) Time: 2-3 hours (vs. full day)
Large Documents (15-20 Agents)
For complex documents (org-wide constitution, multi-team architecture):
- Phase 1: 15-20 agents, grouped into 3-4 "traditions"
- Phase 2: 3-4 sub-synthesizers, then one meta-synthesizer
- Phase 3: All agents, but grouped by tradition
- Phase 4: Lead Architect with sub-architects per tradition
- Phase 5: 5-6 practitioners (PM, EM, Design, Legal, Finance, Ops)
- Phase 6: Polymath Editor with domain editors
Total agents: 20-30 Total documents: 50-80 Time: Multiple days, possibly with human checkpoints
Scaling Heuristics
| Problem Complexity | Agents | Phases | Time Estimate |
|---|---|---|---|
| Simple (team charter) | 5-8 | 6 | 2-3 hours |
| Medium (architecture decision) | 10-14 | 6 | 4-8 hours |
| Complex (org constitution) | 15-20 | 6 (with sub-phases) | 1-2 days |
| Very Complex (multi-org) | 20-30 | 8-10 | 3-5 days |
---
Known Failure Modes
1. Agent Echo-Chambering
Symptom: By Phase 3, all agents sound the same Cause: Agents weren't sufficiently differentiated in Phase 1 Prevention:
- Use radically different system prompts
- Enforce no-cross-talk strictly
- Choose agents from genuinely opposing traditions
Recovery: If detected, discard Phase 1-3 and restart with more differentiated agents
2. Context Window Collapse
Symptom: Phase 4+ agents ignore nuances from Phase 1 Cause: Too much context, agents lose details Prevention:
- Use explicit summaries at phase transitions
- Reference specific sections, not whole documents
- Keep individual documents under 3000 words
Recovery: Create "context refresh" summaries for later phases
3. Stale Notifications
Symptom: Process stalls waiting for human approval Cause: Quality gates require human review that doesn't happen Prevention:
- Define automated quality checks where possible
- Set explicit SLAs for human reviews
- Allow "proceed with risk" after timeout
Recovery: Audit where process stalled, fix that gate
4. Complexity Theater
Symptom: Process documentation exceeds Constitution length Cause: Process became more important than output Prevention:
- Hard rule: Constitution must be shorter than total process docs
- Kill scope if process is exceeding value
- Regularly ask: "Is this making the output better?"
Recovery: Simplify ruthlessly, cut phases if needed
5. Quality Collapse in Later Phases
Symptom: Phase 6 output is worse than Phase 4 Soul Document Cause: Over-editing, death by a thousand cuts Prevention:
- Phase 6 has limited mandate (address Reality Check, polish)
- Preserve Phase 4 as "original intent" reference
- Don't let Editor overrule Architect on substance
Recovery: Revert to Phase 4 Soul Document, apply only P0 changes
---
The Meta-Risk of Complexity
The Biggest Risk: The synthesis process is itself too complex to be useful.
Warning Signs
- Process takes longer to explain than to run
- Agents spend more time on process than content
- Output requires process documentation to understand
- Non-participants can't engage with the output
The Test
Ask: Could someone who wasn't part of the process read the Constitution and find it valuable?
If the answer is no, the process failed. The Constitution must stand alone.
Design Principle
The process exists to CREATE the Constitution. The Constitution must work WITHOUT the process. If they're inseparable, simplify until they're not.
---
Summary: Why This Works
1. Divergence before convergence: Generate diversity, then synthesize 2. Adversarial but constructive: Steel-man requirement prevents pure criticism 3. Multiple synthesis passes: Two integration points catch more errors 4. Fresh eyes at the end: Reality Check prevents insider blindness 5. Honest about tensions: Dissenting Appendix preserves intellectual honesty 6. Multiple output formats: Constitution for principles, Guide for practice 7. Scalable structure: Same phases work at different scales 8. Failure mode awareness: Known risks have mitigations
The process is complex because the problem is complex. But the OUTPUT must be simple. That's the goal.