dev

Developer skill dispatcher.

Critical Rules

• Never execute workflow logic here — this file only parses args and dispatches
• Step 0 always runs first — no exceptions
• Unknown verb → run help.md — never error silently
• Pass all remaining args through — workflow receives $REMAINING_ARGS unchanged

Step 0: Parse Arguments

VERB="[first non-flag argument, or empty]"
REMAINING_ARGS="[everything after VERB, preserving order and flags]"

case "$VERB" in
  "")              VERB="help" ;;
  "fix")           VERB="pr-fix" ;;
  "pull-request")  VERB="pr" ;;
  "merge-request") VERB="pr" ;;
  "mr")            VERB="pr" ;;
esac

Step 1: Dispatch to Workflow

Read and execute references/workflows/{VERB}.md, passing $REMAINING_ARGS as the argument string.

If references/workflows/{VERB}.md does not exist, fall back to references/workflows/help.md and note the unknown verb.

Workflow Index

• allow (references/workflows/allow.md) — pre-approve permissions for background agents
• approve (references/workflows/approve.md) — push tasks to Linear
• diff (references/workflows/diff.md) — compare two repos for structural differences
• docs (references/workflows/docs.md) — generate or update documentation
• explore (references/workflows/explore.md) — research technical approaches, generate proposals
• help (references/workflows/help.md) — print command reference
• pr (references/workflows/pr.md) — create a pull request or merge request
• plan (references/workflows/plan.md) — plan feature or system architecture
• pr-fix (references/workflows/pr-fix.md) — review and fix PR issues

Agent Index

• linear-tasks-agent (agents/linear-tasks-agent.md) — pushes tasks to Linear; used by approve
• proposal-writer (agents/proposal-writer.md) — writes technical proposals; used by explore
• researcher (agents/researcher.md) — researches technical approaches; used by explore