draft-play-expectation

Generate success_scenarios and recovery entries from intent.yaml into expectation.yaml.

3|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/kapilvirenahuja/garura --skill draft-play-expectation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: draft-play-expectation
Source: https://github.com/kapilvirenahuja/garura/tree/main/core/components/skills/draft-play-expectation
Command: npx skills add https://github.com/kapilvirenahuja/garura --skill draft-play-expectation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It converts a play’s Intent triple into a structured Expectation artifact that defines what success looks like and how the system should recover from each declared failure condition.

Core Features & Use Cases

  • Expectation generation from Intent: Produces success_scenarios and recovery directly from a play reference intent.yaml.
  • Observable, binary success measures: Ensures each scenario includes a measure designed to compile into deterministic evaluations.
  • Rule-governed recovery drafts: Creates one recovery entry per failure condition with trigger, directional guidance, and handoff settings, stamped as pending for human approval.

Quick Start

Use the skill to generate reference/expectation.yaml from reference/intent.yaml for a new play, then review the pending vetted.status at the create-play checkpoint.

Frequently Asked Questions about draft-play-expectation

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

FAQPage Schema
How do I generate deterministic test expectations from a play intent YAML file?

To generate deterministic test expectations from a play intent YAML file, use this Skill to transform reference/intent.yaml into reference/expectation.yaml. It drafts success scenarios and recovery entries with observable binary measures for agentic testability.

What is an expectation artifact in the Play framework and when do I need one?

An expectation artifact in the Play framework defines what success looks like and how the system recovers from declared failure conditions. You need one to establish deterministic testability and structured recovery design for create-play flows.

How do I create recovery scenarios for failure conditions in a Play framework intent?

To create recovery scenarios for failure conditions in a Play framework intent, this Skill generates exactly one recovery entry per declared failure. Each entry includes a trigger, directional guidance, and handoff settings, stamped as pending for human approval.

Does this expectation generation process support both legacy and migrated intent shapes?

Yes, this expectation generation process supports both legacy and migrated intent shapes. It detects the specific intent shape during generation and applies the appropriate rules to ensure the resulting YAML artifact is structurally valid.

What are the limitations of automatically drafting Play framework expectation artifacts?

The main limitation of automatically drafting Play framework expectation artifacts is that generated recovery entries require human approval. The system writes a vetted status of pending at the create-play checkpoint, meaning drafts are not immediately executable without review.