rai-story-design

Generate typed sN.M-design.yaml and Markdown artifacts from backlog items.

71|8|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/humansys/raise --skill rai-story-design-humansys
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: rai-story-design
Source: https://github.com/humansys/raise/tree/main/packages/raise-cli/src/raise_cli/skills_base/rai-story-design
Command: npx skills add https://github.com/humansys/raise --skill rai-story-design-humansys

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Backlog story planning often lacks concise, AI-aligned specifications that humans can review quickly, causing misalignment and rework.

Core Features & Use Cases

  • Create lean story specifications that balance clarity for humans and structure for AI generation.
  • Guide the end-to-end story design workflow from PRIME through acceptance criteria, producing both a YAML artifact and a Markdown plan.
  • Applicable to new epics and story design tasks within RaiSE governance workflows.

Quick Start

Ask RaiSE to generate a lean story design from your backlog item to kick off story planning.

Frequently Asked Questions about rai-story-design

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

FAQPage Schema
How do I create lean story specifications for AI generation from backlog items?▼

To create lean story specifications, you can generate a typed design artifact from backlog items that balances human review clarity with AI alignment structure. This produces a YAML file and Markdown plan with verifiable acceptance criteria.

What is the best way to align human review and AI generation during epic planning?▼

Aligning human review and AI generation requires documenting traceable design decisions and acceptance criteria from your backlog. This workflow outputs a typed design.yaml artifact and a Markdown work artifact to ensure verifiable epic grooming.

How does story design work within RaiSE governance workflows?▼

Story design within RaiSE workflows guides the end-to-end process from PRIME through acceptance criteria. It identifies and documents lean story designs to produce a verifiable design artifact applicable during initial story planning.

Can I use design thinking to generate acceptance criteria for new epics?▼

Yes, you can apply design thinking to generate acceptance criteria for new epics. The process identifies and documents lean story designs, producing both a YAML artifact and a Markdown plan with input validation and traceable design decisions.

Do I need a gemba walk to start story planning with AI alignment?▼

A gemba walk is part of the applicable workflow context for story design, but the core requirement is having a backlog item. You can kick off story planning by asking RaiSE to generate a lean story design directly from your existing backlog.

What limitations exist when using YAML artifacts for backlog story planning?▼

The YAML artifact is specifically structured for RaiSE governance workflows and AI alignment. It outputs a typed sN.M-design.yaml format, meaning its schema is tailored to traceable design decisions and may not suit non-RaiSE project management contexts.