@codedrifters/configulator 0.0.183 → 0.0.184

package/lib/index.mjs

@@ -1245,6 +1245,558 @@ var meetingAnalysisBundle = {
   subAgents: [meetingAnalystSubAgent]
 };
 
+// src/agent/bundles/orchestrator.ts
+var checkBlockedProcedure = {
+  name: "check-blocked.sh",
+  description: "Token-efficient issue triage script with subcommands: eligible, unblock, stale, orphaned, prs",
+  content: [
+    "#!/usr/bin/env bash",
+    "# check-blocked.sh \u2014 Token-efficient issue triage for agent loops.",
+    "# Replaces inline body-parsing with shell pipelines that return only",
+    "# actionable summaries.",
+    "#",
+    "# Usage:",
+    "#   .claude/procedures/check-blocked.sh unblock",
+    "#   .claude/procedures/check-blocked.sh eligible",
+    "#   .claude/procedures/check-blocked.sh stale",
+    "#   .claude/procedures/check-blocked.sh orphaned",
+    "#   .claude/procedures/check-blocked.sh prs",
+    "",
+    "set -uo pipefail",
+    "",
+    "# \u2500\u2500 constants \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
+    "",
+    "STALE_IN_PROGRESS_HOURS=72",
+    "STALE_BLOCKED_HOURS=168",
+    "",
+    "# \u2500\u2500 helpers \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
+    "",
+    '# Extract issue numbers from a "Depends on:" line.',
+    '# Returns space-separated numbers, or empty string for "(none)".',
+    "parse_deps() {",
+    '  local line="$1"',
+    `  if echo "$line" | grep -qi '(none)'; then`,
+    '    echo ""',
+    "    return",
+    "  fi",
+    `  echo "$line" | grep -oE '#[0-9]+' | tr -d '#' | tr '\\n' ' ' || echo ""`,
+    "}",
+    "",
+    "# Check if a single issue is closed. Returns 0 if closed, 1 if open.",
+    "is_closed() {",
+    "  local state",
+    `  state=$(gh issue view "$1" --json state --jq '.state' 2>/dev/null || echo "UNKNOWN")`,
+    '  [[ "$state" == "CLOSED" ]]',
+    "}",
+    "",
+    "# \u2500\u2500 subcommands \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
+    "",
+    "cmd_unblock() {",
+    "  local issues",
+    '  issues=$(gh issue list --label "status:blocked" --state open \\',
+    '    --json number,body --limit 50 2>/dev/null || echo "[]")',
+    "",
+    "  local count",
+    `  count=$(echo "$issues" | jq 'length')`,
+    '  if [[ "$count" -eq 0 ]]; then',
+    '    echo "NO_BLOCKED_ISSUES"',
+    "    return 0",
+    "  fi",
+    "",
+    "  local issue_data",
+    `  issue_data=$(echo "$issues" | jq -r '`,
+    "    .[] |",
+    '    (.body | split("\\n") | map(select(test("Depends on:"; "i"))) | .[0] // "") as $dep_line |',
+    '    "\\(.number)\\t\\($dep_line)"',
+    "  ')",
+    "",
+    "  while IFS=$'\\t' read -r num dep_line; do",
+    '    [[ -z "$num" ]] && continue',
+    "",
+    '    if [[ -z "$dep_line" ]]; then',
+    '      echo "BLOCKED #${num} \u2014 no Depends on field found"',
+    "      continue",
+    "    fi",
+    "",
+    "    local deps",
+    '    deps=$(parse_deps "$dep_line")',
+    '    if [[ -z "${deps// /}" ]]; then',
+    '      echo "UNBLOCK #${num} \u2014 no dependencies"',
+    "      continue",
+    "    fi",
+    "",
+    "    local all_closed=true",
+    '    local open_deps=""',
+    '    local closed_deps=""',
+    "    for dep in $deps; do",
+    '      if is_closed "$dep"; then',
+    '        closed_deps="${closed_deps}#${dep} "',
+    "      else",
+    "        all_closed=false",
+    '        open_deps="${open_deps}#${dep} "',
+    "      fi",
+    "    done",
+    "",
+    "    if $all_closed; then",
+    '      echo "UNBLOCK #${num} \u2014 all deps closed (${closed_deps% })"',
+    "    else",
+    '      echo "BLOCKED #${num} \u2014 waiting on ${open_deps% }"',
+    "    fi",
+    '  done <<< "$issue_data"',
+    "}",
+    "",
+    "cmd_eligible() {",
+    "  local issues",
+    '  issues=$(gh issue list --label "status:ready" --state open \\',
+    '    --search "sort:created-asc" \\',
+    '    --json number,title,body,labels --limit 50 2>/dev/null || echo "[]")',
+    "",
+    "  local count",
+    `  count=$(echo "$issues" | jq 'length')`,
+    '  if [[ "$count" -eq 0 ]]; then',
+    '    echo "NO_READY_ISSUES"',
+    "    return 0",
+    "  fi",
+    "",
+    "  local issue_data",
+    `  issue_data=$(echo "$issues" | jq -r '`,
+    "    .[] |",
+    '    (.body | split("\\n") | map(select(test("Depends on:"; "i"))) | .[0] // "") as $dep_line |',
+    '    (.labels | map(.name) | join(",")) as $label_str |',
+    '    (.labels | map(.name) | map(select(startswith("type:"))) | .[0] // "") as $type_label |',
+    '    "\\(.number)\\t\\(.title)\\t\\($dep_line)\\t\\($label_str)\\t\\($type_label)"',
+    "  ')",
+    "",
+    '  local results=""',
+    "  while IFS=$'\\t' read -r num title dep_line labels_str type_label; do",
+    '    [[ -z "$num" ]] && continue',
+    "",
+    '    local deps=""',
+    '    if [[ -n "$dep_line" ]]; then',
+    '      deps=$(parse_deps "$dep_line")',
+    "    fi",
+    "",
+    "    # Check if any dep is still open.",
+    "    local has_open_dep=false",
+    '    local open_deps=""',
+    '    if [[ -n "${deps// /}" ]]; then',
+    "      for dep in $deps; do",
+    '        if ! is_closed "$dep"; then',
+    "          has_open_dep=true",
+    '          open_deps="${open_deps}#${dep} "',
+    "        fi",
+    "      done",
+    "    fi",
+    "",
+    "    if $has_open_dep; then",
+    '      echo "SKIP #${num} \u2014 dep ${open_deps% } still open"',
+    "      continue",
+    "    fi",
+    "",
+    "    # 5-level priority sort key.",
+    "    local sort_key=2",
+    '    local priority="medium"',
+    '    case "$labels_str" in',
+    '      *priority:critical*) sort_key=0; priority="critical" ;;',
+    '      *priority:high*)     sort_key=1; priority="high" ;;',
+    '      *priority:medium*)   sort_key=2; priority="medium" ;;',
+    '      *priority:low*)      sort_key=3; priority="low" ;;',
+    '      *priority:trivial*)  sort_key=4; priority="trivial" ;;',
+    "    esac",
+    "",
+    '    local label_info=""',
+    '    [[ -n "$type_label" ]] && label_info=" ${type_label}"',
+    "",
+    '    results="${results}${sort_key}\\t${num}\\tPICK #${num} priority:${priority}${label_info} \\"${title}\\"\\n"',
+    '  done <<< "$issue_data"',
+    "",
+    "  # Sort by priority, then issue number (FIFO).",
+    '  if [[ -n "$results" ]]; then',
+    `    printf '%b' "$results" | sort -t$'\\t' -k1,1n -k2,2n | cut -f3`,
+    "  fi",
+    "}",
+    "",
+    "cmd_stale() {",
+    "  # Check in-progress issues",
+    "  local ip_issues",
+    '  ip_issues=$(gh issue list --label "status:in-progress" --state open \\',
+    '    --json number,title,updatedAt --limit 50 2>/dev/null || echo "[]")',
+    "",
+    "  local ip_count",
+    `  ip_count=$(echo "$ip_issues" | jq 'length')`,
+    "",
+    '  if [[ "$ip_count" -gt 0 ]]; then',
+    "    local ip_threshold",
+    "    ip_threshold=$(date -u -v-${STALE_IN_PROGRESS_HOURS}H +%Y-%m-%dT%H:%M:%S 2>/dev/null \\",
+    '      || date -u -d "${STALE_IN_PROGRESS_HOURS} hours ago" +%Y-%m-%dT%H:%M:%S 2>/dev/null)',
+    "",
+    "    local ip_data",
+    `    ip_data=$(echo "$ip_issues" | jq -r '.[] | "\\(.number)\\t\\(.title)\\t\\(.updatedAt)"')`,
+    "",
+    "    while IFS=$'\\t' read -r num title updated; do",
+    '      [[ -z "$num" ]] && continue',
+    '      local updated_trimmed="${updated%%+*}"',
+    '      updated_trimmed="${updated_trimmed%%Z*}"',
+    '      if [[ "$updated_trimmed" < "$ip_threshold" ]]; then',
+    '        local date_part="${updated_trimmed%%T*}"',
+    '        echo "STALE #${num} \u2014 no activity since ${date_part} \u2014 \\"${title}\\""',
+    "      fi",
+    '    done <<< "$ip_data"',
+    "  fi",
+    "",
+    "  # Check blocked issues",
+    "  local bl_issues",
+    '  bl_issues=$(gh issue list --label "status:blocked" --state open \\',
+    '    --json number,title,updatedAt --limit 50 2>/dev/null || echo "[]")',
+    "",
+    "  local bl_count",
+    `  bl_count=$(echo "$bl_issues" | jq 'length')`,
+    "",
+    '  if [[ "$bl_count" -gt 0 ]]; then',
+    "    local bl_threshold",
+    "    bl_threshold=$(date -u -v-${STALE_BLOCKED_HOURS}H +%Y-%m-%dT%H:%M:%S 2>/dev/null \\",
+    '      || date -u -d "${STALE_BLOCKED_HOURS} hours ago" +%Y-%m-%dT%H:%M:%S 2>/dev/null)',
+    "",
+    "    local bl_data",
+    `    bl_data=$(echo "$bl_issues" | jq -r '.[] | "\\(.number)\\t\\(.title)\\t\\(.updatedAt)"')`,
+    "",
+    "    while IFS=$'\\t' read -r num title updated; do",
+    '      [[ -z "$num" ]] && continue',
+    '      local updated_trimmed="${updated%%+*}"',
+    '      updated_trimmed="${updated_trimmed%%Z*}"',
+    '      if [[ "$updated_trimmed" < "$bl_threshold" ]]; then',
+    '        local date_part="${updated_trimmed%%T*}"',
+    '        echo "STALE_BLOCKED #${num} \u2014 blocked since ${date_part} \u2014 \\"${title}\\""',
+    "      fi",
+    '    done <<< "$bl_data"',
+    "  fi",
+    "",
+    '  if [[ "$ip_count" -eq 0 && "$bl_count" -eq 0 ]]; then',
+    '    echo "NO_STALE_ISSUES"',
+    "  fi",
+    "}",
+    "",
+    "cmd_orphaned() {",
+    "  # Check for remote branches whose issues are closed or missing",
+    "  git fetch --prune origin 2>/dev/null",
+    "  local branches",
+    '  branches=$(git branch -r --format="%(refname:short)" | grep -v HEAD | sed "s|origin/||")',
+    "",
+    "  local found_orphan=false",
+    "  while IFS= read -r branch; do",
+    '    [[ -z "$branch" ]] && continue',
+    '    [[ "$branch" == "main" || "$branch" == "master" ]] && continue',
+    "",
+    "    # Extract issue number from branch name (e.g., feat/42-add-login \u2192 42)",
+    "    local issue_num",
+    `    issue_num=$(echo "$branch" | grep -oE '/[0-9]+' | tr -d '/' | head -1)`,
+    '    [[ -z "$issue_num" ]] && continue',
+    "",
+    "    local state",
+    `    state=$(gh issue view "$issue_num" --json state --jq '.state' 2>/dev/null || echo "NOT_FOUND")`,
+    "",
+    '    if [[ "$state" == "CLOSED" ]]; then',
+    "      found_orphan=true",
+    '      echo "ORPHAN_BRANCH ${branch} \u2014 issue #${issue_num} is closed"',
+    '    elif [[ "$state" == "NOT_FOUND" ]]; then',
+    "      found_orphan=true",
+    '      echo "ORPHAN_BRANCH ${branch} \u2014 issue #${issue_num} not found"',
+    "    fi",
+    '  done <<< "$branches"',
+    "",
+    "  # Check for open PRs whose linked issues are closed",
+    "  local prs",
+    '  prs=$(gh pr list --state open --json number,title,body --limit 50 2>/dev/null || echo "[]")',
+    "  local pr_data",
+    `  pr_data=$(echo "$prs" | jq -r '`,
+    "    .[] |",
+    '    (.body | capture("(?:Closes|Fixes|Resolves) #(?<num>[0-9]+)") | .num) as $issue |',
+    '    "\\(.number)\\t\\(.title)\\t\\($issue // "")"',
+    "  ' 2>/dev/null)",
+    "",
+    "  while IFS=$'\\t' read -r pr_num title issue_num; do",
+    '    [[ -z "$pr_num" || -z "$issue_num" ]] && continue',
+    '    if is_closed "$issue_num"; then',
+    "      found_orphan=true",
+    '      echo "ORPHAN_PR #${pr_num} \u2014 linked issue #${issue_num} is closed \u2014 \\"${title}\\""',
+    "    fi",
+    '  done <<< "$pr_data"',
+    "",
+    "  if ! $found_orphan; then",
+    '    echo "NO_ORPHANED_RESOURCES"',
+    "  fi",
+    "}",
+    "",
+    "cmd_prs() {",
+    "  local prs",
+    "  prs=$(gh pr list --state open --json number,title,isDraft,headRefName,labels,body \\",
+    '    --limit 50 2>/dev/null || echo "[]")',
+    "",
+    "  local count",
+    `  count=$(echo "$prs" | jq 'length')`,
+    '  if [[ "$count" -eq 0 ]]; then',
+    '    echo "NO_OPEN_PRS"',
+    "    return 0",
+    "  fi",
+    "",
+    "  # Filter: not draft, no needs-attention label.",
+    "  local eligible",
+    `  eligible=$(echo "$prs" | jq -r '`,
+    "    .[] |",
+    "    select(.isDraft == false) |",
+    '    select(.labels | map(.name) | index("status:needs-attention") | not) |',
+    '    (.body | capture("(?:Closes|Fixes|Resolves) #(?<num>[0-9]+)") | .num) as $issue |',
+    '    "\\(.number)\\t\\(.title)\\t\\(.headRefName)\\t\\($issue // "")"',
+    "  ' 2>/dev/null)",
+    "",
+    '  if [[ -z "$eligible" ]]; then',
+    '    echo "NO_ELIGIBLE_PRS"',
+    "    return 0",
+    "  fi",
+    "",
+    "  while IFS=$'\\t' read -r pr_num title branch issue_num; do",
+    '    [[ -z "$pr_num" ]] && continue',
+    "",
+    '    if [[ -z "$issue_num" ]]; then',
+    '      echo "SKIP PR #${pr_num} \u2014 no linked issue \u2014 \\"${title}\\""',
+    "      continue",
+    "    fi",
+    "",
+    "    # Check CI status",
+    "    local failing_checks",
+    '    failing_checks=$(gh pr checks "$pr_num" --json name,state \\',
+    `      --jq '[.[] | select(.state != "SUCCESS" and .state != "SKIPPED")] | length' 2>/dev/null || echo "-1")`,
+    "",
+    '    if [[ "$failing_checks" == "-1" ]]; then',
+    '      echo "SKIP PR #${pr_num} \u2014 could not read CI status \u2014 \\"${title}\\""',
+    "      continue",
+    "    fi",
+    "",
+    '    if [[ "$failing_checks" -gt 0 ]]; then',
+    '      echo "SKIP PR #${pr_num} \u2014 ${failing_checks} CI check(s) not passing \u2014 \\"${title}\\""',
+    "      continue",
+    "    fi",
+    "",
+    "    # Check if already approved",
+    "    local approved",
+    '    approved=$(gh pr view "$pr_num" --json reviews \\',
+    `      --jq '[.reviews[] | select(.state == "APPROVED")] | length' 2>/dev/null || echo "0")`,
+    '    if [[ "$approved" -gt 0 ]]; then',
+    '      echo "SKIP PR #${pr_num} \u2014 already approved \u2014 \\"${title}\\""',
+    "      continue",
+    "    fi",
+    "",
+    '    echo "REVIEW PR #${pr_num} issue:#${issue_num} branch:${branch} \u2014 \\"${title}\\""',
+    '  done <<< "$eligible"',
+    "}",
+    "",
+    "# \u2500\u2500 main \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
+    "",
+    'case "${1:-help}" in',
+    '  unblock)   shift; cmd_unblock "$@" ;;',
+    '  eligible)  shift; cmd_eligible "$@" ;;',
+    '  stale)     shift; cmd_stale "$@" ;;',
+    '  orphaned)  shift; cmd_orphaned "$@" ;;',
+    '  prs)       shift; cmd_prs "$@" ;;',
+    "  help|*)",
+    '    echo "Usage: check-blocked.sh <unblock|eligible|stale|orphaned|prs>"',
+    "    exit 1",
+    "    ;;",
+    "esac"
+  ].join("\n")
+};
+var orchestratorSubAgent = {
+  name: "orchestrator",
+  description: "Pipeline manager that reviews PRs, triages issues, and identifies the next work item \u2014 never implements code",
+  model: AGENT_MODEL.POWERFUL,
+  maxTurns: 100,
+  platforms: { cursor: { exclude: true } },
+  prompt: [
+    "# Orchestrator Agent",
+    "",
+    "You are a pipeline manager for the **{{repository.owner}}/{{repository.name}}** repository.",
+    "You review PRs, triage issues, and identify the next work item. You **never**",
+    "implement code, create branches for issues, or claim issues.",
+    "",
+    "Run the same loop every invocation. Execute all phases in order.",
+    "",
+    "---",
+    "",
+    "## Phase A: Startup",
+    "",
+    "```bash",
+    "git checkout main && git pull origin main",
+    "```",
+    "",
+    "## Phase B: Batch PR Review",
+    "",
+    "Find all PRs eligible for review:",
+    "",
+    "```bash",
+    ".claude/procedures/check-blocked.sh prs",
+    "```",
+    "",
+    "For each `REVIEW PR #N issue:#M branch:<branch>` line:",
+    "",
+    "1. Check out the PR branch: `gh pr checkout N`",
+    "2. Review the PR:",
+    "   - Read the PR description and linked issue: `gh pr view N`",
+    "   - Review the diff: `gh pr diff N`",
+    "   - Check all changed files for correctness, conventions, and test coverage",
+    "   - Verify PR conventions: conventional commit title, closing keyword, summary present",
+    "   - Check CI status: `gh pr checks N`",
+    "3. If the PR passes review:",
+    "   - Approve: `gh pr review N --approve --body '<summary>'`",
+    "   - Enable auto-merge: `gh pr merge N --auto --squash`",
+    "4. If the PR fails review:",
+    "   - Request changes: `gh pr review N --request-changes --body '<findings>'`",
+    "5. After each PR (whether merged or not):",
+    "   ```bash",
+    "   git checkout main && git pull origin main",
+    "   ```",
+    "",
+    "Skip lines starting with `SKIP` \u2014 those PRs are not eligible.",
+    "If output is `NO_OPEN_PRS` or `NO_ELIGIBLE_PRS`, skip to Phase C.",
+    "",
+    "## Phase C: Triage \u2014 Unblock",
+    "",
+    "Check for blocked issues whose dependencies have resolved:",
+    "",
+    "```bash",
+    ".claude/procedures/check-blocked.sh unblock",
+    "```",
+    "",
+    "For each `UNBLOCK #N` line:",
+    "```bash",
+    'gh issue edit N --remove-label "status:blocked" --add-label "status:ready"',
+    'gh issue comment N --body "Dependencies resolved \u2014 unblocking."',
+    "```",
+    "",
+    "For `BLOCKED #N \u2014 no Depends on field found`: leave as-is (Phase D will",
+    "catch it if it's been blocked too long).",
+    "",
+    "If output is `NO_BLOCKED_ISSUES`, skip to Phase D.",
+    "",
+    "## Phase D: Maintenance",
+    "",
+    "### D1: Stale Detection",
+    "",
+    "```bash",
+    ".claude/procedures/check-blocked.sh stale",
+    "```",
+    "",
+    "For each `STALE #N` line (in-progress >72h without activity):",
+    "```bash",
+    'gh issue edit N --add-label "status:needs-attention"',
+    'gh issue comment N --body "Flagged: in-progress for >3 days with no activity."',
+    "```",
+    "",
+    "For each `STALE_BLOCKED #N` line (blocked >168h):",
+    "```bash",
+    'gh issue edit N --add-label "status:needs-attention"',
+    'gh issue comment N --body "Flagged: blocked for >7 days \u2014 may need human intervention."',
+    "```",
+    "",
+    "**Important:** Do NOT auto-reset stale issues to `status:ready` \u2014 partial",
+    "implementation work may exist on a branch.",
+    "",
+    "### D2: Orphaned Detection",
+    "",
+    "```bash",
+    ".claude/procedures/check-blocked.sh orphaned",
+    "```",
+    "",
+    "Report any `ORPHAN_BRANCH` or `ORPHAN_PR` lines. These indicate branches",
+    "or PRs whose linked issues are closed or missing. Log them for visibility",
+    "but do not delete branches automatically.",
+    "",
+    "### D3: Needs-Attention Summary",
+    "",
+    "List all issues currently flagged:",
+    "```bash",
+    'gh issue list --label "status:needs-attention" --state open --json number,title',
+    "```",
+    "",
+    "Log the count and titles for operator visibility.",
+    "",
+    "## Phase E: Queue Scan",
+    "",
+    "Find the highest-priority ready issue:",
+    "",
+    "```bash",
+    ".claude/procedures/check-blocked.sh eligible",
+    "```",
+    "",
+    "If a `PICK` line is returned, report it as:",
+    "```",
+    'NEXT_WORK_ITEM #<number> priority:<level> type:<label> "<title>"',
+    "```",
+    "",
+    "If output is `NO_READY_ISSUES`, report that the queue is empty.",
+    "",
+    "**Do NOT claim the issue, create a branch, or start implementation.**",
+    "The worker agent handles that.",
+    "",
+    "## Phase F: Cleanup",
+    "",
+    "```bash",
+    "git checkout main && git pull origin main",
+    "git fetch --prune origin",
+    "```",
+    "",
+    "Log completion: phases executed, PRs reviewed, issues unblocked,",
+    "stale issues flagged, and next work item (if any).",
+    "",
+    "---",
+    "",
+    "## Rules",
+    "",
+    "1. **Never implement code.** You triage, review, and report \u2014 you do not code.",
+    "2. **Never claim issues.** Do not add `status:in-progress` or create branches for issues.",
+    "3. **Always use check-blocked.sh.** All triage queries go through the shell script for token efficiency.",
+    "4. **Follow CLAUDE.md conventions** for all git and gh operations.",
+    "5. **Priority order:** critical > high > medium > low > trivial, then FIFO by issue number."
+  ].join("\n")
+};
+var orchestratorBundle = {
+  name: "orchestrator",
+  description: "Pipeline orchestrator agent for issue triage, PR review, and queue management",
+  // Always included by default
+  appliesWhen: () => true,
+  rules: [
+    {
+      name: "orchestrator-conventions",
+      description: "Guidelines for orchestrator agent behavior and pipeline management",
+      scope: AGENT_RULE_SCOPE.ALWAYS,
+      content: [
+        "# Orchestrator Conventions",
+        "",
+        "When running the orchestrator agent (`.claude/agents/orchestrator.md`):",
+        "",
+        "- The orchestrator **never** implements code or creates branches for issues",
+        "- It reviews PRs, triages issues, and reports the next work item",
+        "- All triage queries use `.claude/procedures/check-blocked.sh` for token efficiency",
+        "- Priority order: critical > high > medium > low > trivial, then FIFO",
+        "- Stale thresholds: 72h for in-progress, 168h for blocked",
+        "- Flagged issues get `status:needs-attention` \u2014 they are not auto-reset"
+      ].join("\n"),
+      platforms: {
+        claude: { target: "claude-md" },
+        cursor: { exclude: true }
+      },
+      tags: ["workflow"]
+    }
+  ],
+  subAgents: [orchestratorSubAgent],
+  procedures: [checkBlockedProcedure],
+  claudePermissions: {
+    allow: [
+      // Allow executing the check-blocked.sh procedure
+      "Bash(.claude/procedures/*.sh *)"
+    ]
+  }
+};
+
 // src/pnpm/pnpm-workspace.ts
 import { relative } from "path";
 import { Component, YamlFile } from "projen";
@@ -2262,7 +2814,8 @@ var BUILT_IN_BUNDLES = [
   projenBundle,
   githubWorkflowBundle,
   slackBundle,
-  meetingAnalysisBundle
+  meetingAnalysisBundle,
+  orchestratorBundle
 ];
 
 // src/agent/bundles/scope.ts
@@ -2385,12 +2938,15 @@ var ClaudeRenderer = class _ClaudeRenderer {
   /**
    * Render all Claude Code configuration files.
    */
-  static render(component, rules, skills, subAgents, mcpServers, settings) {
+  static render(component, rules, skills, subAgents, mcpServers, settings, procedures) {
     _ClaudeRenderer.renderClaudeMd(component, rules);
     _ClaudeRenderer.renderScopedRules(component, rules);
     _ClaudeRenderer.renderSettings(component, mcpServers, settings);
     _ClaudeRenderer.renderSkills(component, skills);
     _ClaudeRenderer.renderSubAgents(component, subAgents);
+    if (procedures && procedures.length > 0) {
+      _ClaudeRenderer.renderProcedures(component, procedures);
+    }
   }
   static renderClaudeMd(component, rules) {
     const claudeMdRules = rules.filter((r) => {
@@ -2707,6 +3263,14 @@ var ClaudeRenderer = class _ClaudeRenderer {
     if (config.env) server.env = { ...config.env };
     return server;
   }
+  static renderProcedures(component, procedures) {
+    for (const proc of procedures) {
+      new TextFile2(component, `.claude/procedures/${proc.name}`, {
+        lines: proc.content.split("\n"),
+        executable: true
+      });
+    }
+  }
   /**
    * Determine the default Claude rule target based on rule scope.
    * ALWAYS-scoped rules default to CLAUDE_MD; FILE_PATTERN rules default to SCOPED_FILE.
@@ -3060,6 +3624,7 @@ var AgentConfig = class _AgentConfig extends Component8 {
     const rules = this.resolveRules();
     const skills = this.resolveSkills();
     const subAgents = this.resolveSubAgents();
+    const procedures = this.resolveProcedures();
     const mcpServers = this.options.mcpServers ?? {};
     const projectMetadata = ProjectMetadata.of(this.project);
     const metadata = projectMetadata?.metadata;
@@ -3069,6 +3634,10 @@ var AgentConfig = class _AgentConfig extends Component8 {
       subAgents,
       metadata
     );
+    const resolvedProcedures = this.resolveProcedureTemplates(
+      procedures,
+      metadata
+    );
     if (platforms.includes(AGENT_PLATFORM.CURSOR)) {
       CursorRenderer.render(
         this,
@@ -3090,7 +3659,8 @@ var AgentConfig = class _AgentConfig extends Component8 {
         _AgentConfig.mergeClaudeDefaults(
           this.options.claudeSettings,
           bundlePermissions
-        )
+        ),
+        resolvedProcedures
       );
     }
     if (platforms.includes(AGENT_PLATFORM.CODEX)) {
@@ -3203,6 +3773,16 @@ ${extra}`
         }
       }
     }
+    if (this.options.includeBundles) {
+      for (const bundleName of this.options.includeBundles) {
+        const bundle = BUILT_IN_BUNDLES.find((b) => b.name === bundleName);
+        if (bundle?.skills) {
+          for (const skill of bundle.skills) {
+            skillMap.set(skill.name, skill);
+          }
+        }
+      }
+    }
     if (this.options.skills) {
       for (const skill of this.options.skills) {
         skillMap.set(skill.name, skill);
@@ -3222,6 +3802,16 @@ ${extra}`
         }
       }
     }
+    if (this.options.includeBundles) {
+      for (const bundleName of this.options.includeBundles) {
+        const bundle = BUILT_IN_BUNDLES.find((b) => b.name === bundleName);
+        if (bundle?.subAgents) {
+          for (const agent of bundle.subAgents) {
+            agentMap.set(agent.name, agent);
+          }
+        }
+      }
+    }
     if (this.options.subAgents) {
       for (const agent of this.options.subAgents) {
         agentMap.set(agent.name, agent);
@@ -3229,6 +3819,35 @@ ${extra}`
     }
     return [...agentMap.values()];
   }
+  resolveProcedures() {
+    const procMap = /* @__PURE__ */ new Map();
+    if (this.options.autoDetectBundles !== false) {
+      for (const bundle of BUILT_IN_BUNDLES) {
+        if (this.options.excludeBundles?.includes(bundle.name)) continue;
+        if (bundle.appliesWhen(this.project) && bundle.procedures) {
+          for (const proc of bundle.procedures) {
+            procMap.set(proc.name, proc);
+          }
+        }
+      }
+    }
+    if (this.options.includeBundles) {
+      for (const bundleName of this.options.includeBundles) {
+        const bundle = BUILT_IN_BUNDLES.find((b) => b.name === bundleName);
+        if (bundle?.procedures) {
+          for (const proc of bundle.procedures) {
+            procMap.set(proc.name, proc);
+          }
+        }
+      }
+    }
+    if (this.options.procedures) {
+      for (const proc of this.options.procedures) {
+        procMap.set(proc.name, proc);
+      }
+    }
+    return [...procMap.values()];
+  }
   /**
    * Resolves template variables in rule content using project metadata.
    * Emits synthesis warnings for rules with unresolved variables.
@@ -3281,6 +3900,23 @@ ${extra}`
       return resolved !== agent.prompt ? { ...agent, prompt: resolved } : agent;
     });
   }
+  /**
+   * Resolves template variables in procedure content using project metadata.
+   */
+  resolveProcedureTemplates(procedures, metadata) {
+    return procedures.map((proc) => {
+      const { resolved, unresolvedKeys } = resolveTemplateVariables(
+        proc.content,
+        metadata
+      );
+      if (unresolvedKeys.length > 0) {
+        this.project.logger.warn(
+          `AgentConfig: ProjectMetadata not found; procedure '${proc.name}' using default values`
+        );
+      }
+      return resolved !== proc.content ? { ...proc, content: resolved } : proc;
+    });
+  }
   /**
    * Collects Claude permission entries from all active bundles.
    */
@@ -4968,6 +5604,7 @@ export {
   githubWorkflowBundle,
   jestBundle,
   meetingAnalysisBundle,
+  orchestratorBundle,
   pnpmBundle,
   projenBundle,
   resolveModelAlias,