doubt-driven-development

Review non-trivial code decisions through fresh-context adversarial reviews.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the challenge of ensuring code correctness by subjecting non-trivial decisions to a fresh-context adversarial review.

Core Features & Use Cases

  • Adversarial Review: Conducts adversarial reviews to identify potential issues in code decisions.
  • Non-Trivial Decisions: Focuses on decisions that introduce or modify branching logic, cross-service boundaries, etc.
  • Use Case: When making an architectural decision under uncertainty or when working in unfamiliar code, this Skill helps ensure the correctness of the decision.

Quick Start

To apply the doubt-driven-development skill, copy the following checklist when making a non-trivial decision:

Doubt cycle:
- [ ] Step 1: CLAIM — wrote the claim + why-it-matters
- [ ] Step 2: EXTRACT — isolated artifact + contract, stripped reasoning
- [ ] Step 3: DOUBT — invoked fresh-context reviewer with adversarial prompt
- [ ] Step 4: RECONCILE — classified every finding against the artifact text
- [ ] Step 5: STOP — met stop condition (trivial findings, 3 cycles, or user override)

Frequently Asked Questions about doubt-driven-development

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

FAQPage Schema
What is adversarial code review and how does it verify correctness?

Adversarial code review verifies non-trivial code decisions by subjecting them to fresh-context scrutiny. It strips prior reasoning, attacks isolated artifacts, and classifies findings to ensure correctness in production code or security-sensitive logic.

How do I perform a doubt-driven review cycle for architectural decisions?

To perform a doubt-driven review cycle: claim the decision and its importance, extract the isolated artifact, invoke an adversarial reviewer, reconcile findings against the artifact, and stop when findings become trivial or after three cycles.

When should I use fresh-context adversarial reviews for code decisions?

Use fresh-context adversarial reviews when correctness is paramount, such as for production code or security-sensitive logic. Apply the doubt cycle to non-trivial decisions involving branching logic, cross-service boundaries, or unfamiliar codebases.

Does adversarial review work for cross-service boundary logic?

Yes, adversarial review specifically targets non-trivial decisions like cross-service boundary logic. By isolating the artifact and applying fresh-context scrutiny, it identifies potential issues in complex architectural interactions.

What are the limitations of using adversarial reviews for code correctness?

Adversarial reviews require a persona with fresh-context capabilities and may need up to three cycles. The approach targets non-trivial decisions like branching logic or cross-service boundaries, and may not suit simple or trivial code modifications.