You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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
- Labels automatically assigned by Claude Code GitHub Action based on principles
19
19
20
20
**Anti-pattern**: Starting work without an issue leads to scope creep and unclear PRs.
21
21
@@ -59,7 +59,21 @@ PR review happens at the right altitude:
59
59
- Verify it solves the original issue
60
60
- Merge when approved
61
61
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
63
77
64
78
For significant work:
65
79
- Run [post-PR mini retro](post-pr-mini-retro.md)
@@ -75,14 +89,16 @@ For significant work:
75
89
76
90
## Configuration
77
91
78
-
Enable planning mode by default:
92
+
Planning mode should be enabled by default for all users:
79
93
```bash
80
94
# In ~/.claude/settings.json
81
95
{
82
96
"defaultMode": "plan"
83
97
}
84
98
```
85
99
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
+
86
102
## Related
87
103
88
104
-[tmux + git worktrees + Claude Code + Planning Mode](tmux-git-worktrees-claude-code.md) - The complete productivity system
0 commit comments