🎯

refine

🎯Skill

from duc01226/easyplatform

What it does

refine skill from duc01226/easyplatform

📦

Part of

duc01226/easyplatform(87 items)

refine

Installation

📋 No install commands found in docs. Showing default command. Check GitHub for actual instructions.

Quick InstallInstall with npx

npx skills add duc01226/easyplatform --skill refine

Need more details? View full documentation on GitHub →

6Installs

Last UpdatedJan 29, 2026

View on GitHub Back to Skills

Skill Details

SKILL.md

Transform ideas into Product Backlog Items using BA best practices, hypothesis validation, and domain research. Use when converting ideas to PBIs, validating problem hypotheses, adding acceptance criteria, or refining requirements. Triggers on "create pbi", "refine idea", "convert to pbi", "acceptance criteria", "make actionable", "validate hypothesis".

Overview

# Idea Refinement to PBI

Transform captured ideas into actionable Product Backlog Items using BA best practices, Hypothesis-Driven Development, and domain research.

⚠️ MUST READ References

IMPORTANT: You MUST read these reference files for complete protocol. Do NOT skip.

⚠️ MUST READ .claude/skills/shared/team-frameworks.md — RICE, MoSCoW, INVEST, SPIDR frameworks
⚠️ MUST READ .claude/skills/shared/bdd-gherkin-templates.md — BDD/Gherkin scenario templates
⚠️ MUST READ .claude/skills/shared/module-detection-keywords.md — module detection keywords
⚠️ MUST READ references/refinement-workflow.md — detailed phases 2-8
⚠️ MUST READ references/bravosuite-workflow.md — domain context integration

When to Use

Idea artifact ready for refinement
Need to validate problem hypothesis before building
Converting concept to implementable item
Adding acceptance criteria to requirements

Workflow

| ----- | ------------------- | ---------------------------- | ---------------------- |

Phase 1: Idea Intake & Context Loading

Read idea artifact from path or find by ID in team-artifacts/ideas/
Extract: problem statement, value proposition, target users, scope
Check module field in frontmatter

If module present: Load domain context (see references/bravosuite-workflow.md)

If module absent: Run Glob("docs/business-features/*/README.md"), analyze keywords, prompt if ambiguous

Skip: Infrastructure ideas, cross-cutting concerns

Phase 5: Acceptance Criteria (BDD Format)

⚠️ MUST READ .claude/skills/shared/bdd-gherkin-templates.md for templates.

| Practice | Description |

| ------------------------- | --------------------------------- |

| Single trigger | "When" clause has ONE action |

| 3 scenarios minimum | Happy path, edge case, error case |

| No implementation details | Focus on behavior, not how |

| Testable outcomes | "Then" must be verifiable |

| Stakeholder language | No technical jargon |

Output

Path: team-artifacts/pbis/{YYMMDD}-pbi-{slug}.md
ID Pattern: PBI-{YYMMDD}-{NNN}

| Type | Reference |

| ------------------ | -------------------------------------- |

| Role Skill | business-analyst |

| Input | /idea output |

| Next Step | /story, /test-spec, /design-spec |

| Prioritization | /prioritize |

Triggers

Activates on: refine, refinement, pbi, backlog item, acceptance criteria, hypothesis, validate idea

IMPORTANT Task Planning Notes

Always plan and break many small todo tasks
Always add a final review todo task to review the works done at the end to find any fix or enhancement needed