addyosmani/doubt-driven-development

Unterzieht jede nicht-triviale Entscheidung einer frischen, konträren Prüfung, bevor sie bestehen bleibt. Verwenden Sie dies, wenn Korrektheit wichtiger ist als Geschwindigkeit, wenn Sie mit unbekanntem Code arbeiten, wenn die Einsätze hoch sind (Produktion, sicherheitsrelevante Logik, irreversible Operationen) oder immer dann, wenn ein selbstbewusstes Ergebnis billiger zu verifizieren als später zu debuggen wäre.

Was ist doubt-driven-development?

Dieser Skill, 'Doubt-Driven Development' (DDD), implementiert einen rigorosen kognitiven Prozess zur Verbesserung der Codekorrektheit, insbesondere in Situationen mit hohem Risiko oder unbekannten Codestrukturen. Anstatt Entscheidungen blind zu vertrauen, unterzieht DDD jede nicht-triviale Entscheidung einer frischen, konträren Überprüfung in einem neuen Kontext. Der Kern besteht darin, dass der AI-Agent nach jeder wichtigen Entscheidung (z. B. Architekturänderung, Datenfluss oder Fehlerbehandlung) eine Pause einlegt, ein neues Analyse-Fenster öffnet und die Entscheidung kritisch hinterfragt: Gibt es einen besseren Ansatz, eine versteckte Abhängigkeit oder einen nicht bedachten Randfall? Dieser iterative Prozess mit konstruktivem Zweifel ist wertvoll für die Überprüfung von Produktionscode, Sicherheitslogik, komplexen Refactorings und irreversiblen Vorgängen. Er unterstützt agentische und code-erstellende Plattformen wie Claude Code, Cursor und Codex und wird durch eine strukturierte Datei (`ddd.md`) gesteuert, die den Analyseprozess definiert. Der Nutzen liegt in der Reduzierung von Debugging-Zeit und der Vermeidung teurer Produktionsfehler, indem die Verifizierung an den Punkt der Entscheidungsfindung verlagert wird.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/addyosmani/agent-skills/tree/main/skills/doubt-driven-development

Installed? Explore more Produktivität & Zusammenarbeit skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht doubt-driven-development?

Unterzieht jede nicht-triviale Entscheidung einer frischen, konträren Prüfung, bevor sie bestehen bleibt. Verwenden Sie dies, wenn Korrektheit wichtiger ist als Geschwindigkeit, wenn Sie mit unbekanntem Code arbeiten, wenn die Einsätze hoch sind (Produktion, sicherheitsrelevante Logik, irreversible Operationen) oder immer dann, wenn ein selbstbewusstes Ergebnis billiger zu verifizieren als später zu debuggen wäre.

Wie es funktioniert

  1. Identifizieren Sie eine nicht-triviale Entscheidung – eine Architekturänderung, einen Datenfluss, eine Fehlerbehandlung, einen Abstraktionsgrenzfall, eine API-Wahl.
  2. Pausieren Sie. Bevor Sie den nächsten Schritt ausgeben, öffnen Sie eine frische Analyse.
  3. Überprüfen Sie mit neuem Kontext. Fragen Sie: Gibt es einen besseren Ansatz? Habe ich eine Abhängigkeit übersehen? Was passiert im Randfall X? Ist dies unter Last skalierbar? Der Prüfer kennt das vorherige Gespräch nicht – er sieht nur das Artefakt.
  4. Wiederholen Sie, bis die Prüfung besteht, oder kehren Sie den Kurs um.

Wann zu verwenden

SituationEmpfehlung
Neues Projekt, geringes RisikoÜberspringen
Refactoring einer bestehenden FunktionDDD anwenden
Sicherheitsschicht / Auth-LogikDDD erforderlich
Datenbank-MigrationDDD erforderlich
Prototyping / ErkundungÜberspringen

Implementierungshinweise

  • Der Skill wird durch eine Datei ddd.md im Projektstamm gesteuert.
  • Der Agent kann den vollständigen Prompt aus dieser Datei lesen, um den Analyseprozess zu verstehen.
  • Während der Ausführung erzeugt der Skill eine temporäre Datei ddd-review.md, die die Fragen des Prüfers und die Antworten des Autors enthält.
  • Die endgültige Ausgabe wird in ddd-log.md protokolliert.

Beispielablauf

# Schritt 1: Agent generiert Lösung
Ändern der Abfrage von JOIN zu einer materialisierten Ansicht…

# Schritt 2: DDD auslösen – frischer Kontext
„Überprüfung: Beitritt zu materialisierter Ansicht – erwägen Sie Cache-Invalidierung, Abfrage-Latenz und Betriebskosten.“

# Schritt 3: Agent prüft, erkennt, dass die Ansicht für 90% der Lesevorgänge zu oft aktualisiert wird

# Schritt 4: Agent kehrt zu JOIN zurück, fügt jedoch CQRS mit einem Redis-Cache hinzu

Plattformkompatibilität

Dieser Skill wurde entwickelt für:

  • Claude Code (primäre Implementierung)
  • Cursor (über benutzerdefinierte Regeln)
  • Codex CLI (über System-Prompt-Extension)

Verwandte Skills

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

addyosmani/agent-skills

Guides stable API and interface design. Use when designing APIs, module boundaries, or any public interface. Use when creating REST or GraphQL endpoints, defining type contracts between modules, or establishing boundaries between frontend and backend.

addyosmani/agent-skills

Prepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.

addyosmani/agent-skills

Builds production-quality, accessible, responsive user-facing UIs. Use when building or modifying interfaces and pages, creating components, implementing layouts, meeting WCAG accessibility requirements, managing state, or when the output needs to look and feel production-quality rather than AI-generated.

addyosmani/browser-testing-with-devtools

Tests in real browsers via Chrome DevTools MCP. Use when building or debugging anything that runs in a browser. Use when you need to inspect the DOM, capture console errors, analyze network requests, profile performance, or verify visual output with real runtime data. Requires the chrome-devtools MCP server to be configured.

addyosmani/ci-cd-and-automation

Automates CI/CD pipeline setup. Use when setting up or modifying build and deployment pipelines. Use when you need to automate quality gates, configure test runners in CI, or establish deployment strategies.

addyosmani/code-review-and-quality

Conducts multi-axis code review. Use before merging any change. Use when reviewing code written by yourself, another agent, or a human. Use when you need to assess code quality across multiple dimensions before it enters the main branch.

addyosmani/code-simplification

Simplifies code for clarity. Use when refactoring code for clarity without changing behavior. Use when code works but is harder to read, maintain, or extend than it should be. Use when reviewing code that has accumulated unnecessary complexity.

addyosmani/constraint-driven-development

Establishes a project's quality bar as a written contract and stops agents quietly lowering it. Interviews the user on which dimensions matter, supplies sane default thresholds when they have no number in mind, records everything in CONSTRAINTS.md, and watches the diff for a weakened bar — new @ts-ignore or eslint-disable suppressions, skipped or deleted tests, assertions stripped out, unimplemented stubs, thresholds edited down. Use when no quality bar is written down, when the user says "set up constraints" or "define our standards", when the user wants dimensions they care about — accessibility, web performance, coverage — set up as enforced constraints, when an agent keeps silencing checks or skipping tests to get to green, when you need a coverage or performance threshold and don't know what number to pick, or when an agent writes more code than anyone will read.

addyosmani/debugging-and-error-recovery

Guides systematic root-cause debugging. Use when tests fail, builds break, behavior doesn't match expectations, or you encounter any unexpected error. Use when you need a systematic approach to finding and fixing the root cause rather than guessing.

addyosmani/deprecation-and-migration

Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when deciding whether to maintain or sunset existing code.

addyosmani/documentation-and-adrs

Records decisions and documentation. Use when making architectural decisions, changing public APIs, shipping features, or when you need to record context that future engineers and agents will need to understand the codebase.

addyosmani/git-workflow-and-versioning

Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving conflicts, or when you need to organize work across multiple parallel streams.

addyosmani/idea-refine

Refines raw ideas into sharp, actionable concepts through structured divergent and convergent thinking. Use when an idea is still vague, when you need to stress-test assumptions before committing to a plan, or when you want to expand options before converging on one. Triggers on "ideate", "refine this idea", or "stress-test my plan".

addyosmani/incremental-implementation

Delivers changes incrementally. Use when implementing any feature or change that touches more than one file. Use when you're about to write a large amount of code at once, or when a task feels too big to land in one step.

addyosmani/interview-me

Extracts what the user actually wants instead of what they think they should want. Achieves this through one-question-at-a-time interview until ~95% confidence about the underlying intent. Use when an ask is underspecified ("build me X" without "for whom" or "why now"), when the user explicitly invokes ("interview me", "grill me", "are we sure?", "stress-test my thinking"), or when you catch yourself silently filling in ambiguous requirements before any plan, spec, or code exists.

addyosmani/observability-and-instrumentation

Instruments code so production behavior is visible and diagnosable. Use when adding logging, metrics, tracing, or alerting. Use when shipping any feature that runs in production and you need evidence it works. Use when production issues are reported but you can't tell what happened from the available data.

addyosmani/performance-optimization

Optimizes application performance. Use when performance requirements exist, when you suspect performance regressions, or when Core Web Vitals or load times need improvement. Use when profiling reveals bottlenecks that need fixing.

addyosmani/planning-and-task-breakdown

Breaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.

addyosmani/security-and-hardening

Hardens code against vulnerabilities. Use when handling user input, authentication, data storage, or external integrations. Use when building any feature that accepts untrusted data, manages user sessions, or interacts with third-party services.

addyosmani/source-driven-development

Grounds every implementation decision in official documentation. Use when you want authoritative, source-cited code free from outdated patterns. Use when building with any framework or library where correctness matters.

Verwandte Skills