moai-workflow-spec

You can automate SPEC workflow management using PLAN, RUN, and SYNC phases to coordinate planning, execution, and documentation. This approach ensures consistency across the SPEC lifecycle by applying repeatable workflows for creating, validating, and syncing SPECs.

The EARS pattern is a structured syntax for writing requirement statements. It applies to requirement generation by providing DDD-aligned validation, ensuring that your SPEC documents contain clear, testable requirements that satisfy quality gate standards.

You can coordinate parallel worktrees for multiple SPECs during the RUN phase of the workflow. This provides dependency isolation and allows multiple SPECs to be executed simultaneously without interfering with each other's development environments.

Test scenario mapping is validated during the SYNC phase to ensure alignment with TRUST 5 quality gates. This process checks that your generated EARS-based requirements correctly map to defined test scenarios and satisfy all required project metadata standards.

While you can use the workflow orchestration independently, the SPEC validation relies heavily on DDD-aligned validation. Skipping DDD alignment means losing automated checks that ensure your EARS-based requirements and test scenario mapping satisfy the TRUST 5 quality gates.

The best way to create and sync a SPEC document is by following the PLAN, RUN, and SYNC workflow orchestration. This involves planning the feature, executing the work in isolated worktrees, and syncing the validated EARS requirements and test scenarios back to the main branch.