agile-8-refinement

Orchestrate 3-Amigos refinement sessions to clarify Jira stories and update fields via API.

Updated May 16, 2026
One-click install
npx skills add https://github.com/cedricfarinazzo/agile-skills --skill agile-8-refinement
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agile-8-refinement
Source: https://github.com/cedricfarinazzo/agile-skills/tree/main/agile-planning/skills/agile-8-refinement
Command: npx skills add https://github.com/cedricfarinazzo/agile-skills --skill agile-8-refinement

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, jq, python3, and includes scripts (resource) components.

What problem does it solve?

Automates and standardizes the 3-amigos refinement session to turn vague Jira stories into well-scoped, actionable items ready for estimation and sprint planning.

Core Features & Use Cases

  • Facilitates PM lens to validate value and scope for each story.
  • Enables Tech Lead lens to surface dependencies, feasibility, and complexity for reliable estimation.
  • Supports QA lens to specify testability, edge cases, and acceptance criteria.
  • Applies a readiness gate ensuring story readiness before sprint planning (AC, DoD, specs link, dependencies, and points).

Quick Start

Initiate a refinement run against the target Epic/sprint backlog, apply PM/Tech/QA lenses to each story, update AC/DoD and story points in Jira, and append a dated refinement note.

Frequently Asked Questions about agile-8-refinement

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate agile backlog refinement for vague Jira stories?

Automate agile backlog refinement by orchestrating a 3-Amigos session to clarify Jira stories, defining value, feasibility, and testability to turn vague items into actionable, ready-to-estimate stories.

What is the best way to structure a 3-Amigos session for sprint planning?

Structure a 3-Amigos session by applying PM, Tech Lead, and QA lenses to define story value, dependencies, and acceptance criteria, ensuring backlog items pass a readiness gate before sprint planning.

Can I automatically update Jira story points and acceptance criteria via API?

Yes, you can update Jira story points and acceptance criteria via API; the refinement process automatically updates Jira fields, adds a refined label, and appends a dated refinement note to each story.

How do I check backlog readiness before sprint planning in Jira?

Check backlog readiness by applying a readiness gate that verifies each Jira story has defined acceptance criteria, a Definition of Done, linked specs, mapped dependencies, and assigned story points.

Do I need curl and jq to run automated Jira refinement sessions?

Yes, curl and jq are required dependencies, along with python3, to execute the scripts that interact with the Jira API and process backlog items during the refinement session.

How do I detect cross-story collisions during backlog refinement?

Detect cross-story collisions by optionally running a shared-file audit during the refinement process, which surfaces overlapping dependencies or conflicts across multiple backlog items in the target Epic.