/todo

Quick capture for your project’s backlog. For structured planning, use /design.

Usage

/todo                          # List all todos
/todo Fix typo in README       # Add simple todo
/todo Add notification system  # Complex → suggests /design

/todo vs /design

/todo/design
PurposeQuick captureStructured planning
OutputFuture table rowRecord with Stories
Use when”Remember this""Plan how to build this”

What It Does

Listing Todos

/todo

Shows all items from the Future table in CLAUDE.md.

Adding Simple Todos

/todo Fix typo in header

Adds directly to the Future table:

| Todo | Priority | Problem | Solution |
|------|----------|---------|----------|
| Fix typo in header | Low | Typo in heading | Fix spelling |

Complex Items

/todo Add OAuth2 authentication

If the item looks complex (architecture decision, multiple parts, needs design):

This looks like it needs proper design.

Consider using: /design "Add OAuth2 authentication"

Or add as simple reminder anyway? [Yes / No]
  • Yes: Adds to Future table as a reminder
  • No: Suggests running /design instead

When to Use Which

SituationCommand
”Fix the typo on line 5”/todo
”Remember to update docs”/todo
”Add user authentication”/design
”Implement caching layer”/design
”Refactor the API”/design