work-issue

Start working on a GitHub issue. Fetches the issue details, creates a properly named branch, reads project context from chalk.json, and sets up a todo list for implementation.

Workflow

1. Fetch issue details — Use gh issue view <number> --json title,body,labels,assignees,milestone to get the full issue context.

2. Read project context — If .chalk/chalk.json exists, read it to understand:

   • sourceLayout — where to create/modify files
   • routes — which pages might be affected
   • project.framework — framework-specific patterns to follow
   • dev.command — how to run the project for testing

3. Create a branch — Name it based on the issue:

   • Feature: feat/<issue-number>-<short-description>
   • Bug fix: fix/<issue-number>-<short-description>
   • Chore: chore/<issue-number>-<short-description>
   • Derive the type from issue labels (bug → fix, enhancement → feat, default → feat)
   • Keep the description to 3-5 kebab-case words from the issue title