Best Practices

Task hierarchy design:

Project (parent)
└── Feature A (child)
    ├── Component A1 (leaf task)
    │   ├── Implementation
    │   └── Tests (depends on Implementation)
    └── Component A2

Dependency management:

• Always define dependencies when creating tasks
• Use task IDs (not titles) for dependency references
• Verify dependencies with TaskGet before execution

Status transitions:

• Mark in_progress when starting work (prevents parallel execution)
• Update frequently for visibility
• Only mark completed when fully accomplished (tests passing, validated)
• Use failed status with error metadata for debugging

Metadata conventions:

{
  "priority": "high|medium|low",
  "estimated_duration": "2h",
  "related_files": ["path/to/file.ts"],
  "related_issue": "https://github.com/org/repo/issues/123",
  "type": "feature|bugfix|refactor|test"
}