{"id":"ca6c5018-1c97-4bf6-a33c-e9258bd87e63","shortId":"D74cNc","kind":"skill","title":"iterate-refinement-notes","tagline":"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.","description":"<!-- PM-Skills | https://github.com/product-on-purpose/pm-skills | Apache 2.0 -->\n# Refinement Notes\n\nRefinement 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.\n\n## When to Use\n\n- During refinement sessions to capture decisions in real-time\n- After refinement to share outcomes with absent team members\n- When onboarding new team members to explain backlog context\n- Before sprint planning to review what's been refined\n- When stories need re-refinement due to time elapsed\n\n## Instructions\n\nWhen asked to document refinement notes, follow these steps:\n\n1. **Record Session Metadata**\n   Note the date, attendees, and duration. This helps track who was part of decisions and when discussions happened.\n\n2. **List Stories Discussed**\n   For each story, capture the outcome: estimated points, refined status, key discussion points, and any modifications made to the original scope.\n\n3. **Document Questions Raised**\n   Questions that couldn't be answered in the session need owners and due dates. Don't let them disappear.they often block sprint planning.\n\n4. **Capture Decisions Made**\n   Record any scope decisions, technical approaches agreed upon, or priority changes. These decisions are valuable context that gets lost without documentation.\n\n5. **Note Action Items**\n   Any follow-up work needed before stories are sprint-ready: mockups to create, technical spikes to run, stakeholders to consult.\n\n6. **Flag Blocked Stories**\n   Clearly identify stories that can't proceed until blockers are resolved. Include what the blocker is and who owns resolution.\n\n7. **Plan Next Session**\n   Note what should be refined next and any preparation needed.\n\n## Output Format\n\nUse the template in `references/TEMPLATE.md` to structure the output.\n\n## Quality Checklist\n\nBefore finalizing, verify:\n\n- [ ] All discussed stories have outcomes recorded\n- [ ] Open questions have owners assigned\n- [ ] Decisions are captured with enough context\n- [ ] Blocked stories are clearly flagged\n- [ ] Notes are understandable to someone who wasn't there\n\n## Examples\n\nSee `references/EXAMPLE.md` for a completed example.","tags":["iterate","refinement","notes","skills","product-on-purpose","agent-skills","ai-skills","claude-code","claude-desktop","openskills","product-management","skill-families"],"capabilities":["skill","source-product-on-purpose","skill-iterate-refinement-notes","topic-agent-skills","topic-ai-skills","topic-claude-code","topic-claude-desktop","topic-openskills","topic-product-management","topic-skill-families","topic-triple-diamond"],"categories":["pm-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/product-on-purpose/pm-skills/iterate-refinement-notes","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add product-on-purpose/pm-skills","source_repo":"https://github.com/product-on-purpose/pm-skills","install_from":"skills.sh"}},"qualityScore":"0.538","qualityRationale":"deterministic score 0.54 from registry signals: · indexed on github topic:agent-skills · 176 github stars · SKILL.md body (2,341 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-02T12:54:12.821Z","embedding":null,"createdAt":"2026-04-18T22:09:25.624Z","updatedAt":"2026-05-02T12:54:12.821Z","lastSeenAt":"2026-05-02T12:54:12.821Z","tsv":"'1':144 '2':166 '3':191 '4':218 '5':243 '6':269 '7':293 'absent':31,103 'action':245 'agre':228 'answer':200 'approach':227 'ask':136 'assign':333 'attende':151 'backlog':6,42,113 'block':215,271,340 'blocker':281,287 'captur':25,38,91,173,219,336 'chang':232 'checklist':319 'clear':273,343 'complet':359 'consult':268 'context':114,237,339 'couldn':197 'creat':261 'date':150,208 'decis':17,53,92,161,220,225,234,334 'disappear.they':213 'discuss':47,164,169,181,324 'document':5,138,192,242 'due':130,207 'durat':153 'elaps':133 'enough':338 'estim':13,50,176 'evolv':76 'exampl':354,360 'explain':112 'final':321 'flag':270,344 'follow':141,249 'follow-up':248 'format':308 'get':239 'groom':44 'happen':165 'help':155 'histor':71 'idea':78 'identifi':274 'includ':10,284 'instruct':134 'item':246 'iter':2 'iterate-refinement-not':1 'key':180 'let':211 'list':167 'lost':240 'made':18,55,186,221 'member':33,64,105,110 'metadata':147 'miss':66 'mockup':259 'modif':185 'need':126,204,252,306 'new':108 'next':295,302 'note':4,35,37,140,148,244,297,345 'often':214 'onboard':107 'open':329 'origin':189 'outcom':9,40,101,175,327 'output':307,317 'own':291 'owner':205,332 'part':159 'plan':117,217,294 'point':177,182 'prepar':305 'prioriti':231 'proceed':279 'qualiti':318 'question':14,193,195,330 'quick':60 'rais':15,194 're':128 're-refin':127 'readi':81,258 'ready-for-sprint':80 'real':95 'real-tim':94 'record':72,145,222,328 'refer':61 'references/example.md':356 'references/template.md':313 'refin':3,7,12,23,34,36,43,88,98,123,129,139,178,301 'resolut':292 'resolv':283 'result':27 'review':119 'run':265 'scope':190,224 'see':355 'serv':57 'session':8,68,89,146,203,296 'sessions.what':45 'share':29,100 'skill' 'skill-iterate-refinement-notes' 'someon':349 'source-product-on-purpose' 'spike':263 'sprint':83,116,216,257 'sprint-readi':256 'stakehold':266 'status':179 'step':143 'stori':11,75,125,168,172,254,272,275,325,341 'structur':315 'team':32,63,104,109 'technic':226,262 'templat':311 'time':96,132 'topic-agent-skills' 'topic-ai-skills' 'topic-claude-code' 'topic-claude-desktop' 'topic-openskills' 'topic-product-management' 'topic-skill-families' 'topic-triple-diamond' 'track':156 'understand':347 'upon':229 'use':19,86,309 'valuabl':236 'verifi':322 'wasn':351 'without':241 'work':251","prices":[{"id":"762e9599-9c0f-4abb-a403-dd6d50376205","listingId":"ca6c5018-1c97-4bf6-a33c-e9258bd87e63","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"product-on-purpose","category":"pm-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T22:09:25.624Z"}],"sources":[{"listingId":"ca6c5018-1c97-4bf6-a33c-e9258bd87e63","source":"github","sourceId":"product-on-purpose/pm-skills/iterate-refinement-notes","sourceUrl":"https://github.com/product-on-purpose/pm-skills/tree/main/skills/iterate-refinement-notes","isPrimary":false,"firstSeenAt":"2026-04-18T22:09:25.624Z","lastSeenAt":"2026-05-02T12:54:12.821Z"}],"details":{"listingId":"ca6c5018-1c97-4bf6-a33c-e9258bd87e63","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"product-on-purpose","slug":"iterate-refinement-notes","github":{"repo":"product-on-purpose/pm-skills","stars":176,"topics":["agent-skills","ai-skills","claude-code","claude-desktop","openskills","product-management","skill-families","triple-diamond"],"license":"apache-2.0","html_url":"https://github.com/product-on-purpose/pm-skills","pushed_at":"2026-04-24T22:54:13Z","description":"Curated, plug-and-play product management skills for AI agents. 38 skills across Triple Diamond phases plus foundation (lean canvas, persona, meeting lifecycle family) and utility (create, validate, iterate). Templates, workflows, thread-aligned samples, CI-enforced skill-family contracts. Apache 2.0.","skill_md_sha":"69e3f434aad15572ba7bf23fab8fe7c288ba544a","skill_md_path":"skills/iterate-refinement-notes/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/product-on-purpose/pm-skills/tree/main/skills/iterate-refinement-notes"},"layout":"multi","source":"github","category":"pm-skills","frontmatter":{"name":"iterate-refinement-notes","license":"Apache-2.0","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."},"skills_sh_url":"https://skills.sh/product-on-purpose/pm-skills/iterate-refinement-notes"},"updatedAt":"2026-05-02T12:54:12.821Z"}}