Issue Refiner — Development agent for Claude Code
Enriches issues with acceptance criteria, edge cases, technical considerations, and NFRs.
How to install Issue Refiner
Installs to ~/.claude/agents/nodejsmith-claudefiles-issue-refiner.md
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/NodeJSmith/Claudefiles/HEAD/agents/issue-refiner.md -o ~/.claude/agents/nodejsmith-claudefiles-issue-refiner.md Restart Claude Code, or start a new session, for it to be picked up.
What Issue Refiner does
name: issue-refiner model: sonnet # claude-sonnet-5 as of 2026-07-07 effort: medium description: Enriches issues with acceptance criteria, edge cases, technical considerations, and NFRs. Use before assigning work or when an issue lacks sufficient detail. tools: ["Read", "Write", "Edit", "Bash", "Grep", "Glob"] bundle: base
You are an expert product engineer who specializes in refining vague or incomplete issues into actionable, well-structured work items.
When Invoked
You receive
Alternatives in Development
- Gitnexus Docs Dod Reviewer — GitNexus docs and Definition-of-Done reviewer 45.8k ★
- PRD Reviewer — Review a PRD and flag missing acceptance criteria, edge cases, and 135 ★
- Deferral Drafter — PRFlow's implement-phase Deferral-Drafter agent 115 ★
Full documentation available on GitHub
View Source RepositoryRelated Agents
Loom Curator
Loom Curator - Issue enhancement specialist that enriches unlabeled issues with technical details, acceptance
Requirements Engineer
Refines feature ideas into detailed specs with user stories, acceptance criteria, and edge cases. Does NOT wri
Requirements Agent
Surfaces ambiguities, missing edge cases, and undefined behaviors before development begins. Produces a Featur
Harden Issues Attacker
Attacks the acceptance criteria of ONE issue file before anyone builds to it, for the /harden-issues skill. Sh
GitHub Issue Handler
Batch inventory of the GitHub issues assigned to the user. Use it to fetch assigned issues across repos and su
PM Reviewer
Product Manager reviewer agent. Reviews PRDs, acceptance criteria, and feature requirements for completeness a
Related Skills
Cfn Spec
SPARC Specification phase. Make testable acceptance criteria, edge cases, pre/post conditions, invariants BEFO
Ac Validation
Review Acceptance Criteria for one or more user stories against completeness and quality standards. Checks hap
Spec Specify
Phase 1 — Creates the detailed technical specification of a feature: functional requirements, non-functional r