doubt-driven-development

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

Updated Aug 11, 2026
One-click install
npx skills add https://github.com/Kunj-Sharma03/agent-contextify --skill doubt-driven-development-kunj-sharma03
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doubt-driven-development
Source: https://github.com/Kunj-Sharma03/agent-contextify/tree/main/templates/skills/doubt-driven-development
Command: npx skills add https://github.com/Kunj-Sharma03/agent-contextify --skill doubt-driven-development-kunj-sharma03

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Confident answers are not always correct ones, and long coding sessions quietly turn assumptions into accepted facts. This Skill catches wrong architectural and implementation decisions early by forcing every non-trivial decision through an adversarial fresh-context review while course-correction is still cheap. ## Core Features & Use Cases - Five-Step Doubt Cycle: A bounded CLAIM, EXTRACT, DOUBT, RECONCILE, STOP loop that names each decision, isolates the smallest reviewable artifact, and classifies reviewer findings as contract misread, actionable, trade-off, or noise. - Adversarial Reviewer Prompting: Provides a verbatim issues-only prompt that overrides balanced reviewer personas, passing only the artifact and contract so the reviewer is not biased toward agreement. - Cross-Model Escalation: Offers an optional second opinion via external CLIs like Gemini or Codex with read-only sandboxing, stdin piping to avoid shell injection, and explicit per-invocation user authorization. - Use Case: Before committing a new caching layer claimed to be thread-safe, run the doubt cycle so a fresh-context 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 review the thread-safety of the new caching layer before committing it.

Frequently Asked Questions about doubt-driven-development

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

FAQPage Schema
How do I verify a code decision before committing it?

Use the doubt cycle: write a compact CLAIM naming the decision, 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, three cycles, or user override.

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

Doubt-driven development is an in-flight posture applied per non-trivial decision while changes are still cheap, whereas a 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 code?

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 second opinion from a different AI model during review?

Yes, the skill offers cross-model escalation through external CLIs such as Gemini or Codex in interactive sessions. Each invocation requires a PATH check, a working-binary test, user confirmation of the exact command, and a read-only sandbox with the prompt piped via stdin.

Why does the reviewer only receive the artifact and contract?

Passing your claim or reasoning biases the reviewer toward agreement with your conclusions. Supplying only the artifact and contract forces the reviewer to independently determine whether the artifact satisfies the contract.

What are the limitations of fresh-context review?

A fresh reviewer lacks session context, so it can produce false flags that must be classified as noise during reconciliation. It also cannot run nested inside a subagent persona, where only a degraded self-questioning fallback is available.