Ironclaw Workflow Orchestrator

Prerequisites

Before installing routines, verify:

• Routines system enabled.
• GitHub tool authenticated (for issue/PR/comment/status operations).
• Events are emitted via event_emit tool calls (a future HTTP webhook ingestion endpoint is planned but not yet available).

Install Procedure

1. Open workflow-routines.md.
2. For each template block:

• replace placeholders ({{repository}}, {{maintainers}}, branch names)
• call routine_create

3. If a routine already exists:

• use routine_update instead of creating duplicates
• keep names stable so long-lived metrics/history stay intact

4. Confirm install with routine_list and routine_history.

Routine Set

Install these routines:

• wf-issue-plan: on issue.opened or issue.reopened, generate implementation plan comment/checklist.
• wf-maintainer-comment-gate: on maintainer comments, decide update-plan vs start implementation.
• wf-pr-monitor-loop: on PR open/sync/review-comment/review, address feedback and refresh branch.
• wf-ci-fix-loop: on CI status/check failures, apply fixes and push updates.
• wf-staging-batch-review: every 8h, review ready PRs, merge into staging, run deep batch correctness analysis, fix findings, then merge staging -> main.
• wf-learning-memory: on merged PRs, extract mistakes/lessons and write to shared memory.

Event Filters

Prefer top-level filters for stability:

• repository (string)
• sender (string)
• issue_number / pr_number
• ci_status, ci_conclusion
• review_state, comment_author

Use narrow filters to avoid accidental triggers across repos.

Operating Rules

• All implementation work must occur on non-main branches.
• PR loop must resolve both human and AI review comments.
• On conflicts with origin/main, refresh branch before continuing.
• Staging-batch routine is the only path for bulk correctness verification before mainline merge.
• Memory update routine runs only after successful merge.

Validation

After install, run:

1. event_emit with a synthetic issue.opened payload for the target repo.
2. Confirm at least one routine fired.
3. Check corresponding routine_history entries.
4. Confirm no unrelated routines fired.

When To Update Templates

Update this skill when:

• GitHub event names/payload fields change.
• Team review policy changes (e.g., staging cadence, maintainer gates).
• New CI policy requires different failure routing.