brdohman/workflow-state
.claude/skills/workflow/workflow-state/SKILL.md
How to transition workflow state between review stages. Rules for setting review_stage and review_result fields on Stories and Epics.
$ install --global
skillsauthnpx skillsauth add brdohman/agile-maestro workflow-stateInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 16, 2026, 7:20 PM7.2s1 file scanned
SKILL.md
- name:
- workflow-state
- description:
- How to transition workflow state between review stages. Rules for setting review_stage and review_result fields on Stories and Epics.
- disable-model-invocation:
- true
- allowed-tools:
- [TaskGet, TaskUpdate]
Workflow State Transitions
How to Transition
Set review_stage and review_result directly in the same TaskUpdate call. No helper function needed. Always include a structured comment in the same call.
Submit for code review: review_stage: "code-review", review_result: "awaiting"
Pass code review: review_stage: "qa", review_result: "awaiting"
Fail code review: review_stage: "code-review", review_result: "rejected"
Pass QA: review_stage: "product-review", review_result: "awaiting"
Fail QA: review_stage: "qa", review_result: "rejected"
Pass product review: review_stage: null, review_result: null (+ status: "completed")
Fail product review: review_stage: "product-review", review_result: "rejected"
Fix and resubmit: review_stage: "code-review", review_result: "awaiting"
Key Rules
-
Any rejection restarts at code-review. After fixing, always set
review_stage: "code-review", regardless of which stage rejected. -
Both fields must be set together.
review_stageandreview_resultare always paired. Never set one without the other. -
Tasks never get review fields. Only Stories and Epics go through the review cycle. Tasks complete directly.
-
Read before write. Always call
TaskGetbeforeTaskUpdateto preserve the existingcommentsarray. -
Every transition requires a comment. Include a structured comment in the same
TaskUpdatecall.
Consistency Rules
VALID: review_stage: "qa", review_result: "awaiting"
VALID: review_stage: null, review_result: null
INVALID: review_stage: "qa", review_result: null (unpaired)
INVALID: review_stage: null, review_result: "awaiting" (unpaired)
See Also
- Complete state machine, field definitions, lifecycle diagrams:
.claude/docs/WORKFLOW-STATE.md - Comment templates by stage: skill
review-cycle - Protocol details (read-before-write, comment format):
.claude/rules/global/task-state-updates.md
Related Skills
brdohman/xctest-patterns
testing
VerifiedTrustedCommunity
XCTest patterns for macOS Swift apps. Unit tests, async tests, Core Data tests, mock patterns, and assertion reference. Use when writing or reviewing tests.
2SKILL.mdUpdated Apr 16, 2026
brdohman/workflow-comments
documentation
VerifiedTrustedCommunity
Comment structure and rules for task workflow updates. Use when adding any comment to a task during implementation, review, or fix cycles.
2SKILL.mdUpdated Apr 16, 2026
brdohman/validate-task
testing
VerifiedTrustedCommunity
Validate task/story/epic/bug/techdebt metadata against schema v2.0. Run after TaskCreate or TaskUpdate to verify compliance. Returns pass/fail with actionable details.
2SKILL.mdUpdated Apr 16, 2026
brdohman/v2-schema-reference
data-ai
VerifiedTrustedCommunity
Canonical v2.0 metadata schema field reference for epics, stories, and tasks. Use when creating or validating task metadata.
2SKILL.mdUpdated Apr 16, 2026