pdd

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