ralph-tasks

<quick_start>

/ralph-tasks setup                           # Initialize in project
/ralph-tasks add Add authentication          # Add task (quotes optional)
/ralph-tasks add Add dark mode -s            # Add with context search
/ralph-tasks add Fix bug --search            # Same with --search
/ralph-tasks list                            # List all tasks
/ralph-tasks remove 1                        # Remove task #1
/ralph-tasks wake-up                         # Show loop command

Multi-task: Add multiple tasks in one message - they're processed in parallel. </quick_start>

Aliases: add tasks, add task, list tasks, remove task

<file_structure>

{project}/.claude/ralph-tasks/
├── tasks.json       # Task queue
├── wake-up.sh       # Main loop script
├── prompt.md        # Agent instructions
└── progress.txt     # Accumulated learnings

</file_structure>

<entry_point> FIRST ACTION: Load steps/action-init.md

This step parses the command and routes to the appropriate action file. </entry_point>

<action_files>

<state_variables>

<critical_rules> 🛑 NEVER run wake-up.sh automatically - user must run it themselves 🛑 NEVER modify tasks.json without proper JSON handling (use jq) ✅ ALWAYS use atomic file updates (write to tmp, then mv) ✅ ALWAYS load only the current action file (progressive disclosure) </critical_rules>

<success_criteria> ✅ Commands parsed correctly and routed to action files ✅ Each action executes its specific task ✅ Progressive loading minimizes context usage </success_criteria>