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.