tomevault-io 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:
gh issue view [number] --repo pocketpal-ai/pocketpal-ai --json title,body,labels,assignees
Then use the pocketpal-orchestrator agent with the issue context:
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:
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 (standard/complex)
- Route to planner with worktree context
After the planner creates a story file, the story critic reviews it automatically. Implementation proceeds if the critic approves (LGTM). Human is only involved if blockers persist after revision.
Workflow
/start-task → orchestrator → planner → critic (review-revise) → implementer → tester → reviewer → PR
Converted and distributed by TomeVault — claim your Tome and manage your conversions.