task-refinement

Analyze BR tasks for edge cases and vague criteria before implementation.

Updated Mar 6, 2026
One-click install
npx skills add https://github.com/sQVe/cape --skill task-refinement-sqve
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: task-refinement
Source: https://github.com/sQVe/cape/tree/main/skills/task-refinement
Command: npx skills add https://github.com/sQVe/cape --skill task-refinement-sqve

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Review a single br task with SRE-level scrutiny: surface missing edge cases, vague success criteria, implicit assumptions, unspecified failure modes, and stale file references. Then refine the task to close every gap found.

Core Features & Use Cases

  • Surface edge cases, vague criteria, implicit assumptions, and failure modes.
  • Tighten criteria to be concrete, testable, and aligned with epic goals.
  • Verify the task against the actual codebase using codebase-investigator and produce a structured refinement report.
  • Use during transition from planning to execution to ensure readiness.

Quick Start

Identify the next ready br task with br ready and initiate the refinement workflow using cape br design <task-id> 'Refinement (task-refinement)'.

Frequently Asked Questions about task-refinement

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

FAQPage Schema
How do I refine a br task to surface edge cases and implicit assumptions?

To refine a br task, use an automated multi-step workflow to surface missing edge cases, vague success criteria, and unspecified failure modes. This process tightens task descriptions to ensure readiness before implementation begins.

What is the best way to check task readiness against the actual codebase?

Checking task readiness requires verifying the task against the actual codebase using a codebase-investigator. This surfaces stale file references and closes gaps by producing a structured refinement report.

How do I tighten vague success criteria for epic tasks?

Tightening vague success criteria involves analyzing the task to make criteria concrete, testable, and aligned with epic goals. This refinement ensures all implicit assumptions are documented and resolved.

How do I identify unspecified failure modes before code implementation?

Identifying unspecified failure modes requires applying SRE-level scrutiny to the task description during the transition from planning to execution. This surfaces hidden risks and hardens the task before development starts.

When should I use a structured task refinement workflow?

Use a structured task refinement workflow when refining a br task prior to implementation, during readiness checks, or when hardening task descriptions. It enforces verification against the codebase to prevent stale references.