Skip to content

Commit b2aa594

Browse files
committed
fix(procedures): document actual workflow mechanics
- Labels are auto-assigned by GitHub Action, not manual - Add post-merge workflow steps (the manual process we actually follow) - Strengthen planning mode recommendation as default for all users These changes reflect reality vs aspiration. Principle: systems-stewardship
1 parent 676a401 commit b2aa594

1 file changed

Lines changed: 20 additions & 4 deletions

File tree

knowledge/procedures/issue-to-pr-workflow.md

Lines changed: 20 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -13,9 +13,9 @@ GitHub Issue → Planning Mode → Implementation → Pull Request → Review
1313
### 1. GitHub Issue Defines the Work
1414

1515
Every task starts as a GitHub issue:
16-
- Clear problem statement
16+
- Clear problem statement
1717
- Success criteria defined
18-
- Labels indicate type (bug, feature, spike)
18+
- Labels automatically assigned by Claude Code GitHub Action based on principles
1919

2020
**Anti-pattern**: Starting work without an issue leads to scope creep and unclear PRs.
2121

@@ -59,7 +59,21 @@ PR review happens at the right altitude:
5959
- Verify it solves the original issue
6060
- Merge when approved
6161

62-
### 6. Optional: Post-PR Retro
62+
### 6. Post-Merge Workflow
63+
64+
After merging via GitHub UI:
65+
1. Exit Claude Code
66+
2. `git checkout main`
67+
3. `git pull origin main`
68+
4. `source setup.sh`
69+
5. Start new terminal session
70+
6. Restart Claude Code:
71+
- Resume last chat for context continuity
72+
- Or start fresh for new work
73+
74+
**Note**: This manual process ensures clean environment and updated configurations.
75+
76+
### 7. Optional: Post-PR Retro
6377

6478
For significant work:
6579
- Run [post-PR mini retro](post-pr-mini-retro.md)
@@ -75,14 +89,16 @@ For significant work:
7589

7690
## Configuration
7791

78-
Enable planning mode by default:
92+
Planning mode should be enabled by default for all users:
7993
```bash
8094
# In ~/.claude/settings.json
8195
{
8296
"defaultMode": "plan"
8397
}
8498
```
8599

100+
**Recommendation**: Add this to your `setup.sh` or dotfiles to ensure all team members start with planning mode enabled. This enforces OSE principles from day one.
101+
86102
## Related
87103

88104
- [tmux + git worktrees + Claude Code + Planning Mode](tmux-git-worktrees-claude-code.md) - The complete productivity system

0 commit comments

Comments
 (0)