refine

Run Clarify, Research, and Spec phases to prepare backlog items for overnight execution.

1|Updated Apr 1, 2026
One-click install
npx skills add https://github.com/charleshall888/cortex-command --skill refine-charleshall888
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refine
Source: https://github.com/charleshall888/cortex-command/tree/main/plugins/cortex-core/skills/refine
Command: npx skills add https://github.com/charleshall888/cortex-command --skill refine-charleshall888

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Automates the preparation of backlog items for overnight execution by orchestrating Clarify, Research, and Spec phases to lock in intent and scope before execution.

Core Features & Use Cases

  • Coordinates Clarify to establish intent, Research to explore solutions, and Spec to lock in requirements for the overnight run.
  • Produces cortex/lifecycle/{lifecycle-slug}/research.md and cortex/lifecycle/{lifecycle-slug}/spec.md, and updates the backlog item with status: refined after user approval.
  • Registers produced artifacts in cortex/lifecycle index.md to enable downstream automation and traceability.

Quick Start

Invoke /cortex-core:refine to prepare a backlog item for overnight execution by running Clarify → Research → Spec and publish cortex/lifecycle artifacts.

Frequently Asked Questions about refine

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

FAQPage Schema
How do I automate backlog preparation for overnight execution?

Backlog preparation for overnight execution is automated by orchestrating Clarify, Research, and Spec phases to lock in intent and scope. This produces research.md and spec.md artifacts, then sets the backlog status to refined after user approval.

What is the process to lock in requirements before an overnight run?

To lock in requirements before an overnight run, the refine process runs Clarify to establish intent, Research to explore solutions, and Spec to finalize requirements. It then registers the produced artifacts in the cortex lifecycle index for downstream traceability.

Do I need user approval before a backlog item status is set to refined?

Yes, user approval is required before a backlog item status is set to refined. The workflow produces spec.md and research.md artifacts during the Clarify, Research, and Spec phases, but the status only updates to refined after you explicitly approve the output.

Where are research and spec artifacts registered for downstream automation?

Research and spec artifacts are registered in cortex/lifecycle/index.md. The refine process generates cortex/lifecycle/{lifecycle-slug}/research.md and spec.md, logging them in the index to enable downstream automation and traceability for the overnight workflow.

What's the best way to coordinate Clarify, Research, and Spec for a lifecycle slug?

The best way to coordinate Clarify, Research, and Spec for a lifecycle slug is using the refine orchestration flow. It sequentially runs these phases to produce research.md and spec.md under cortex/lifecycle/{lifecycle-slug}/, ensuring scope is locked before overnight execution.

Why does my overnight workflow need refined backlog items?

Overnight workflows need refined backlog items to ensure intent and scope are locked before execution begins. The refine process produces spec.md and research.md artifacts, registering them in the cortex lifecycle index to provide downstream automation with traceable, approved requirements.