doubt-driven-development

Subject non-trivial development decisions to adversarial fresh-context review.

Updated Nov 24, 2025
One-click install
npx skills add https://github.com/ByronWilliamsCPA/.claude --skill doubt-driven-development-byronwilliamscpa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doubt-driven-development
Source: https://github.com/ByronWilliamsCPA/.claude/tree/main/.claude/skills/doubt-driven-development
Command: npx skills add https://github.com/ByronWilliamsCPA/.claude --skill doubt-driven-development-byronwilliamscpa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Non-trivial development decisions often contain unstated assumptions, edge cases, and hidden coupling that go undetected due to accumulated context turning overconfidence into perceived correctness. These flaws lead to costly production bugs, security vulnerabilities, and irreversible errors that are far more expensive to fix after deployment than during development.

Core Features & Use Cases

  • Adversarial Fresh-Context Review: Spawns an unbiased, issue-focused reviewer to disprove your non-trivial decisions (architectural choices, complex code changes, security-sensitive logic, irreversible operations like data migrations or public API updates) before they are finalized, catching flaws that accumulated context would hide.
  • Bounded Review Loop: Enforces a maximum 3-cycle review process with clear stop conditions (trivial findings, user override, cycle limit) to prevent endless rework while ensuring thorough scrutiny.
  • Optional Cross-Model Escalation: Offers multi-model review via external CLIs or the consensus skill for high-stakes artifacts, catching blind spots shared by a single model, with strict safety guardrails for external tool execution.
  • Use Case Example: When working in an unfamiliar codebase to implement a new payment processing flow, use this skill to run an adversarial review of your logic before committing, catching edge cases around failed transactions that would lead to revenue loss and customer frustration.

Quick Start

Invoke the doubt-driven-development skill to perform an adversarial review of your proposed payment processing flow implementation before merging it to the main branch.

Frequently Asked Questions about doubt-driven-development

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

FAQPage Schema
How do I catch hidden assumptions and edge cases before finalizing complex code changes?

Adversarial decision review catches hidden assumptions by spawning an unbiased reviewer who receives only the artifact and contract to disprove your logic, identifying edge cases and hidden coupling that accumulated context hides. It classifies all findings as contract misreads, actionable issues, valid trade-offs, or noise before stopping.

What is the best way to validate irreversible operations like data migrations and public API updates?

Adversarial fresh-context review validates irreversible operations by subjecting data migrations and public API updates to a bounded 3-cycle review loop, catching flaws before finalization. This prevents costly production bugs and security vulnerabilities that are expensive to fix after deployment.

How does adversarial code review work for security-sensitive logic in unfamiliar codebases?

Adversarial code review for security-sensitive logic works by requiring reviewers to receive only the artifact and contract, not the author's reasoning, to avoid bias. It enforces a bounded 3-cycle loop with optional cross-model escalation via external CLIs to catch blind spots shared by a single model.

When do I need to run an adversarial review of my architectural decisions?

You need adversarial review for architectural decisions when verification cost is lower than debugging cost, especially for complex code changes, security-sensitive logic, irreversible operations including data migrations and public API updates, and work in unfamiliar codebases where unstated assumptions lead to costly production bugs.

Can I use cross-model escalation for high-stakes artifact review?

Yes, optional cross-model escalation offers multi-model review via external CLIs or the consensus skill for high-stakes artifacts, catching blind spots shared by a single model. It includes strict safety guardrails for external tool execution during the adversarial review process.

What are the limitations of the bounded 3-cycle review loop for bug prevention?

The bounded 3-cycle review loop limits rework by enforcing a maximum of three cycles with clear stop conditions including trivial findings, user override, or reaching the cycle limit. This prevents endless rework while ensuring thorough scrutiny of non-trivial development decisions.