ga - Start a New Task

Kick off a new parallel development task. Creates a clone, branch, tmux session, and starts Pi with a crafted prompt.

Steps

1. Get the task description from the user's message. If unclear, ask what they want to build or fix.

2. Generate a concise branch name from the description:

   • Use lowercase kebab-case
   • Max 3-4 words, abbreviate aggressively
   • Prefix with fix- for bug fixes
   • Examples:
     • "the login button doesn't work on mobile" → fix-mobile-login-btn
     • "add a dark mode toggle to settings" → dark-mode-toggle
     • "search results are slow when filtering by date" → fix-search-date-perf
     • "implement rate limiting on the API" → api-rate-limit
     • "the sidebar collapses when resizing" → fix-sidebar-resize
     • "add webhook support for deployments" → deploy-webhooks

3. Build the prompt that Pi will receive in the new session. The prompt MUST follow this structure:

   <Clear description of the problem or feature>
   
   <Any relevant context: file paths, error messages, specific behavior>
   
   When you're done, run /create-draft-pr to commit, push, and open a draft PR.
   

   Keep the prompt direct and actionable. Don't over-explain. Include specific file paths or error details if the user mentioned them.

4. Pick the harness. Default is pi, so omit the flag for normal use. If the user's message explicitly asks for Claude Code (e.g. "use claude", "with claude", "claude harness"), pass --harness c.