doubt-driven-development

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

Updated Sep 8, 2026
One-click install
npx skills add https://github.com/sasidhar4444/ai-receptionist --skill doubt-driven-development-sasidhar4444
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: doubt-driven-development
Source: https://github.com/sasidhar4444/ai-receptionist/tree/main/agent-skills/skills/doubt-driven-development
Command: npx skills add https://github.com/sasidhar4444/ai-receptionist --skill doubt-driven-development-sasidhar4444

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Confident answers are not always correct ones, and long sessions quietly turn assumptions into facts. This Skill forces every non-trivial decision through an adversarial fresh-context review while course-correction is still cheap, catching hidden failure modes before they reach production. ## Core Features & Use Cases - Structured Doubt Cycle: A five-step process (CLAIM, EXTRACT, DOUBT, RECONCILE, STOP) that isolates the artifact and contract, then cross-examines them with an adversarial reviewer prompt. - Cross-Model Escalation: Optionally routes the artifact to external CLI reviewers (Gemini CLI, Codex CLI) via stdin with read-only sandboxing to catch single-model blind spots. - Bounded Loop with Stop Conditions: Caps review at 3 cycles, classifies findings by precedence (contract misread, actionable, trade-off, noise), and escalates unresolved artifacts to the user. - Use Case: Before committing a thread-safety change to a caching layer, name the claim, extract the diff and its contract, spawn a fresh-context reviewer with an issues-only prompt, reconcile findings, and ship only when the stop condition is met. ## Quick Start Ask the agent to apply doubt-driven development to review 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?▼

Use 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 against the artifact text and stop after trivial findings, 3 cycles, or user override.

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

Code review is a post-hoc verdict on a finished artifact like a pull request. Doubt-driven development is an in-flight posture that cross-examines individual non-trivial decisions while course-correction is still cheap, before the PR stage.

When should I not apply adversarial review to 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 use a second AI model to review my code artifacts?▼

Yes, the skill supports cross-model escalation through external CLIs such as Gemini CLI or Codex CLI. The prompt is piped via stdin with a read-only sandbox, and each invocation requires explicit user authorization and syntax confirmation.

Why does the reviewer receive the artifact but not the claim?▼

Passing the CLAIM biases the reviewer toward agreeing with your conclusion. The reviewer receives only the artifact and its contract so it independently determines whether the artifact satisfies the contract.