Claude-skill-registry iterate-refinement-notes
<!-- PM-Skills | https://github.com/product-on-purpose/pm-skills | Apache 2.0 -->
git clone https://github.com/majiayu000/claude-skill-registry
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/iterate-refinement-notes" ~/.claude/skills/majiayu000-claude-skill-registry-iterate-refinement-notes && rm -rf "$T"
skills/data/iterate-refinement-notes/SKILL.mdname: iterate-refinement-notes description: Documents backlog refinement session outcomes including stories refined, estimates, questions raised, and decisions made. Use during or after refinement to capture the results and share with absent team members. phase: iterate version: "2.0.0" updated: 2026-01-26 license: Apache-2.0 metadata: category: coordination frameworks: [triple-diamond, lean-startup, design-thinking] author: product-on-purpose
Refinement Notes
Refinement notes capture the outcomes of backlog refinement (grooming) sessions—what was discussed, what was estimated, and what decisions were made. They serve as a quick reference for team members who missed the session and a historical record of how stories evolved from idea to ready-for-sprint.
When to Use
- During refinement sessions to capture decisions in real-time
- After refinement to share outcomes with absent team members
- When onboarding new team members to explain backlog context
- Before sprint planning to review what's been refined
- When stories need re-refinement due to time elapsed
Instructions
When asked to document refinement notes, follow these steps:
-
Record Session Metadata Note the date, attendees, and duration. This helps track who was part of decisions and when discussions happened.
-
List Stories Discussed For each story, capture the outcome: estimated points, refined status, key discussion points, and any modifications made to the original scope.
-
Document Questions Raised Questions that couldn't be answered in the session need owners and due dates. Don't let them disappear—they often block sprint planning.
-
Capture Decisions Made Record any scope decisions, technical approaches agreed upon, or priority changes. These decisions are valuable context that gets lost without documentation.
-
Note Action Items Any follow-up work needed before stories are sprint-ready: mockups to create, technical spikes to run, stakeholders to consult.
-
Flag Blocked Stories Clearly identify stories that can't proceed until blockers are resolved. Include what the blocker is and who owns resolution.
-
Plan Next Session Note what should be refined next and any preparation needed.
Output Format
Use the template in
references/TEMPLATE.md to structure the output.
Quality Checklist
Before finalizing, verify:
- All discussed stories have outcomes recorded
- Open questions have owners assigned
- Decisions are captured with enough context
- Blocked stories are clearly flagged
- Notes are understandable to someone who wasn't there
Examples
See
references/EXAMPLE.md for a completed example.