agentleFS
griffinhillygriffinhilly/claude-code-synthesis/skills/dialectic-review/SKILL.md

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.

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
  1. Distinctive:

    If it involves code, list the relevant file paths.

    line 59
  2. Very specific:

    If --lens is set, note the expert perspective — injected into every agent prompt.

    line 60
  3. Distinctive:

    Read the project's CLAUDE.md and MEMORY.md for project context.

    line 61
  4. Distinctive:

    Do NOT pass conversation history, your own opinions, or framing that could anchor the agents.

    line 71
  5. Distinctive:

    Follow the three-phase process defined in that file.

    line 87
  6. Distinctive:

    If multiple agents in the same phase, merge outputs — deduplicate overlapping points, keep the strongest version, note disagreements.

    line 93
  7. Distinctive:

    After the final phase, present a concise summary.

    line 94
  8. Very specific:

    If --audit is set, run the Hostile Auditor phase (see below) AFTER the normal summary.

    line 95
  9. Distinctive:

    After the three-phase process completes its synthesis, launch a single Opus agent that attacks the synthesis itself.

    line 99

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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

ModeAliasPhase 1Phase 2Phase 3Default AgentsRounds
review/red-teamCritics attackDefenders rebutReferees judge3-1-11
ideate/brainstormGenerators createChallengers pruneSynthesizers rank5-2-31 (future: multi-round)
tradeoff/tradeoffAdvocates (1 per option)Counter-advocates challengeReferees rankN-N-11
premortem/premortemPessimists explain failureOptimists argue successRisk assessors weigh3-2-11
council—Advisors (5 distinct personas)Anonymous peer reviewChairman synthesizes5-5-11

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):

FlagEffectDefault
--mode <mode>Set the modereview
--ideateShorthand for --mode ideate—
--tradeoffShorthand for --mode tradeoff—
--premortemShorthand for --mode premortem—
--councilShorthand for --mode council (5 personas + anonymous peer review)—
--agents X-Y-ZAgent counts per phaseMode-dependent (see table)
--lens <expert>Expert perspective (e.g., security, performance, UX)none (generalist)
--test-firstPhase 2 writes failing tests instead of prose (review mode only)off
--auditAdd Phase 4: hostile auditor attacks the synthesis itselfoff (but on by default when invoked via /red-team)
--no-auditDisable 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 query

Context Gathering

  1. Identify the subject: code files, an argument, a plan, options to compare, or a domain for ideation.
  2. If it involves code, list the relevant file paths.
  3. If --lens is set, note the expert perspective — injected into every agent prompt.
  4. 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:

ModePrompt file
reviewreview-prompts.md
ideateideation-prompts.md
tradeofftradeoff-prompts.md
premortempremortem-prompts.md
councilcouncil-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 --audit is 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

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.