dialectic-review
Skill67 starsChanged 4 months agoMITView on GitHub
Dialectic process for reviewing, brainstorming, comparing tradeoffs, or stress-testing plans. Configurable modes, agent counts, and expert lenses.
In this repository24 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- autoresearchSkill
- brainstormSkill
- bug-huntSkill
- check-resolvableSkill
- compSkill
- debugSkill
- distillSkill
- finalizeSkill
- implementSkill
- learnSkill
- plan-taskSkill
- premortemSkill
- red-teamSkill
- researchSkill
- retroSkill
- reviewSkill
- rsbSkill
- sessionsSkill
- shipSkill
- socratesSkill
- tradeoffSkill
- verifySkill
- wrapupSkill
The file
We split this skill into the rules it gives an agent
9 rules. About 0 are common, 7 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈7
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 59
If it involves code, list the relevant file paths.
- Very specific: line 60
If --lens is set, note the expert perspective — injected into every agent prompt.
- Distinctive: line 61
Read the project's CLAUDE.md and MEMORY.md for project context.
- Distinctive: line 71
Do NOT pass conversation history, your own opinions, or framing that could anchor the agents.
- Distinctive: line 87
Follow the three-phase process defined in that file.
- Distinctive: line 93
If multiple agents in the same phase, merge outputs — deduplicate overlapping points, keep the strongest version, note disagreements.
- Distinctive: line 94
After the final phase, present a concise summary.
- Very specific: line 95
If --audit is set, run the Hostile Auditor phase (see below) AFTER the normal summary.
- Distinctive: line 99
After the three-phase process completes its synthesis, launch a single Opus agent that attacks the synthesis itself.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Dialectic Review
A multi-agent dialectic with four modes. The primitive is always the same: structured opposition with impartial synthesis. Modes set the role framing, default agent counts, and number of rounds.
Modes
| Mode | Alias | Phase 1 | Phase 2 | Phase 3 | Default Agents | Rounds |
review | /red-team | Critics attack | Defenders rebut | Referees judge | 3-1-1 | 1 |
ideate | /brainstorm | Generators create | Challengers prune | Synthesizers rank | 5-2-3 | 1 (future: multi-round) |
tradeoff | /tradeoff | Advocates (1 per option) | Counter-advocates challenge | Referees rank | N-N-1 | 1 |
premortem | /premortem | Pessimists explain failure | Optimists argue success | Risk assessors weigh | 3-2-1 | 1 |
council | — | Advisors (5 distinct personas) | Anonymous peer review | Chairman synthesizes | 5-5-1 | 1 |
Note: /red-team enables --audit by default (adds Phase 4 hostile auditor). Pass --no-audit to run plain review mode.
Argument Parsing
Parse $ARGUMENTS for these flags (order-independent, all optional):
| Flag | Effect | Default |
--mode <mode> | Set the mode | review |
--ideate | Shorthand for --mode ideate | — |
--tradeoff | Shorthand for --mode tradeoff | — |
--premortem | Shorthand for --mode premortem | — |
--council | Shorthand for --mode council (5 personas + anonymous peer review) | — |
--agents X-Y-Z | Agent counts per phase | Mode-dependent (see table) |
--lens <expert> | Expert perspective (e.g., security, performance, UX) | none (generalist) |
--test-first | Phase 2 writes failing tests instead of prose (review mode only) | off |
--audit | Add Phase 4: hostile auditor attacks the synthesis itself | off (but on by default when invoked via /red-team) |
--no-audit | Disable the hostile auditor phase (use to opt out when invoked via /red-team) | — |
Recommended --lens values: security, performance, UX, data-integrity, cost, temporal (timeline/sequencing risks), user-advocate (end-user empathy), scalability
Everything not matching a flag is the focus area.
Examples:
/dialectic-review the migration plan # Review mode, 3-1-1
/dialectic-review --lens security fetch_articles.py # Review with security lens
/dialectic-review --ideate features for the analytics database # Ideation, 5-2-3
/dialectic-review --tradeoff "GMM vs K-Means for user clustering"
/dialectic-review --premortem "the overnight autonomous runner"
/dialectic-review --agents 5-3-2 --lens performance the BPM queryContext Gathering
- Identify the subject: code files, an argument, a plan, options to compare, or a domain for ideation.
- If it involves code, list the relevant file paths.
- If
--lensis set, note the expert perspective — injected into every agent prompt. - Read the project's CLAUDE.md and MEMORY.md for project context.
Context Isolation Rule
CRITICAL: Each agent receives ONLY:
- The subject description and relevant file paths
- Project CLAUDE.md and MEMORY.md (for project context)
- Output from prior phases (as specified per mode)
- The expert lens (if set)
Do NOT pass conversation history, your own opinions, or framing that could anchor the agents. Neutral handoffs only.
Mode Dispatch
Based on the parsed mode, read the corresponding prompt file in this directory:
| Mode | Prompt file |
review | review-prompts.md |
ideate | ideation-prompts.md |
tradeoff | tradeoff-prompts.md |
premortem | premortem-prompts.md |
council | council-prompts.md |
Follow the three-phase process defined in that file. Each file defines the role names, prompt templates, merge strategy, and summary format.
Shared Rules (all modes)
- Launch each phase's agents in parallel using the Agent tool.
- Default model: the strongest available model (e.g. Opus) for ALL roles (advocates, counter-advocates, referees, synthesizers, pessimists, optimists, risk-assessors, hostile auditor). Judgment is load-bearing on every role in this skill, not just synthesis. Override only if the user explicitly requests a cheaper model for a specific run.
- If multiple agents in the same phase, merge outputs — deduplicate overlapping points, keep the strongest version, note disagreements.
- After the final phase, present a concise summary. Do NOT ask the user if they want to proceed -- just present findings.
- If
--auditis set, run the Hostile Auditor phase (see below) AFTER the normal summary.
Phase 4: Hostile Auditor (when --audit is set)
After the three-phase process completes its synthesis, launch a single Opus agent that attacks the synthesis itself. This closes the gap where the review process never stress-tests its own conclusion.
You are a HOSTILE AUDITOR. You will receive a synthesis/conclusion produced by a multi-agent review process. Your job is to ATTACK IT.
CONTEXT ISOLATION: You receive ONLY the information below. You were not part of the prior process and owe it no deference.
THE SYNTHESIS TO ATTACK:
[Full output from Phase 3]
ORIGINAL SUBJECT:
[Subject description and file paths]
YOUR TASK:
1. What did the synthesis get WRONG? Where did it paper over disagreements with false compromise?
2. What did the entire process MISS? What questions were never asked? What assumptions went unchallenged?
3. Where is the synthesis WEAKEST? If you had to bet against one conclusion, which one and why?
4. What's the STRONGEST argument against the synthesis's main recommendation?
Be maximally adversarial. The synthesis has already been through three phases of review — easy criticisms were already caught. Your job is to find what survived.
Format:
- ERRORS: Things the synthesis got wrong
- BLIND SPOTS: Questions never asked
- WEAKEST POINT: Where to bet against
- COUNTER-ARGUMENT: The strongest case against the main recommendation
- VERDICT: Is this synthesis trustworthy enough to act on? (YES WITH CAVEATS / NO — REDO / YES)Present the auditor's findings after the main summary, clearly labeled as "Hostile Audit." If the auditor's verdict is "NO -- REDO," flag this prominently.
Sources
- KyleAMathews/hegelian-dialectic-skill -- hostile auditor concept (Phase 6 validation)
- Riley-Coyote/polyclaude -- temporal and user-advocate perspective lenses, and council-mode inspiration (5-persona anonymous peer review)
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

