Requirement Workflow Orchestrator

State-machine driven development workflow with agent/skill injection support.

Execution Flow

1. ANALYZE & SELECT LEVEL → Run init-workflow.sh
2. STAGE LOOP → Run advance-stage.sh for each stage
3. CREATE DOCUMENTS → spec.md → tasks.md → design.md → checklist.md → report.md

Step 1: Analyze & Select Level

Level	Condition	Doc Depth
L1	≤3 files, quick fix	Brief + simple
L2	4-15 files, standard feature	Full PRD + design
L3	Security/cross-module/breaking	Comprehensive

Step 2: Initialize Workflow

{skill_root}/scripts/init-workflow.sh -r <project_root> -n <name> -t <type> -l <level>

Types: feature, bugfix, refactor, hotfix

Step 3: Execute Stage Loop

For EACH stage:

A. Run: {skill_root}/scripts/advance-stage.sh -r <project_root>
B. Check for injected agents (pre_stage/post_stage)
C. Create stage document
D. Repeat until status = DONE

Stage Documents

Stage	Document	Content
ANALYZING	spec.md	Requirements, scope
PLANNING	tasks.md	Task breakdown
DESIGNING	design.md	Technical design
IMPLEMENTING	Code	Implementation
TESTING	checklist.md	Test checklist
DELIVERING	report.md	Summary report

Scripts

Script	Purpose
init-workflow.sh	Initialize workflow
advance-stage.sh	Advance to next stage
get-status.sh	Check current status
inject-agent.sh	Add agent injection
generate-report.sh	Generate final report

Example

User: "Add user authentication feature"

$ {skill_root}/scripts/init-workflow.sh -r /project -n "user-auth" -t feature -l L2
✅ Created: .trae/workflow/20240115_001_feature_user-auth/

$ {skill_root}/scripts/advance-stage.sh -r /project
✅ Transitioned to ANALYZING
🤖 Injected: risk-auditor (pre_stage)

[Create spec.md...]

$ {skill_root}/scripts/advance-stage.sh -r /project
✅ Transitioned to PLANNING
...

References

• L1 Workflow - Quick workflow
• L2 Workflow - Standard workflow
• L3 Workflow - Complex workflow
• Injection Guide - Agent/Skill injection
• Agents Index - All available agents