Skip to content

feat(skills): refresh issue and PR descriptions after post-creation changes - #18

Merged
robertraf merged 1 commit into
mainfrom
claude/refresh-issue-pr-descriptions-guzfe
Mar 24, 2026
Merged

feat(skills): refresh issue and PR descriptions after post-creation changes#18
robertraf merged 1 commit into
mainfrom
claude/refresh-issue-pr-descriptions-guzfe

Conversation

@robertraf

Copy link
Copy Markdown
Owner

Summary

Issue and PR descriptions become stale when implementation deviates from the original plan or when review feedback triggers additional commits after PR creation. This adds refresh steps throughout the SDD pipeline to keep descriptions current.

What changed

  • skills/implement/SKILL.md: Added Step 6 — refresh the GitHub issue description after all tasks are implemented (mark completed tasks, update deviations, add new files)
  • skills/ship/SKILL.md: Made Step 6 (issue refresh) mandatory instead of optional view-only; added Step 8 to refresh PR description when post-creation commits are pushed
  • skills/sdd/SKILL.md: Updated Phase 4 and Phase 6 gates to include description refresh; added gotcha about stale descriptions

How to test

  1. Run /tasks to create an issue, then /implement — verify Step 6 prompts to refresh the issue description
  2. Run /ship — verify Step 6 updates the issue and Step 8 is available for post-PR updates
  3. Run /sdd end-to-end — verify Phase 4 and Phase 6 gates mention description refresh

Breaking changes

None — existing workflow steps are preserved; new steps are additive.

References

https://claude.ai/code/session_018115ANUK8M1Lw271YcY9uV

…n changes

Issue descriptions created by /tasks and PR descriptions created by /ship
become stale when implementation deviates from the plan or review feedback
triggers additional commits. This adds refresh steps to keep them current:

- /implement Step 6: refresh issue description after implementation completes
- /ship Step 6: mandatory issue refresh with final state (was optional view-only)
- /ship Step 8: refresh PR description when post-creation commits are pushed
- /sdd: orchestrate refreshes at Phase 4 and Phase 6 transitions

https://claude.ai/code/session_018115ANUK8M1Lw271YcY9uV
@robertraf
robertraf merged commit 0175042 into main Mar 24, 2026
1 check passed
@robertraf
robertraf deleted the claude/refresh-issue-pr-descriptions-guzfe branch March 24, 2026 05:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants