moai-workflow-spec

Manage SPEC workflows with EARS format for MoAI-ADK development.

Updated Jan 16, 2026
One-click install
npx skills add https://github.com/yarang/fastapi-error-code --skill moai-workflow-spec-yarang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: moai-workflow-spec
Source: https://github.com/yarang/fastapi-error-code/tree/main/.claude/skills/moai-workflow-spec
Command: npx skills add https://github.com/yarang/fastapi-error-code --skill moai-workflow-spec-yarang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured framework to manage SPEC workflows for MoAI-ADK development, enabling consistent planning, specification, and execution across teams.

Core Features & Use Cases

  • SPEC-first planning with EARS patterns to define clear requirements
  • Requirement clarification and parallel SPEC isolation using Git worktrees
  • Plan-Run-Sync lifecycle alignment including SPEC document generation, TDD guidance, and documentation sync
  • Templates, templates propagation, and governance through progressive disclosure settings
  • Advanced workflow orchestration for multi-SPEC projects and risk mitigation

Quick Start

Start a new SPEC with PLAN phase: /moai:1-plan "user authentication system" --worktree

Frequently Asked Questions about moai-workflow-spec

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

FAQPage Schema
How do I orchestrate a plan-run-sync lifecycle for multi-SPEC projects?

The SPEC workflow uses a Plan-Run-Sync lifecycle to orchestrate tasks. This skill aligns planning, execution, and synchronization phases, generating SPEC documents and TDD guidance to maintain consistency across multi-SPEC projects.

Does MoAI-ADK development support SPEC-first planning with git worktree isolation?

Yes, parallel SPEC isolation is supported using git worktree. You can start a new SPEC with a dedicated worktree using the command plan phase, enabling concurrent development streams without cross-interference.

What is the best way to generate SPEC documents with EARS patterns?

To start a new SPEC in the planning phase, use the command interface with your project description and the worktree flag. This initiates requirement clarification and generates the SPEC document using EARS patterns.

When do I need progressive disclosure settings for SPEC workflow governance?

Progressive disclosure settings are needed for SPEC workflow governance when managing templates and their propagation across multi-SPEC projects. This approach mitigates risk by revealing complexity only when required during the plan-run-sync lifecycle.