moai-workflow-spec

Generate Software Design Documents using EARS format and Plan-Run-Sync methodology.

Updated Feb 26, 2026
One-click install
npx skills add https://github.com/skeeper75/widget.creator --skill moai-workflow-spec-skeeper75
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: moai-workflow-spec
Source: https://github.com/skeeper75/widget.creator/tree/main/.claude/skills/moai-workflow-spec
Command: npx skills add https://github.com/skeeper75/widget.creator --skill moai-workflow-spec-skeeper75

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the creation and management of Software Design Documents (SPECs) by enforcing the EARS (Easy Approach to Requirements Syntax) format, ensuring clarity, consistency, and testability in requirements.

Core Features & Use Cases

  • EARS Requirement Generation: Automatically structures requirements into Ubiquitous, Event-Driven, State-Driven, Unwanted, and Optional patterns.
  • SPEC Document Creation: Generates standardized SPEC documents including requirements, constraints, acceptance criteria, and test scenarios.
  • Workflow Integration: Seamlessly integrates with Plan-Run-Sync development methodologies for systematic feature development.
  • Use Case: When planning a new user authentication feature, use this Skill to generate a comprehensive SPEC document that clearly defines all functional and non-functional requirements, acceptance criteria, and test cases, ensuring all stakeholders have a shared understanding before development begins.

Quick Start

Use the moai-workflow-spec skill to create a new SPEC document for a user authentication system.

Frequently Asked Questions about moai-workflow-spec

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

FAQPage Schema
How do I write software requirements using the EARS format?

The EARS format structures software requirements into Ubiquitous, Event-Driven, State-Driven, Unwanted, and Optional patterns. This syntax ensures clarity, consistency, and testability when defining functional and non-functional requirements for your software design documents.

How do I generate acceptance criteria and test scenarios from a SPEC document?

You can generate acceptance criteria and test scenarios by orchestrating SPEC creation with the EARS format. This process automatically structures requirements and translates them into standardized test cases to ensure all stakeholders share a clear understanding.

What is the best way to document requirements for parallel development across Git worktrees?

Documenting requirements for parallel development across Git worktrees requires standardized SPEC documents generated via the EARS format. This ensures systematic feature development and shared understanding across isolated branches, integrating directly with quality gates.

Can I integrate software design documents with a Plan-Run-Sync workflow methodology?

Yes, software design documents can seamlessly integrate with Plan-Run-Sync development methodologies. This integration facilitates systematic feature development by automating SPEC creation, requirement definition, and test scenario generation within the MoAI-ADK environment.

When should I use EARS syntax for requirement definition instead of standard documentation?

You should use EARS syntax for requirement definition when you need to automate SPEC creation and enforce testability. It is necessary when planning features like user authentication, ensuring functional constraints are clearly defined before development begins.