shape-spec

Shape scope, design, and acceptance criteria for new work in plan mode.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/gr8routdoors/lit-sdlc --skill shape-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shape-spec
Source: https://github.com/gr8routdoors/lit-sdlc/tree/main/.claude/skills/agent-os/shape-spec
Command: npx skills add https://github.com/gr8routdoors/lit-sdlc --skill shape-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The shape-spec skill helps teams quickly define scope, plan work, and align on design and acceptance criteria within plan mode.

Core Features & Use Cases

  • Clarifies scope and intent for significant work
  • Guides the creation of design artifacts, stories, and acceptance criteria
  • Use Case: when starting a large feature, run shape-spec to produce a plan scaffold and guardrails

Quick Start

Run shape-spec in plan mode to begin shaping the next feature.

Frequently Asked Questions about shape-spec

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

FAQPage Schema
How do I create a formal spec and define acceptance criteria for a new feature?

To create a formal feature spec, use this skill in plan mode to shape scope, generate architectural design artifacts, derive stories, and define acceptance criteria before implementation begins.

What is the best way to plan scope and requirements before starting a large software project?

Planning scope and requirements for large projects requires upfront alignment on intent and design. This skill guides the creation of plan scaffolds, guardrails, and verification artifacts within plan mode.

How do I generate user stories and architectural design from initial project requirements?

Generating user stories and architectural design from requirements involves shaping the initial scope. This skill processes requirements to derive actionable stories and produce formal design artifacts.

Does this spec planning skill work within plan mode to prevent unscoped implementation?

Yes, this spec planning skill operates entirely within plan mode. It ensures significant changes receive upfront scoping and a formal spec, creating guardrails to prevent unstructured implementation.

When do I need to use a formal specification process for software changes?

You need a formal specification process when starting large features or significant changes that require upfront planning. It clarifies scope and intent, producing design artifacts and acceptance criteria before coding.

Can I use shape-spec to generate verification artifacts for architectural design?

Yes, you can use shape-spec to generate verification artifacts. It supports the end-to-end planning process by creating architectural design, story derivation, and acceptance criteria for new work.