moai-workflow-spec

# SPEC Workflow Management ## Quick Reference SPEC Workflow Orchestration using GEARS notation (current) — backed by the EARS legacy backward-compatibility window — for systematic requirement definition and Plan-Run-Sync workflow integration. Lint behavior canonicalized per the GEARS migration policy. Core Capabilities: - GEARS-Format Specifications (current): Five requirement patterns with the unified compound clause `[Where ...][While ...][When ...] The <subject> shall <behavior>` and a generalized `<subject>` (any noun, not only "the system") - EARS Legacy Reference: All EARS patterns preserved per the lint engine's backward-compatibility policy to keep pre-v3 SPECs (those authored before GEARS became canonical) readable - Requirement Clarification: Four-step systematic process with assumption analysis - SPEC Document Templates: Standardized 3-file structure (spec.md / plan.md / acceptance.md) - Plan-Run-Sync Integration: Seamless workflow connection - Parallel Development: Git Worktree-based SPEC isolation - Quality Gates: TRUST 5 framework validation GEARS Five Patterns (current notation): | Pattern | GEARS form (current) | EARS form (legacy) | Notes | |---------|----------------------|--------------------|-------| | Ubiquitous | "The <subject> shall <behavior>" | "The system shall <behavior>" | `<subject>` may be any noun: system, component, service, agent, function, artifact | | Event-driven | "**When** <event-detected>, the <subject> shall <behavior>" | "WHEN <...