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.