Start Task Workflow
You are starting a new development task for PocketPal AI.
Input
Task: $ARGUMENTS
Determine Input Type
Check if the input is:
- •GitHub Issue: Starts with
#followed by a number (e.g.,#123,#456) - •Description: Any other text (e.g., "Add dark mode toggle")
For GitHub Issue (e.g., #123)
First, fetch the issue details:
bash
gh issue view [number] --repo pocketpal-ai/pocketpal-ai --json title,body,labels,assignees
Then use the pocketpal-orchestrator agent with the issue context:
code
Use pocketpal-orchestrator to analyze GitHub issue #[number] Issue Title: [title from gh] Issue Body: [body from gh] Labels: [labels from gh] Repository: ./repos/pocketpal-ai
For Description
Use the pocketpal-orchestrator agent directly:
code
Use pocketpal-orchestrator: $ARGUMENTS Repository: ./repos/pocketpal-ai
What Happens Next
The orchestrator will:
- •Generate a task ID (TASK-YYYYMMDD-HHMM)
- •Create a worktree at
worktrees/TASK-xxx - •Create a feature branch
- •Copy secrets/env files
- •Classify complexity (quick/standard/complex)
- •Route to planner with worktree context
After the planner creates a story file, you'll be asked to approve before implementation begins.
Workflow
code
/start-task → orchestrator → planner → [HUMAN APPROVAL] → implementer → tester → reviewer → PR