Workflow Decision Triage

Skill name: workflow-decision-triage

Triage software decision logs at a PR boundary. Use before opening or updating a PR when scratchpad.md entries need promotion to decisions.md, when checking unreviewed decision entries, or when preparing permanent decision records.

Triage is blocked while any scratchpad entry remains [ ]. Ask the user to mark entries [x] or [-] when human judgment is needed.

Use the script after markings are resolved:

python3 /Users/trent.brown/agentic-development-workflow/scripts/decision_triage.py --help

Embedded Instructions

Decision Triage

Use at every PR boundary before opening or updating the PR for review.

• Read scratchpad.md.
• Ensure every entry is marked:
• [x] promote
• [-] dismiss
• [ ] blocks triage
• Append promoted entries to decisions.md.
• Leave dismissed entries in scratchpad.md as audit trail.
• Add PR number/URL to promoted entries when available.

Useful script:

python3 "<plugin-root>/resources/scripts/decision_triage.py" \
  --branch-dir docs/issues/$(git branch --show-current) \
  --pr "#123"