github-task-start.template

Codex Runtime Compatibility

This prompt was authored for Claude-style slash workflows. In Codex runtime, adapt tool calls as follows:

• AskUserQuestion => ask the user directly in chat.
• WebSearch/WebFetch => use available web tools (search_query, open, find) and cite links.
• Read/Write => use shell/filesystem tools in this workspace.
• Claude-only MCP calls (for example Playwright MCP names) => use available equivalents or clearly state fallback.
• Keep intent and output format identical; only adapt execution mechanics.

---

description: Start or complete a task from GitHub Project Board model: sonnet

/github-task-start - Start GitHub Task

Start working on a task from your GitHub Project Board or mark it complete.

{{#if versionControl.projectBoard.number}}

Usage

/github-task-start <issue-number>           # Start working on issue
/github-task-start <issue-number> --complete # Complete the issue

Workflow

Starting a Task

1. Fetch Issue Details

   gh issue view <number> --repo {{versionControl.owner}}/{{versionControl.repo}} --json title,body,labels,assignees
   

2. Create Branch (optional)

   git checkout -b feature/<issue-number>-<slug>
   

3. Update Project Board Status

   # Move to "In Progress" status
   gh project item-edit --id <item-id> --project-id {{versionControl.projectBoard.id}} --field-id <status-field-id> --single-select-option-id <in-progress-id>
   

4. Create Task List

   • Analyze issue requirements
   • Create TodoWrite tasks based on acceptance criteria
   • Begin implementation

Completing a Task

1. Verify All Tests Pass

   {{#if testing.e2e.testCommand}}
   {{testing.e2e.testCommand}}
   {{else}}
   npm test
   {{/if}}
   

2. Create Commit

   git add .
   git commit -m "feat: <description>
   
   Closes #<issue-number>"
   

3. Create PR

   gh pr create --title "<title>" --body "Closes #<issue-number>" --repo {{versionControl.owner}}/{{versionControl.repo}}