doubt-driven-development

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

2|Updated Jul 1, 2026
One-click install
npx skills add https://github.com/Lazare-Panam/mars-api --skill doubt-driven-development-lazare-panam
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doubt-driven-development
Source: https://github.com/Lazare-Panam/mars-api/tree/main/Mars.API/.claude/skills/doubt-driven-development
Command: npx skills add https://github.com/Lazare-Panam/mars-api --skill doubt-driven-development-lazare-panam

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 catches wrong directions in non-trivial decisions while course-correction is still cheap, before they become production bugs. ## Core Features & Use Cases - Five-step doubt cycle: CLAIM the decision, EXTRACT the smallest reviewable artifact plus contract, DOUBT it with an adversarial fresh-context reviewer, RECONCILE findings by precedence, and STOP at a bounded condition. - Adversarial review protocol: The reviewer receives only the artifact and contract with a find-issues prompt, never the author's conclusion, preventing biased validation. - Cross-model escalation: Optionally routes the artifact to external CLI reviewers (Gemini CLI, Codex CLI) with read-only sandboxing and explicit per-invocation user authorization. - Use Case: Before committing a 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 merge. ## Quick Start Ask the assistant to apply doubt-driven development to the architectural decision or non-trivial 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 verify a code decision before committing it?

Use the doubt cycle: state the decision as a compact CLAIM, extract the smallest reviewable artifact plus its contract, and pass only those to a fresh-context reviewer with an adversarial find-issues prompt. Classify each finding as contract misread, actionable, trade-off, or noise before acting.

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 both be used.

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 use Gemini CLI or Codex CLI for a second opinion on code?

Yes, the skill supports cross-model escalation by piping the artifact, contract, and adversarial prompt via stdin to a verified CLI in read-only sandbox mode. Each invocation requires a PATH check, a working-binary test, and explicit user authorization.

Why does the reviewer not receive my original claim or reasoning?

Passing your conclusion biases the reviewer toward agreement, defeating the purpose of fresh-context review. The reviewer receives only the artifact and contract so it independently determines whether the artifact satisfies the contract.

How many doubt cycles should run before stopping?

Stop when findings become trivial, after three cycles, or when the user says ship it. If three cycles still surface substantive issues, escalate to the user or decompose the artifact rather than looping further.