doubt-driven-development

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

5|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/PHenrique07/Sementis-IFSP-Pirituba --skill doubt-driven-development-phenrique07
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: doubt-driven-development
Source: https://github.com/PHenrique07/Sementis-IFSP-Pirituba/tree/main/.github/skills/doubt-driven-development
Command: npx skills add https://github.com/PHenrique07/Sementis-IFSP-Pirituba --skill doubt-driven-development-phenrique07

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Long working sessions quietly turn assumptions into facts, and confident answers are not always correct ones. This Skill catches wrong directions early by forcing every non-trivial decision through an adversarial fresh-context review while course-correction is still cheap. ## Core Features & Use Cases - Structured Doubt Cycle: A five-step process (CLAIM, EXTRACT, DOUBT, RECONCILE, STOP) that isolates the smallest reviewable artifact and contract, then cross-examines it with an adversarial 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 production caching layer, name the claim, extract the diff plus its contract, spawn an adversarial reviewer, reconcile findings, and ship only after a stop condition is met. ## Quick Start Ask the AI 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 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 decision while changes are still cheap, whereas code review is a post-hoc verdict on a finished artifact like a pull request. 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 use Gemini CLI or Codex CLI for cross-model code review?▼

Yes, after verifying the binary works, write the adversarial prompt plus artifact and contract to a file and pipe it via stdin using a read-only sandbox mode. Never interpolate artifacts into shell-quoted arguments, and always get explicit user authorization per invocation.

Why should 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 must independently determine whether the artifact satisfies the contract, so only ARTIFACT and CONTRACT are passed.

What are the limitations of fresh-context adversarial review?▼

A fresh reviewer lacks session context and can produce false flags, so findings must be re-classified against the artifact text rather than rubber-stamped. The loop is also bounded at three cycles; larger artifacts must be decomposed first.