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