Puzzle Driven Development in Action

puzzle driven development is a methodology we've been practicing on our teams for more than seven years. using pdd, we delegate the responsibility of task decomposition to its performers, eliminating the role of a project manager. we've been using our proprietary software for that. a month ago, we made it public, open source, and free. it is available at 0pdd —a github-based chat bot.

here is how you configure it, in two steps. first, you grant read-only access to @0pdd in github (either private or public repository).

second, you add a webhook to your github repository: http://www.0pdd.com/hook/github (with just a push event).

now, your repository is being watched by 0pdd . every time you git push something new, it does a git pull and retrieves your changes from github. then it runs pdd , a command line tool that scans the entire code base and finds all occurrences of @todo markers.

for all newly found markers, 0pdd will submit new issues to the github issue tracking section of your repository.

also, when you remove markers from your code base, 0pdd will immediately close issues it created.

now, when an issue is assigned to a programmer, we allow him or her to return incomplete code back to the master. if and when the code is not complete, we ask the programmer to leave @todo markers in the code, called "puzzles." later, these puzzles will be assigned to other programmers, and so on. eventually, the problem will be fixed when most puzzles are resolved.

0pdd helps you automate this process and provides a summary report of the current situation with all puzzles in the entire code base. you can even add a nice badge to your github repo:

if you click it, you will see the full report of all puzzles currently present and previously seen.

this mechanism helps us in many projects. you can use it for free. it's an open-source ruby product; feel free to contribute .