spec-composition

Routes multi-spec design requests toward initiative-first composition with canonical nudge phrasing.

Updated Apr 20, 2026
One-click install
npx skills add https://github.com/astroville/sprout --skill spec-composition-astroville
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-composition
Source: https://github.com/astroville/sprout/tree/main/.claude/skills/spec-composition
Command: npx skills add https://github.com/astroville/sprout --skill spec-composition-astroville

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a design request would produce two or more related specs, teams often end up with flat sibling specs that have no shared parent and become hard to discover. This Skill provides the canonical doctrine and paste-ready phrasing for nudging users toward composing related specs into an initiative with phased children instead. ## Core Features & Use Cases - Canonical phrasing: Supplies one verbatim sentence quoted by both interactive triage (/roadmap-review) and design-time routing (/design) so the nudge wording stays consistent across surfaces. - Trigger rules: Defines three any-of triggers — explicit multi-deliverable phrasing, lead-identified sub-deliverables, and rolled-up size of large or higher — each sufficient to fire the nudge. - Precedence and suppression: Coordinates with the sizing nudge so exactly one nudge fires per moment, and suppresses re-firing inside /compose flows or after a session-level decline. - Use Case: A user asks to "design the checkout, cart, and payment specs." The lead quotes the trigger #1 phrasing, recommends /compose to scaffold an initiative with three child stubs, and proceeds based on the user's yes/no answer. ## Quick Start When a design request names multiple related deliverables, quote the canonical nudge sentence and ask whether to compose them into an initiative before writing sibling specs.

Frequently Asked Questions about spec-composition

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

FAQPage Schema
How do I handle a design request that names multiple deliverables?▼

When a /design request names two or more distinct deliverables, quote the canonical nudge recommending /compose to scaffold an initiative with child stubs. The user can accept and pivot to /compose, or decline and proceed with flat sibling specs.

What triggers the multiple related specs nudge during design?▼

Any one of three triggers fires the nudge: explicit multi-deliverable phrasing in the request, the lead identifying independent sub-deliverables during clarification, or a rolled-up size estimate of large or higher across the deliverables.

Does the composition nudge block the design workflow?▼

No, the nudge is advisory and never blocks. The user can decline with any clear refusal, the lead resumes the design flow, and one decline suppresses re-firing for the rest of the session.

What happens when both the routing nudge and sizing nudge would fire?▼

The routing nudge fires first and the sizing nudge stands down for that moment. Sizing nudges resurface later per-child inside /compose passes, or per-sibling if the user declined routing.

When should the composition nudge not fire?▼

It stays silent when the /design call came from a /compose flow, when the user already declined earlier in the session, or when the sizing nudge would also fire and routing has already claimed the slot.