Tooluck logoTooluck
SKILL.md

doubt-driven-development

Agent skill fromaddyosmani/agent-skills

Subjects every non-trivial decision to a fresh-context adversarial review before it stands. Use when you want every assumption cross-examined before proceeding, when stress-testing a plan for hidden failure modes, when correctness matters more than speed, when working in unfamiliar code, when stakes are high (production auth, security-sensitive logic, a high-stakes migration, irreversible operations), or any time a confident output would be cheaper to verify now than to debug later.

How to install doubt-driven-development

install doubt-driven-development
# install the agent-skills pack with the skills CLI
npx skills add addyosmani/agent-skills

# or add only this skill to Claude Code: copy the folder

skills/doubt-driven-development/

# into

~/.claude/skills/doubt-driven-development/ (all projects)

.claude/skills/doubt-driven-development/ (one project)

skills/doubt-driven-development/SKILL.md

MITFull file
1# Doubt-Driven Development
2
3## Overview
4
5A confident answer is not a correct one. Long sessions accumulate context that quietly turns assumptions into "facts" without anyone noticing. Doubt-driven development is the discipline of materializing a fresh-context reviewer — biased to **disprove**, not approve — before any non-trivial output stands.
6
7This is not `/review`. `/review` is a verdict on a finished artifact. This is an in-flight posture: non-trivial decisions get cross-examined while course-correction is still cheap.
8
9## When to Use
10
11A decision is **non-trivial** when at least one of these is true:
12
13- It introduces or modifies branching logic
14- It crosses a module or service boundary
15- It asserts a property the type system or compiler cannot verify (thread safety, idempotence, ordering, invariants)
16- Its correctness depends on context the future reader cannot see
17- Its blast radius is irreversible (production deploy, data migration, public API change)
18
19Apply the skill when:
20
21- About to make an architectural decision under uncertainty
22- About to commit non-trivial code
23- About to claim a non-obvious fact ("this is safe", "this scales", "this matches the spec")
24- Working in code you don't fully understand
25
26**When NOT to use:**
27
28- Mechanical operations (renaming, formatting, file moves)
29- Following a clear, unambiguous user instruction
30- Reading or summarizing existing code
31- One-line changes with obvious correctness
32…

Excerpt shown under the repository's MIT license.

More skills in agent-skills

Keep exploring

Similar skill repositories

thedotmack /

claude-mem
116k

Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More

CCCXGHGM+135 skills

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates