pm-preset-detection

Reads hero.json pm.presets config and applies preset-specific authoring rules per artifact type.

3|2|Updated Aug 24, 2026
One-click install
npx skills add https://github.com/hero-engine/hero --skill pm-preset-detection-hero-engine
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pm-preset-detection
Source: https://github.com/hero-engine/hero/tree/main/domains/pm/skills/pm-preset-detection
Command: npx skills add https://github.com/hero-engine/hero --skill pm-preset-detection-hero-engine

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? PM workspaces run different delivery methodologies (continuous, sprint, cycle, phased) and roadmap groupings, each requiring different frontmatter fields on specs, epics, and initiatives. Without preset detection, authoring agents hardcode assumptions (like always prompting for story points) that produce broken artifacts in workspaces using a different methodology. ## Core Features & Use Cases - Preset Resolution: Reads pm.presets from hero.json and returns the active roadmap, delivery, and overlay combination, degrading to sane defaults (horizon + continuous) when config is missing. - Preset-Conditional Field Rules: Maps each delivery preset to its required fields — points/sprint for sprint, hill_position/cycle for cycle, release/phase for phased — so agents prompt only for relevant fields. - Field Preservation on Switch: Preserves inactive preset fields when a workspace changes methodology, keeping history intact and making switching a low-cost config edit. - Use Case: A story-writer agent in a Shape Up (cycle) workspace loads this skill first, learns the active preset, and prompts for hill_position and appetite instead of story points. ## Quick Start Ask the agent to read the pm.presets configuration from hero.json and tell you which fields to populate for a new feature spec.

Frequently Asked Questions about pm-preset-detection

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

FAQPage Schema
How do I detect which PM delivery preset a Hero workspace uses?▼

Read the pm.presets object in hero.json, which contains roadmap, delivery, and overlay fields. If the section is missing or partially populated, fall back to the defaults: horizon roadmap, continuous delivery, and no overlay.

What frontmatter fields are required for each delivery preset?▼

Sprint requires points and sprint; cycle requires cycle and hill_position; phased requires release and phase; continuous requires no authored preset fields. Epics and initiatives have their own preset-conditional fields like appetite, is_bet, and velocity_target.

What happens to existing fields when switching PM presets?▼

Previously populated preset-conditional fields are preserved but become inactive. Switching from cycle to sprint does not delete hill_position from old stories, and there is no automatic conversion between estimates like appetite and points.

What is the difference between methodology preset and vocabulary preset?▼

The methodology preset (pm.presets) drives behavior: which fields to populate and which dashboards render. The vocabulary preset only changes display names, rendering a feature as Story, Scope, or Card without affecting frontmatter.

Should agents throw an error when pm.presets is missing?▼

No. A missing pm.presets section degrades to the defaults of horizon roadmap, continuous delivery, and null overlay. Agents should never throw on a missing preset key and should re-read the config rather than caching it indefinitely.