doubt-driven-development

Subjects non-trivial decisions to fresh-context adversarial review before they stand.

Updated Aug 22, 2026
One-click install
npx skills add https://github.com/MSC72m/DevForge --skill doubt-driven-development-msc72m
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: doubt-driven-development
Source: https://github.com/MSC72m/DevForge/tree/main/skills/doubt-driven-development
Command: npx skills add https://github.com/MSC72m/DevForge --skill doubt-driven-development-msc72m

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Long coding sessions accumulate context that quietly turns assumptions into facts, and confident answers are not always correct ones. This Skill catches wrong directions early by cross-examining every non-trivial decision with a fresh-context reviewer biased to disprove, while course-correction is still cheap. ## Core Features & Use Cases - Five-Step Doubt Cycle: CLAIM the decision, EXTRACT the smallest reviewable artifact plus contract, DOUBT via an adversarial fresh-context reviewer, RECONCILE findings by precedence, and STOP within a bounded three-cycle loop. - Adversarial Review Prompting: Passes only the artifact and contract to the reviewer with an issues-only prompt, preventing the bias toward agreement that comes from sharing your conclusions. - Cross-Model Escalation: Offers optional second opinions through external CLIs like Gemini or Codex with read-only sandboxing and explicit per-invocation user authorization. - Use Case: Before committing a new caching layer you believe is thread-safe, run the doubt cycle so a fresh reviewer hunts for race conditions, unstated assumptions, and contract violations before the code ships. ## Quick Start Ask the agent to apply doubt-driven development to stress-test the architectural decision or code change you are about to commit.

Frequently Asked Questions about doubt-driven-development

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

FAQPage Schema
How do I stress-test a code decision before committing it?▼

Apply the doubt cycle: write a compact CLAIM, extract the smallest reviewable artifact plus its contract, then invoke a fresh-context reviewer with an adversarial find-issues prompt. Classify each finding as contract misread, actionable, trade-off, or noise before reconciling.

What is the difference between doubt-driven development and code review?▼

Doubt-driven development is an in-flight posture that cross-examines individual non-trivial decisions while course-correction is cheap, whereas code review is a post-hoc verdict on a finished artifact or PR. The two are complementary and can be used together.

When should I not use adversarial review on my changes?▼

Skip it for mechanical operations like renaming or formatting, one-line changes with obvious correctness, reading or summarizing code, pure tooling operations, and when the user explicitly prioritizes speed over verification.

Can I get a cross-model second opinion using Gemini or Codex CLI?▼

Yes, in interactive sessions the skill offers cross-model escalation after the single-model review. The agent verifies the CLI is in PATH, tests the binary, confirms the exact invocation with you, and pipes the prompt via stdin with a read-only sandbox.

Why should the reviewer not receive my claim or reasoning?▼

Handing the reviewer your conclusion biases it toward agreement and validation of your reasoning. The reviewer must independently determine whether the artifact satisfies the contract, so it receives only the artifact and contract with an adversarial prompt.

What are the limitations of fresh-context review?▼

A fresh reviewer lacks session context and can produce false flags or noise, so findings must be re-classified against the artifact text rather than rubber-stamped. The loop is also bounded at three cycles; persistent substantive issues mean the artifact needs decomposition or user escalation.