What is a 'Project Constitution' in this context?

The Constitution is a reference document (SDD 2025 Standard) that defines the project's technology stack, naming conventions, and architectural rules that every SPEC must follow to prevent architectural drift.

How does this skill support parallel development?

It utilizes Git Worktrees to create independent working directories for different SPECs. This allows developers to work on multiple features in isolation without the overhead of constant branch switching.

What is the Plan-Run-Sync workflow?

It is a development lifecycle where the PLAN phase creates the SPEC, the RUN phase handles TDD-based implementation, and the SYNC phase ensures documentation and API contracts remain updated.

MoAI Workflow SPEC

Name: MoAI Workflow SPEC
Author: zellycloud

byzellycloud

0•

Productivity & Workflow

Orchestrates systematic requirement definition and SPEC-first development using the EARS framework and Plan-Run-Sync integration.

moai-workflow-spec is a specialized orchestration skill designed for the MoAI-ADK development methodology, enabling developers to create unambiguous software specifications (SPECs). By utilizing the EARS (Easy Approach to Requirements Syntax) framework, it breaks down requirements into five distinct patterns—Ubiquitous, Event-Driven, State-Driven, Unwanted, and Optional—to eliminate ambiguity. It manages the entire lifecycle from initial user input analysis and requirement clarification to automated SPEC document generation and parallel feature development via Git Worktrees. This skill is essential for teams aiming to maintain architectural integrity, reduce scope creep, and ensure that every feature aligns with a standardized project Constitution.

Key Features

01EARS Format Requirements: Systematic definition using five clear requirement patterns to eliminate ambiguity.

02Parallel Development: Git Worktree-based isolation for managing multiple feature SPECs simultaneously.

030 GitHub stars

04Requirement Clarification: Four-step process including assumption analysis and root cause investigation.

05Quality Gate Validation: Built-in TRUST 5 framework checks to ensure specification quality and completeness.

06Plan-Run-Sync Integration: Seamless transition from planning to implementation and automated documentation.

Use Cases

01Defining complex feature requirements and success criteria before starting implementation.

02Managing parallel feature development across isolated branch environments using Git Worktrees.

03Establishing a single source of truth for architectural standards and project constraints (Constitution).

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add zellycloud/zyflow moai-workflow-spec

For use in Claude.ai and ChatGPT

Download Skill