hs:shape

Decomposes approved product stories into dev tasks, roadmaps, experiments, and POC gates.

Updated Jul 19, 2026
One-click install
npx skills add https://github.com/Dozyboy/VSF --skill hs-shape-dozyboy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hs:shape
Source: https://github.com/Dozyboy/VSF/tree/main/Day2_VSF/Demo1/harness/plugins/hs/disabled-skills/shape
Command: npx skills add https://github.com/Dozyboy/VSF --skill hs-shape-dozyboy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) and references (resource) components.

What problem does it solve? Product teams need a disciplined bridge between an approved PO story spec and actual development work: stories must be decomposed into dev tasks, rolled up into roadmaps with effort estimates, market hypotheses must be pre-registered before experiments run, and technical feasibility must be proven before work counts as planned. This Skill automates that BA-side workflow while never mutating the PO-owned story tree. ## Core Features & Use Cases - Dev-Task Decomposition: Break an approved story (or fan out an epic/prd selector to its descendant stories) into task sidecar records with 1-1/1-n/n-1 story mappings via a single serves field. - Roadmap & Effort Rollup: Aggregate milestones and effort figures from the task sidecar, mapping story sizes (S/M/L) to day ranges and summing explicit task estimates. - Market Experiment Specs: Pre-register a hypothesis, design, and decision rule before an experiment runs, then apply a PO-supplied result against that rule to compute a deterministic hit/partial/miss verdict. - Technical POC Gate: Read code-review and verification verdict artifacts and close a POC only when both read PASS, then hand a plan-intake brief to the planning stage. - Use Case: After a story is approved, invoke the task flag to generate TASK records, roll them into a roadmap with effort estimates, and gate the roadmap on a closed POC before counting the work as feasible. ## Quick Start Ask the AI to decompose the approved story into dev tasks and roll them up into a roadmap with effort estimates using this skill.

Frequently Asked Questions about hs:shape

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

FAQPage Schema
How do I decompose a product story into dev tasks?▼

Invoke the skill with the --task flag and a story id to author a task sidecar record whose serves field points at that story. Passing an epic or prd id fans out to descendant stories after a read-only scope preflight, authoring one task per chosen story.

How does the roadmap effort rollup calculate estimates?▼

The rollup maps a story's size field (S/M/L) to a day range through a configurable YAML table, while an explicit estimate on a task record always wins. Estimates are parsed and summed into a min-max day range, with unparsable entries skipped rather than failing the build.

Can this skill run market experiments or A/B tests itself?▼

No. It only pre-registers the experiment spec (hypothesis, design, decision rule) before anything runs and later applies a PO-supplied metric result against that rule. Soliciting customers, running splits, or fetching metrics is explicitly out of scope and guarded by source-level checks.

When does a technical POC count as closed?▼

A POC closes only when both the code-review verdict and the verification verdict read back as exactly PASS. PASS_WITH_RISK, BLOCKED, or missing artifacts leave the POC open, and a closed POC is a precondition before a roadmap rollup counts the work as feasible.

Does this skill modify the product-owner story files?▼

No. All writes are contained under docs/product/shape/ through a path-containment helper that raises on any escape attempt toward the PO-owned tree. The story graph is only read, never mutated, and this is enforced in code rather than by convention.