Skip to content

CLAUDE.md

Latest commit

 

History

History
71 lines (52 loc) · 2.58 KB

CLAUDE.md

File metadata and controls

71 lines (52 loc) · 2.58 KB

Claude Code Task Management Guide

Documentation Available

📚 Project Documentation: Check the documentation files in this directory for project-specific setup instructions and guides. Project Tasks: Check the tasks directory in documentation/tasks for the list of tasks to be completed. Use the CLI commands below to interact with them.

MANDATORY Task Management Workflow

🚨 YOU MUST FOLLOW THIS EXACT WORKFLOW - NO EXCEPTIONS 🚨

STEP 1: DISCOVER TASKS (MANDATORY)

You MUST start by running this command to see all available tasks:

task-manager list-tasks

STEP 2: START EACH TASK (MANDATORY)

Before working on any task, you MUST mark it as started:

task-manager start-task <task_id>

STEP 3: COMPLETE EACH TASK (MANDATORY)

After finishing implementation, you MUST mark the task as completed:

task-manager complete-task <task_id> "Brief description of what was implemented"

Task Files Location

📁 Task Data: Your tasks are organized in the documentation/tasks/ directory:

  • Task JSON files contain complete task information
  • Use ONLY the task-manager commands listed above
  • Follow the mandatory workflow sequence for each task

MANDATORY Task Workflow Sequence

🔄 For EACH individual task, you MUST follow this sequence:

  1. 📋 DISCOVER: task-manager list-tasks (first time only)
  2. 🚀 START: task-manager start-task <task_id> (mark as in progress)
  3. 💻 IMPLEMENT: Do the actual coding/implementation work
  4. ✅ COMPLETE: task-manager complete-task <task_id> "What was done"
  5. 🔁 REPEAT: Go to next task (start from step 2)

Task Status Options

  • pending - Ready to work on
  • in_progress - Currently being worked on
  • completed - Successfully finished
  • blocked - Cannot proceed (waiting for dependencies)
  • cancelled - No longer needed

CRITICAL WORKFLOW RULES

❌ NEVER skip the task-manager start-task command ❌ NEVER skip the task-manager complete-task command
❌ NEVER work on multiple tasks simultaneously ✅ ALWAYS complete one task fully before starting the next ✅ ALWAYS provide completion details in the complete command ✅ ALWAYS follow the exact 3-step sequence: list → start → complete

Final Requirements

🚨 CRITICAL: Your work is not complete until you have:

  1. ✅ Completed ALL tasks using the mandatory workflow
  2. ✅ Committed all changes with comprehensive commit messages
  3. ✅ Created a pull request with proper description

Remember: The task management workflow is MANDATORY, not optional!