Is this skill suitable for quick bug fixes?

No, DDD is designed for high-complexity tasks; simple typo fixes or single-file changes are better handled through standard workflows.

When should I use the DDD Guide skill?

It is best for multi-file changes, new features in existing codebases, and complex integrations where design flaws need to be caught early.

How does this skill prevent AI hallucinations?

By enforcing clear specifications and a single source of truth, it provides the AI with better context and reduces contradictory information.

What is 'Retcon Writing' in this context?

It is the practice of documenting features as if they already exist (using present tense) to ensure the documentation acts as a definitive record of the system.

What is Document-Driven Development (DDD)?

DDD is a workflow where documentation is treated as the primary specification, and code is written only after documentation is updated and verified.

Document-Driven Development (DDD) Guide

Name: Document-Driven Development (DDD) Guide
Author: drillan

bydrillan

0•

Productivity & Workflow

Implements a documentation-first workflow for existing codebases to ensure code and specifications remain perfectly synchronized.

The Document-Driven Development (DDD) Guide skill transforms how developers approach complex changes in existing codebases by enforcing a documentation-first philosophy. By prioritizing specifications over implementation, it helps catch design flaws early, prevents documentation drift, and minimizes AI hallucinations through clear context. The skill provides a structured six-phase workflow—from initial planning and retcon-style documentation to final implementation—making it an essential tool for managing multi-file updates and high-complexity integrations where precision is paramount.

Key Features

010 GitHub stars

02Structured six-phase development workflow from initial planning to finalization

03Retcon writing methodology to ensure documentation remains the authoritative source

04Context poisoning prevention by enforcing a single source of truth

05Systematic file crawling to prevent context overflow during code implementation

06Built-in planning commands for generating systematic implementation checklists

Use Cases

01Synchronizing outdated documentation with current or intended system behavior

02Facilitating human-centric code reviews by focusing on specification approvals before coding

03Managing large-scale refactors or new feature additions in complex, multi-file codebases

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add drillan/amplifier-skills-plugin ddd-guide

For use in Claude.ai and ChatGPT

Download Skill