design-phase

Extract user stories from PRD and annotate them with architecture notes.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/metasaver/metasaver-marketplace --skill design-phase
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: design-phase
Source: https://github.com/metasaver/metasaver-marketplace/tree/main/plugins/metasaver-core/skills/workflow-steps/design-phase
Command: npx skills add https://github.com/metasaver/metasaver-marketplace --skill design-phase

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bridging the gap between approved requirements and actionable development tasks often involves heavy documentation. This Skill provides a lightweight, AI-driven design and planning workflow.

Core Features & Use Cases

  • Lightweight Architecture Annotation: Spawns an Architect agent to add brief, inline architecture notes (API endpoints, key files, database models, patterns) directly to user story files.
  • Parallel Execution Planning: A Project Manager agent creates a detailed execution plan, breaking down tasks, assigning them to domain agents, and organizing them into parallel waves with dependencies.
  • Efficient & Focused: Aims for 50-100 lines of architecture notes in ~30 seconds, avoiding lengthy, separate design documents, and streamlining the transition to implementation.
  • Use Case: After user stories are approved, this skill automatically adds technical guidance to each story and generates a Gantt-style execution plan, ready for implementation.

Quick Start

Initiate the design phase for the user stories in 'docs/projects/20251208-feature/user-stories/' with a complexity of 25.

Frequently Asked Questions about design-phase

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

FAQPage Schema
How do I extract user stories from a PRD and add architecture annotations?▼

This Skill automates extraction of user stories from an approved PRD, then attaches inline architecture notes (API endpoints, database models, key files, patterns) directly to each story file. It spawns an Architect agent to annotate stories with technical guidance in under 30 seconds, bridging requirements and implementation.

Can I generate an execution plan with parallel task waves from user stories?▼

Yes. After annotation, a Project Manager agent creates a detailed execution plan that breaks down stories into tasks, assigns them to domain agents, and organizes them into parallel waves with dependencies—ready for immediate implementation.

What inputs does the design phase workflow require?▼

Provide an approved PRD file path, project folder location, complexity level, available tools, and scope. The Skill reads the PRD, extracts and annotates user stories enforcing granularity guidelines, and outputs story files, architecture notes, and a structured execution plan.

How lightweight is the architecture annotation process?▼

Architecture annotations target 50–100 lines of concise, inline notes delivered in approximately 30 seconds, avoiding lengthy separate design documents. This keeps the workflow efficient and focused on actionable technical guidance.

When should I run the design phase in my workflow?▼

Initiate the design phase immediately after your PRD passes a vibe-check and receives approval. It bridges approved requirements and development readiness by automating story extraction, technical annotation, and execution planning.

Does this workflow enforce story granularity standards?▼

Yes. The Skill enforces CRITICAL story granularity guidelines to ensure consistent, implementable user stories and maintains inline architecture annotations throughout each story file.