doubt-driven-development

Reviews non-trivial code decisions with adversarial fresh-context reviewers before they stand.

Updated Jun 13, 2026
One-click install
npx skills add https://github.com/22Teikk/22Teikk-Agent-Skills-Hub --skill doubt-driven-development-22teikk
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: doubt-driven-development
Source: https://github.com/22Teikk/22Teikk-Agent-Skills-Hub/tree/main/core/skills/doubt-driven-development
Command: npx skills add https://github.com/22Teikk/22Teikk-Agent-Skills-Hub --skill doubt-driven-development-22teikk

SYSTEM DOCUMENTATION & REQUIREMENTS

๐Ÿ’ก This Skill includes references (resource) components.

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 flawed architectural decisions, unsafe claims, and hidden edge cases while course-correction is still cheap, before they become production bugs. ## Core Features & Use Cases - Adversarial Fresh-Context Review: Spawns an isolated reviewer prompted to disprove, not approve, your artifact against its contract. - Bounded Doubt Cycle: A five-step process (CLAIM, EXTRACT, DOUBT, RECONCILE, STOP) capped at three cycles to prevent endless second-guessing. - Cross-Model Escalation: Optionally routes the artifact to an external CLI model (Gemini CLI, Codex CLI) in a read-only sandbox to catch single-model blind spots. - Use Case: Before committing a new caching layer you believe is thread-safe, extract the diff and its contract, have a fresh-context reviewer attack it for race conditions and unstated assumptions, then reconcile the findings before merging. ## 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 non-trivial code decision before committing?โ–ผ

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 prompt that asks it to find issues. Classify each finding as contract misread, actionable, trade-off, or noise before deciding.

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

Doubt-driven development is an in-flight check on individual non-trivial decisions while changes are still cheap to reverse. A code review like /teikk-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 fresh-context review?โ–ผ

Skip it for mechanical operations like renaming or formatting, one-line changes with obvious correctness, reading or summarizing code, and pure tooling operations. The skill applies only to non-trivial decisions involving branching logic, cross-boundary changes, or irreversible blast radius.

Can this skill run inside a subagent or persona context?โ–ผ

No, it is designed for the main-session orchestrator because spawning a reviewer from a persona violates the depth-1 orchestration rule. In a subagent context, escalate to the main session, or use a degraded self-questioning fallback flagged as not fresh-context review.

How does cross-model second opinion work and is it safe?โ–ผ

After a single-model review, the agent offers to send the artifact to an external CLI like Gemini CLI or Codex CLI. It runs in a read-only sandbox with the prompt piped via stdin, requires explicit user authorization per invocation, and is skipped with an announcement in non-interactive contexts.

Why does the reviewer only receive the artifact and contract?โ–ผ

Passing your CLAIM or reasoning biases the reviewer toward agreeing with your conclusion. Supplying only the artifact and contract forces the reviewer to independently determine whether the artifact satisfies the contract, which is the point of fresh-context review.