pdd

Installation
SKILL.md

What is PDD?

Puzzle Driven Development breaks features into small, working increments. Each increment leaves @todo puzzle comments marking deferred work. This lets multiple agents (AI or human) work in parallel and progress without being blocked by incomplete pieces.

A good increment:

  • Passes tests — never leave failing tests as technical debt
  • Has working stubs — throws an error indicating that the stub is still unimplemented; never silently swallow unimplemented behaviour
  • Documents context — the @todo comment should give the next agent enough to start without reading all the history

@todo Comment Format

Related skills
Installs
17
GitHub Stars
2
First Seen
Feb 19, 2026