handoff-spec

Converts a story_map slice into a task_spec document for delivery handoff.

Updated Aug 4, 2026
One-click install
npx skills add https://github.com/rombel00/game-processes --skill handoff-spec-rombel00
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: handoff-spec
Source: https://github.com/rombel00/game-processes/tree/main/plugins/product-definition/skills/handoff-spec
Command: npx skills add https://github.com/rombel00/game-processes --skill handoff-spec-rombel00

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a product slice is ready to move into development, teams often rewrite requirements from scratch, creating a second source of truth and losing acceptance criteria along the way. This Skill translates an existing story_map (or brief) into a task_spec by referencing what exists and adding only what the product track cannot provide: non-functional requirements, integration points, and constraints. ## Core Features & Use Cases - Slice Translation: References core loop, meta-loop, and progression units from story_map instead of rewriting them, copying acceptance criteria verbatim. - Gap Filling: Adds non-functional requirements (frame rate, target platforms, store certification), integration points, and constraints that product documents do not cover. - Verification Planning: Defines how each acceptance criterion will be proven (autotest, playtest, metric event) before development starts. - Use Case: A game team finishes its first playable slice definition and needs to hand it to developers. The Skill produces a task_spec with branch/base commit info, acceptance criteria, out-of-scope lists, and live verification methods, then routes it through a handoff review gate. ## Quick Start Use the handoff-spec skill to convert the approved story_map slice for Release 1 into a task_spec for the delivery track.

Frequently Asked Questions about handoff-spec

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

FAQPage Schema
How do I hand off a game design slice to developers?▼

Create a task_spec that references story_map units by ID, copies acceptance criteria verbatim, lists out-of-scope items, and adds non-functional requirements and integration points. Define how each criterion will be verified before coding starts.

What should a task_spec contain before development starts?▼

A task_spec needs the slice scope with unit references, acceptance criteria, explicit out-of-scope items, non-functional requirements, integration points, constraints, settled decisions, open questions, and a live verification method per criterion.

Can I create a task_spec without a story_map?▼

Yes. When the definition phase was skipped, slice units come directly from brief items instead of story_map elements. The Skill does not require retroactively building a map that the chosen process depth never promised.

What happens when open blocking questions remain in a task_spec?▼

The artifact is still written to disk, but the Skill returns status blocked with the unresolved question in blocking_questions instead of marking the handoff done. Class-B questions like product forks or legal issues must be escalated, not passed downstream.

When is a task_spec not needed at all?▼

At the shallowest process depth, where the workflow goes from brief directly to code, no task_spec is written and this Skill is not invoked. Reduced depth also omits the non-functional requirements, integration, and constraints sections.