doubt-driven-development

Run a bounded 5-step adversarial review of software development decisions.

Updated Jun 1, 2026
One-click install
npx skills add https://github.com/j-cogburn/d3 --skill doubt-driven-development-j-cogburn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doubt-driven-development
Source: https://github.com/j-cogburn/d3/tree/main/tests/project-t01/.d3/skills/doubt-driven-development
Command: npx skills add https://github.com/j-cogburn/d3 --skill doubt-driven-development-j-cogburn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Long AI development sessions accumulate context that turns unstated assumptions into perceived facts, leading to hidden errors in non-trivial decisions that are extremely costly to debug after deployment, especially in high-stakes or unfamiliar codebases.

Core Features & Use Cases

  • Structured 5-Step Doubt Cycle: A repeatable workflow (CLAIM, EXTRACT, DOUBT, RECONCILE, STOP) that standardizes adversarial review of non-trivial decisions.
  • Fresh-Context Adversarial Review: Spawns an unbiased reviewer focused on finding flaws, not validating existing assumptions, to catch edge cases, unstated constraints, and hidden coupling.
  • Cross-Model Escalation: Optional second opinion from a different AI model to catch blind spots shared between the original author and single-model reviewer, with explicit user authorization for every invocation.
  • Bounded Loop Guardrails: Prevents infinite review cycles with a 3-cycle limit and clear stop conditions, while classifying findings to prioritize actionable fixes over noise. Use this skill when making architectural decisions, committing non-trivial code, working in unfamiliar code, or operating in high-stakes scenarios (production deployments, security-sensitive logic, irreversible operations) where correctness is more important than speed.

Quick Start

Use the doubt-driven-development skill to run an adversarial review of your proposed authentication flow changes before merging the pull request.

Frequently Asked Questions about doubt-driven-development

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prevent hidden errors in high-stakes production code changes?

Adversarial review prevents hidden errors in high-stakes production code by subjecting non-trivial decisions to a fresh-context analysis. This structured 5-step doubt cycle extracts claims, doubts them without validation bias, and reconciles actionable fixes before deployment.

What is a fresh-context adversarial review in software development?

Fresh-context adversarial review in software development spawns an unbiased reviewer focused on finding flaws rather than validating existing assumptions. It catches edge cases, unstated constraints, and hidden coupling in non-trivial code decisions.

Can I use cross-model review to catch blind spots in architectural decisions?

Cross-model review can catch blind spots in architectural decisions by optionally requesting a second opinion from a different AI model. This identifies shared blind spots between the original author and single-model reviewer, requiring explicit user authorization for every invocation.

How do I run an adversarial code review without creating infinite cycles?

To run an adversarial code review without infinite cycles, use a bounded 5-step doubt cycle with a 3-cycle limit and clear stop conditions. This classifies reviewer findings to prioritize actionable fixes over noise, ensuring the review process terminates efficiently.

When should I use adversarial review for unfamiliar codebases?

Adversarial review for unfamiliar codebases should be used when correctness outweighs speed, especially in security-sensitive logic, architectural decisions, or irreversible operations. It prevents accumulated context from turning unstated assumptions into perceived facts.

Does adversarial review work for security-sensitive logic and irreversible operations?

Adversarial review works for security-sensitive logic and irreversible operations by applying a structured doubt cycle that extracts claims and doubts them without validation bias. This enforces finding hidden errors and unstated constraints before deployment.