github-issue-workflowlisted

# GitHub Issue Workflow End-to-end workflow for creating a GitHub issue and immediately setting up for implementation. ## Workflow ### 1. Create the issue Use `gh issue create` with a structured body: ```bash gh issue create --title "Short descriptive title" --body "$(cat <<'EOF' ## Summary Brief description of the feature/bug. ## Implementation Plan ### Phase A: Design (ADR if needed) ### Phase B: Implementation ### Phase C: Testing & PR ## Acceptance Criteria - [ ] Criterion 1 - [ ] Criterion 2 ## Labels enhancement, area: core, ... EOF )" --label "enhancement" --label "area: core" ``` ### 2. Assign the issue Always assign to the project owner immediately: ```bash gh issue edit {number} --add-assignee jeanibarz ``` ### 3. Create a worktree branch Use `EnterWorktree` with a descriptive name matching the feature: ``` EnterWorktree(name: "feat-short-description") ``` **Name rules:** letters, digits, dots, underscores, dashes only. No `+` or `/`. ### 4. Implement Follow the issue's implementation plan: 1. Write ADR if `needs adr` label is present 2. Implement the feature 3. Write tests 4. Run [[pre-push]] 5. Create PR into `staging`, then run [[post-push]] ### 5. Create PR into staging ```bash gh pr create --base staging --title "feat: short description" --body "$(cat <<'EOF' ## Summary - What was done ## Test plan - [ ] Tests pass - [ ] Manual verification Closes #N 🤖 Generated with [Claude Code](https://claude.com/claude-code) EOF )" ``` ### 6. Update