doubt-driven-development
Subjects every non-trivial decision to a fresh-context adversarial review before it stands. Use when correctness matters more tha…
What it does
- It introduces or modifies branching logic
- It crosses a module or service boundary
- It asserts a property the type system or compiler cannot verify (thread safety, idempotence, ordering, invariants)
- Its correctness depends on context the future reader cannot see
- Its blast radius is irreversible (production deploy, data migration, public API change)
- About to make an architectural decision under uncertainty
- About to commit non-trivial code
Requirements & configuration
- Its correctness depends on context the future reader cannot see
- A fresh-context reviewer needs the artifact and the contract, not the journey.
Derived from the skill's own SKILL.md documentation · extracted 2026-07-23
Subjects every non-trivial decision to a fresh-context adversarial review before it stands. Use when correctness matters more than speed, when working in unfamiliar code, when stakes are high (production, security-sensitive logic, irreversible operations), or any time a confident output would be cheaper to verify now than to debug later.
Source
Repository: https://github.com/addyosmani/agent-skills
doubt-driven-development FAQ
What does the doubt-driven-development skill do?
Subjects every non-trivial decision to a fresh-context adversarial review before it stands. Use when correctness matters more than speed, when working in unfamiliar code, when stakes are high (production, security-sensitive logic, irreversible operations), or any time a confident output would be cheaper to verify now than to debug later. It introduces or modifies branching logic It crosses a module or service boundary
What does doubt-driven-development require?
Its correctness depends on context the future reader cannot see A fresh-context reviewer needs the artifact and the contract, not the journey.
How do I install doubt-driven-development?
Run: npx -y skills add https://github.com/addyosmani/agent-skills --skill doubt-driven-development --agent claude-code — the source lives at github.com/addyosmani/agent-skills.
Maintain doubt-driven-development?
Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.
[](https://getagentictools.com/skills/addyosmani-agent-skills-doubt-driven-development?ref=badge) npx agentictools info skills/addyosmani-agent-skills-doubt-driven-development The second line is the CLI lookup for this page — handy in READMEs and docs.