doubt-driven-development

Subjects every non-trivial decision to a fresh-context adversarial review before it stands. Use when correctness matters more tha…

addyosmani 80k ↓ 11k MIT updated 26d ago
Claude Code
View source ↗

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.

doubt-driven-development on getagentictools
[![doubt-driven-development on getagentictools](https://getagentictools.com/badge/skills/addyosmani-agent-skills-doubt-driven-development.svg)](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.