Skip to content

rfe-split

Decomposes an oversized work item into right-sized children that together cover the original scope. It takes IDs already in the workspace — fetched by /rfe-review or written by /rfe-create — and skips any ID with no local task file.

It runs non-interactively. A split agent per parent applies the type's own decomposition rules ({SPLIT_RULES_PATH}) and writes {REVIEWS_DIR}/<ID>-split-status.yaml; a parent whose status says no-split (delivery-coupled, say) has its recommendation set back to revise so downstream consumers don't keep treating it as pending. Children are collected and handed to /rfe-review as an inline headless call.

One self-correction cycle follows: any child scoring below the type's resplit.below threshold on right_sized (right_sized < 2 for both shipped types) is split again and its children reviewed. It stops there by design — repeated re-splitting compounds the child count for diminishing returns, so a decomposition still wrong after one correction needs human judgement. The loop corrects grouping mistakes only; every other criterion is /rfe-review's auto-revision to fix.

Plugin: rfe-creator | User-invocable

Contract

Skill Contract canonical-skill-v1

Decompose an oversized work item of the resolved type into right-sized children that together cover the original scope.

Identity

Functions
transform
Success
  • Decomposes an oversized item into right-sized children that cover all of the original scope.
  • Reviews the children through /rfe-review and archives the parent.

Optimization Targets

task_success judge SKILL.md @ c6eb99d

Invariants

Must Preserve
  • Preserve full coverage of the original scope across the children.
  • Limit right-sizing self-correction to one cycle, and re-split only for right-sizing.
Fixed Context
toolsGlob, Bash, Agent, Skill, AskUserQuestion
clipython3
knowledgerepository_contentpublic, task_inputtask_private, tool_outputtask_private

Traceability

Skill
.claude/skills/rfe-split/SKILL.md
Supporting

Diagram

rfe-split diagram

Arguments

/rfe-split [--type <t>] [--headless] <ID> [ID2 ...]
Argument Required Default Description
ID - One or more space-separated IDs of items already in the workspace. An ID with no local task file is reported and skipped.
--type rfe Work-item type to split. An explicit --type always wins.
--headless - Suppress the end-of-run summary and emit a completion marker instead.

Usage

/rfe-split RHAIRFE-1234
/rfe-split RHAIRFE-1234 RHAIRFE-5678
/rfe-split --type initiative INIT-001