Skip to content

Commit 8f94a26

Browse files
emcdclaude
andcommitted
Improve Claude slash commands based on field test feedback.
Enhance workflow monitoring with explicit success criteria: - Replace timeout messages with CRITICAL warnings - Add explicit "✓ completed with 'success'" requirement - Emphasize halting on failures for user consultation Add patch commit identification guidance: - Distinguish bug fixes vs maintenance commits - Add git visualization commands for better commit review - Guide decision-making for cherry-pick selection Strengthen verification steps before release deployment. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 9d961b0 commit 8f94a26

2 files changed

Lines changed: 42 additions & 6 deletions

File tree

template/.auxiliary/configuration/claude/commands/release-final.md

Lines changed: 11 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -116,18 +116,26 @@ git push [-u] origin release-$ARGUMENTS
116116
gh run list --workflow=qa --limit=1
117117
gh run watch <qa-run-id> --interval 30 --compact
118118
```
119-
**Halt if any QA jobs fail.** If `gh run watch` times out, rerun it until workflow completion.
119+
**CRITICAL - DO NOT PROCEED UNTIL WORKFLOW COMPLETES:**
120+
- Monitor QA workflow with `gh run watch`
121+
- If command times out, immediately rerun `gh run watch` until completion
122+
- Only proceed to next step after seeing "✓ [workflow-name] completed with 'success'"
123+
- HALT if any jobs fail - consult user before proceeding
120124

121125
### 6. Release Deployment
122-
After QA passes, tag and monitor release:
126+
**Verify QA passed before proceeding to release tag:**
123127
```bash
124128
git tag -m "Release v$(hatch version): <brief-description>." v$(hatch version)
125129
git push --tags
126130

127131
gh run list --workflow=release --limit=1
128132
gh run watch <release-run-id> --interval 30 --compact
129133
```
130-
**Halt if release workflow fails.** If `gh run watch` times out, rerun it until workflow completion.
134+
**CRITICAL - DO NOT PROCEED UNTIL WORKFLOW COMPLETES:**
135+
- Monitor release workflow with `gh run watch`
136+
- If command times out, immediately rerun `gh run watch` until completion
137+
- Only proceed to next step after seeing "✓ [workflow-name] completed with 'success'"
138+
- HALT if any jobs fail - consult user before proceeding
131139

132140
### 7. Post-Release Cleanup
133141
```bash

template/.auxiliary/configuration/claude/commands/release-patch.md

Lines changed: 31 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -84,6 +84,26 @@ git pull origin release-$ARGUMENTS
8484
### 3. Patch Integration
8585
**Determine patch location and integrate if needed:**
8686

87+
### 3.1. Identify Patch Commits
88+
Before cherry-picking, identify which commits contain actual patch fixes vs. maintenance:
89+
90+
```bash
91+
git log --oneline master
92+
git log --graph --oneline master --since="1 month ago"
93+
```
94+
95+
**Patch commits** (always cherry-pick):
96+
- Bug fixes
97+
- Security patches
98+
- Critical functionality fixes
99+
100+
**Maintenance commits** (evaluate case-by-case):
101+
- Template updates
102+
- Dependency bumps
103+
- Documentation changes
104+
105+
Use `git show <commit>` to review each commit's content before deciding.
106+
87107
**If patches were developed on master** (cherry-pick to release branch):
88108
```bash
89109
# Cherry-pick patch commits from master to release branch
@@ -117,18 +137,26 @@ git push origin release-$ARGUMENTS
117137
gh run list --workflow=qa --limit=1
118138
gh run watch <qa-run-id> --interval 30 --compact
119139
```
120-
**Halt if any QA jobs fail.** If `gh run watch` times out, rerun it until workflow completion.
140+
**CRITICAL - DO NOT PROCEED UNTIL WORKFLOW COMPLETES:**
141+
- Monitor QA workflow with `gh run watch`
142+
- If command times out, immediately rerun `gh run watch` until completion
143+
- Only proceed to next step after seeing "✓ [workflow-name] completed with 'success'"
144+
- HALT if any jobs fail - consult user before proceeding
121145

122146
### 7. Release Deployment
123-
After QA passes, tag and monitor release:
147+
**Verify QA passed before proceeding to release tag:**
124148
```bash
125149
git tag -m "Release v$(hatch version) patch: <brief-description>." v$(hatch version)
126150
git push --tags
127151

128152
gh run list --workflow=release --limit=1
129153
gh run watch <release-run-id> --interval 30 --compact
130154
```
131-
**Halt if release workflow fails.** If `gh run watch` times out, rerun it until workflow completion.
155+
**CRITICAL - DO NOT PROCEED UNTIL WORKFLOW COMPLETES:**
156+
- Monitor release workflow with `gh run watch`
157+
- If command times out, immediately rerun `gh run watch` until completion
158+
- Only proceed to next step after seeing "✓ [workflow-name] completed with 'success'"
159+
- HALT if any jobs fail - consult user before proceeding
132160

133161
### 8. Post-Release Cleanup
134162
```bash

0 commit comments

Comments
 (0)