feature-resolve

Resolves the correct feature folder, version, and stage file path for feature workflow skills.

Updated May 26, 2026
One-click install
npx skills add https://github.com/cagriy/dev-skills --skill feature-resolve-cagriy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: feature-resolve
Source: https://github.com/cagriy/dev-skills/tree/main/skills/feature-resolve
Command: npx skills add https://github.com/cagriy/dev-skills --skill feature-resolve-cagriy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When multiple feature-development skills (storm, design, plan, implement) each need to know which versioned feature folder to write into, duplicating that resolution logic causes drift and inconsistency. This internal helper centralizes folder resolution so all four skills stay aligned on versioning, naming, and stage-file paths. ## Core Features & Use Cases - Folder and version resolution: Scans features/ for existing feature-v<N>-<description> folders and decides whether to continue the latest feature or create a new one, enforcing contiguous version numbers. - Stage file path computation: Returns the exact stage .md path and prerequisite file path the calling skill must read or write, as a parseable output block. - Tracker seeding: Creates the feature folder and copies the plugin's feature-tracker.html template into place when a new feature is started. - Use Case: When a user runs /dev:feature-plan without naming a version, this skill determines the latest in-progress feature, verifies the design stage file exists, and hands back the exact plan file path to write. ## Quick Start Invoke this skill from another feature skill with an argument string like stage=plan, version=3 to resolve the target feature folder and stage file path.

Frequently Asked Questions about feature-resolve

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

FAQPage Schema
How do I resolve which feature folder a stage should write into?

Invoke feature-resolve with a stage argument such as stage=plan, optionally adding version=N or a description. It scans the features/ directory, applies priority rules, and returns the folder path, version, and stage file path as a parseable block.

Can I invoke feature-resolve directly as a user?

No, feature-resolve is marked user-invocable: false and runs only as an internal resolution step inside feature-storm, feature-design, feature-plan, and feature-implement. It loads inline into the calling skill's turn rather than running standalone.

Does feature-resolve create or edit stage markdown files?

No, it never creates or edits stage .md files. It only creates the feature folder, optionally seeds the tracker HTML from the plugin template, and returns the path the calling skill must write to.

What happens when feature versions are not contiguous?

The skill stops with an error. New features must use N_max + 1, so gaps like jumping from v2 to v4 are rejected, and minor versions such as v1.1 are not allowed under any circumstances.

Why does feature-resolve fail when the prerequisite stage file is missing?

The plan stage requires an existing design file and the implement stage requires an existing plan file. If the prerequisite is absent in the target folder, resolution stops with an error naming the missing prerequisite so the earlier stage can run first.