Task Workflow Manager

Purpose

Manage complete task lifecycle from initial definition through implementation to review and completion. Provides state-based workflow with automated transitions, intelligent task discovery, quality gates, and framework-aware implementation patterns.

Tip: For smoother workflow without permission prompts, consider adding ["Read", "Write", "Edit", "Glob", "Bash", "TodoWrite"] to dangerouslySkipPermissions in your project's .claude/settings.json.

Variables

TASK_ID_PREFIX: TASK # Project prefix for task IDs (TASK, BROOKLY, JIRA, etc.) TASK_ID_START: 1 # Starting number for new task sequences TASK_ID_PADDING: 3 # Number of digits for task IDs (3 = 001, 006, 042) TASK_DIR: ./tasks # Directory where task files are stored TASK_FILE_FORMAT: {prefix}-{id} [{state}] ({category}): {slug}.md # Filename template

STATE_INITIAL: toRefine # First state after task creation STATE_READY: toImplement # Requirements refined, ready for coding STATE_REVIEW: toReview # Implementation complete, needs review STATE_COMPLETE: done # Fully finished and approved

ENABLE_LINT: true # Run linting during implement/review workflows ENABLE_TYPECHECK: true # Run type checking validation ENABLE_BUILD: true # Run build verification ENABLE_TESTS: true # Run test suite execution ENABLE_SECURITY_SCAN: false # Run security vulnerability scanning

AUTO_DETECT_FRAMEWORK: true # Automatically detect project framework DEFAULT_FRAMEWORK: generic # Fallback framework if detection fails SUPPORTED_FRAMEWORKS: generic, nextjs, django, react, python # Currently supported

COMMIT_STYLE: conventional # Commit message convention (conventional, angular, custom)

Workflow

1. Parse User Request

   • Identify workflow command intent from user input
   • Commands: "define task", "refine task", "implement task", "review task"
   • Extract task identifier if provided (ID, keywords, category)
   • Example: "define task: add user authentication" → Intent: define, Description: "add user authentication"

2. Determine Workflow Phase

   • IF: "define" OR "create" OR "new task" → Route to Define workflow
   • IF: "refine" OR "clarify" OR "interview" → Route to Refine workflow
   • IF: "implement" OR "code" OR "build" → Route to Implement workflow
   • IF: "review" OR "check" OR "validate" → Route to Review workflow
   • Example: "refine task 006" → Phase: refine, Task ID: 006

3. Detect Project Framework

   • IF: AUTO_DETECT_FRAMEWORK is true → Scan for framework indicators
   • Check for: package.json (Node.js), requirements.txt (Python), go.mod (Go)
   • Analyze dependencies and config files to determine specific framework
   • Example: package.json with "next" dependency → Framework: nextjs

4. Route to Cookbook

   • Based on workflow phase and detected framework
   • Define workflow: cookbook/define.md (framework-agnostic)
   • Refine workflow: cookbook/refine.md (framework-agnostic)
   • Implement workflow: cookbook/implement/{framework}.md (e.g., generic.md, nextjs.md)
   • Review workflow: cookbook/review/{framework}.md (e.g., generic.md, nextjs.md)
   • Example: Phase=implement + Framework=nextjs → cookbook/implement/nextjs.md

5. Execute Workflow

   • Load appropriate cookbook workflow
   • Follow workflow steps with current Variables configuration
   • Use TASK_DIR, TASK_ID_PREFIX, and other Variables throughout
   • Apply quality gates if ENABLE_* variables are true
   • Example: Execute implement workflow using TASK-006, run lint+typecheck+build+test

6. Report Results

   • Summarize workflow execution
   • Show task state transitions (if applicable)
   • List files created/modified
   • Display next steps in workflow
   • Example: "Task TASK-006 transitioned from [toImplement] to [toReview]. Run review workflow next."

Cookbook

Define Task Workflow

• IF: User wants to create new task specification
• THEN: Read and execute: .claude/skills/task-workflow/cookbook/define.md
• EXAMPLES:
  • "define task: add user authentication"
  • "create new task for fixing navigation bug"
  • "new task: implement dark mode"

Refine Task Workflow

• IF: User wants to clarify task requirements
• THEN: Read and execute: .claude/skills/task-workflow/cookbook/refine.md
• EXAMPLES:
  • "refine task 006"
  • "clarify requirements for TASK-006"
  • "interview me about the authentication task"

Implement Task Workflow

• IF: User wants to implement task
• THEN: Detect framework, Read and execute: .claude/skills/task-workflow/cookbook/implement/{framework}.md
• Framework detection: generic (default), nextjs, django, react, python
• EXAMPLES:
  • "implement task 006" → cookbook/implement/generic.md (default)
  • "implement task 006" (in Next.js project) → cookbook/implement/nextjs.md
  • "build TASK-006" → framework-aware routing

Review Task Workflow

• IF: User wants to review task
• THEN: Detect framework, Read and execute: .claude/skills/task-workflow/cookbook/review/{framework}.md
• Framework detection: generic (default), nextjs, django, react, python
• EXAMPLES:
  • "review task 006" → cookbook/review/generic.md (default)
  • "review task 006" (in Next.js project) → cookbook/review/nextjs.md
  • "validate TASK-006" → framework-aware routing