@codedrifters/configulator 0.0.405 → 0.0.406

package/lib/index.mjs

@@ -280,6 +280,603 @@ function renderClaimVerificationSection() {
   ];
 }
 
+// src/agent/bundles/bundle-ownership.ts
+var BUNDLE_OWNERSHIP = {
+  agenda: {
+    typeLabels: ["agenda"],
+    phaseLabelPrefixes: ["agenda:"],
+    scheduledTaskIds: ["worker-agenda"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "bcm-writer": {
+    typeLabels: ["bcm-document"],
+    phaseLabelPrefixes: ["bcm:"],
+    scheduledTaskIds: ["worker-bcm-writer"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "business-models": {
+    typeLabels: ["business-model"],
+    phaseLabelPrefixes: ["business-models:"],
+    scheduledTaskIds: ["worker-business-models"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "company-profile": {
+    typeLabels: ["company-profile"],
+    phaseLabelPrefixes: ["company:"],
+    scheduledTaskIds: ["worker-company-profile"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "customer-profile": {
+    typeLabels: ["customer-profile"],
+    phaseLabelPrefixes: ["customer:"],
+    scheduledTaskIds: ["worker-customer-profile"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "docs-sync": {
+    typeLabels: ["docs-sync"],
+    phaseLabelPrefixes: ["docs-sync:"],
+    scheduledTaskIds: ["worker-docs-sync"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "industry-discovery": {
+    typeLabels: ["industry-discovery"],
+    phaseLabelPrefixes: ["industry:"],
+    scheduledTaskIds: ["worker-industry-discovery"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "maintenance-audit": {
+    typeLabels: ["maintenance"],
+    phaseLabelPrefixes: ["maint:"],
+    scheduledTaskIds: ["worker-maintenance"],
+    emitsDocs: false,
+    downstreamIssueKinds: true
+  },
+  "meeting-analysis": {
+    typeLabels: ["meeting-processing"],
+    phaseLabelPrefixes: ["meeting:"],
+    scheduledTaskIds: ["worker-meeting-analysis"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  orchestrator: {
+    // The orchestrator pipeline manager itself ships with the
+    // `worker-orchestrator` scheduled task. It owns no `type:*` label
+    // (it dispatches every type) and no phase-label prefix.
+    typeLabels: [],
+    phaseLabelPrefixes: [],
+    scheduledTaskIds: ["worker-orchestrator"],
+    emitsDocs: false,
+    downstreamIssueKinds: false
+  },
+  "people-profile": {
+    typeLabels: ["people-profile"],
+    phaseLabelPrefixes: ["people:"],
+    scheduledTaskIds: ["worker-people-profile"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "pr-review": {
+    typeLabels: ["pr-review"],
+    phaseLabelPrefixes: [],
+    scheduledTaskIds: ["worker-pr-review"],
+    emitsDocs: false,
+    downstreamIssueKinds: false
+  },
+  "regulatory-research": {
+    typeLabels: ["regulatory-research"],
+    phaseLabelPrefixes: ["regulatory:"],
+    scheduledTaskIds: ["worker-regulatory-research"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "requirements-analyst": {
+    typeLabels: ["requirement"],
+    phaseLabelPrefixes: ["req:"],
+    scheduledTaskIds: ["worker-requirements-analyst"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "requirements-reviewer": {
+    // Co-owns `type:requirement` with the analyst and writer; owns
+    // the `req:review` and `req:deprecate` phase labels exactly.
+    typeLabels: ["requirement"],
+    phaseLabelPrefixes: ["req:review", "req:deprecate"],
+    scheduledTaskIds: ["worker-requirements-reviewer"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "requirements-writer": {
+    // Co-owns `type:requirement` with the analyst and reviewer; owns
+    // the `req:write` phase label exactly.
+    typeLabels: ["requirement"],
+    phaseLabelPrefixes: ["req:write"],
+    scheduledTaskIds: ["worker-requirements-writer"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "research-pipeline": {
+    typeLabels: ["research"],
+    phaseLabelPrefixes: ["research:"],
+    scheduledTaskIds: ["worker-research"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "software-profile": {
+    typeLabels: ["software-profile"],
+    phaseLabelPrefixes: ["software:"],
+    scheduledTaskIds: ["worker-software-profile"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  },
+  "standards-research": {
+    typeLabels: ["standards-research"],
+    phaseLabelPrefixes: ["standards:"],
+    scheduledTaskIds: ["worker-standards-research"],
+    emitsDocs: true,
+    downstreamIssueKinds: true
+  }
+};
+var CONVENTIONAL_COMMIT_TYPE_LABELS = [
+  "type:chore",
+  "type:docs",
+  "type:feat",
+  "type:fix",
+  "type:hotfix",
+  "type:refactor",
+  "type:release"
+];
+var PHASE_LABEL_TYPE_MAP = buildPhaseLabelTypeMap();
+function typeLabelForPhaseLabel(phaseLabel) {
+  const exact = PHASE_LABEL_TYPE_MAP[phaseLabel];
+  if (exact !== void 0 && !phaseLabel.endsWith(":")) {
+    return exact;
+  }
+  let bestMatcher;
+  for (const matcher of Object.keys(PHASE_LABEL_TYPE_MAP)) {
+    if (!matcher.endsWith(":")) {
+      continue;
+    }
+    if (!phaseLabel.startsWith(matcher)) {
+      continue;
+    }
+    if (bestMatcher === void 0 || matcher.length > bestMatcher.length) {
+      bestMatcher = matcher;
+    }
+  }
+  return bestMatcher === void 0 ? void 0 : PHASE_LABEL_TYPE_MAP[bestMatcher];
+}
+function resolveTypeLabelForLabels(labels) {
+  const phaseLabels = [];
+  const candidates = /* @__PURE__ */ new Set();
+  for (const label of labels) {
+    const typeLabel = typeLabelForPhaseLabel(label);
+    if (typeLabel === void 0) {
+      continue;
+    }
+    phaseLabels.push(label);
+    candidates.add(typeLabel);
+  }
+  const candidateTypeLabels = Array.from(candidates).sort();
+  if (candidateTypeLabels.length === 0) {
+    return { outcome: "none", candidateTypeLabels: [], phaseLabels: [] };
+  }
+  if (candidateTypeLabels.length === 1) {
+    return {
+      outcome: "match",
+      typeLabel: candidateTypeLabels[0],
+      candidateTypeLabels,
+      phaseLabels
+    };
+  }
+  return { outcome: "ambiguous", candidateTypeLabels, phaseLabels };
+}
+function renderPhaseTypeInvariantSection(excludeBundles = []) {
+  const rows = Object.keys(PHASE_LABEL_TYPE_MAP).filter(
+    (matcher) => !isPhaseLabelMatcherOwnedByExcluded(matcher, excludeBundles)
+  ).sort().map((matcher) => {
+    const display = matcher.endsWith(":") ? `${matcher}*` : matcher;
+    const kind = matcher.endsWith(":") ? "prefix" : "exact";
+    return `| \`${display}\` | ${kind} | \`${PHASE_LABEL_TYPE_MAP[matcher]}\` |`;
+  });
+  return [
+    "## Phase-label \u2192 `type:<bundle>` invariant",
+    "",
+    "Every phased-pipeline bundle pairs its `<bundle>:<phase>` labels",
+    "with exactly one `type:<bundle>` label. That type label is the",
+    "**dedup + dispatch signal**: agents de-duplicate downstream work",
+    'with `gh issue list --label "type:<bundle>"`, and Phase E derives',
+    "its funnel-tier sort key from the issue's `type:*` label. An issue",
+    "that carries the phase label but a conventional-commit `type:*`",
+    "(`type:feat`, `type:docs`, \u2026, stamped from its title prefix by the",
+    "generic create-issue workflow) is invisible to that dedup query and",
+    "mis-tiers in dispatch.",
+    "",
+    "The pairing below is derived from the canonical bundle-ownership",
+    "map \u2014 the same source of truth that generates the label registry.",
+    "Matchers ending in `*` match by prefix; the rest match exactly, and",
+    "an exact match always beats a prefix match.",
+    "",
+    "| Phase label | Match | Required type label |",
+    "|-------------|-------|---------------------|",
+    ...rows,
+    "",
+    "### Enforcement",
+    "",
+    "The Phase D maintenance sweep runs the invariant in auto-correct",
+    "mode and emits one summary line:",
+    "",
+    "```",
+    "LABEL_INVARIANT_DONE mode=fix checked=<N> ok=<O> violations=<V> corrected=<C> flagged=<F>",
+    "```",
+    "",
+    "A **report-only** audit is available for repos that prefer",
+    "report-then-fix over auto-correct \u2014 same sweep, no mutations:",
+    "",
+    "```bash",
+    ".claude/procedures/check-blocked.sh label-invariant        # report only",
+    ".claude/procedures/check-blocked.sh label-invariant --fix  # apply",
+    "```",
+    "",
+    "### Correction policy",
+    "",
+    "An issue must carry **exactly one** `type:*` label. Merely *adding*",
+    "the required type label to an issue that already carries a",
+    "conventional-commit one would leave two, making the funnel-tier sort",
+    "key (which reads the **first** `type:*` label) non-deterministic and",
+    "violating the label conventions. The correction therefore",
+    "**replaces**, in a single atomic `gh issue edit`, so the issue is",
+    "never observable carrying two `type:*` labels:",
+    "",
+    "| Issue state | Action |",
+    "|-------------|--------|",
+    "| Required type label present, nothing else | none \u2014 compliant, left untouched |",
+    "| No `type:*` label at all | **add** the required label |",
+    "| Only conventional-commit `type:*` label(s) | **replace** \u2014 remove them, add the required label |",
+    "| Required label present **plus** a stray conventional-commit one | **remove** the stray, leaving exactly one |",
+    "| A `type:*` label owned by a **different** bundle | **flag** `status:needs-attention` \u2014 never guessed at |",
+    "| Phase labels imply **two or more** type labels | **flag** `status:needs-attention` \u2014 never auto-corrected |",
+    "",
+    "Only a conventional-commit `type:*` label is ever removed. A",
+    "`type:*` label owned by another bundle carries real routing",
+    "information, so the sweep refuses to guess and hands the issue to a",
+    "human instead. Ambiguity is narrower than it looks: all three",
+    "requirements bundles declare `type:requirement`, so every `req:*`",
+    "phase label resolves to the same type label \u2014 genuine ambiguity",
+    "needs phase labels from two bundles with *different* type labels.",
+    "",
+    "`status:needs-attention` is applied **additively** \u2014 the base",
+    "`status:*` label always stays, per the additive-flag rule. Flagging",
+    "is idempotent: an issue already carrying the flag is reported but",
+    "not re-flagged."
+  ].join("\n");
+}
+function isPhaseLabelMatcherOwnedByExcluded(matcher, excludeBundles) {
+  if (excludeBundles.length === 0) {
+    return false;
+  }
+  let owned = false;
+  for (const [bundleName, ownership] of Object.entries(BUNDLE_OWNERSHIP)) {
+    if (!ownership.phaseLabelPrefixes.includes(matcher)) {
+      continue;
+    }
+    owned = true;
+    if (!excludeBundles.includes(bundleName)) {
+      return false;
+    }
+  }
+  return owned;
+}
+function renderPhaseTypeInvariantShellHelpers() {
+  const matchers = Object.keys(PHASE_LABEL_TYPE_MAP);
+  const exactMatchers = matchers.filter((m) => !m.endsWith(":")).sort();
+  const prefixMatchers = matchers.filter((m) => m.endsWith(":")).sort((a, b) => b.length - a.length || a.localeCompare(b));
+  const lines = [
+    "# Resolve ONE phase label to the `type:<bundle>` label its owning",
+    "# bundle declares. Echoes the label (with the `type:` prefix) or",
+    "# nothing when no bundle owns it. Exact-match branches come first,",
+    "# so `req:write` (requirements-writer) beats the `req:` prefix",
+    "# (requirements-analyst). Generated from BUNDLE_OWNERSHIP \u2014 do not",
+    "# hand-edit.",
+    "phase_label_type_of() {",
+    '  case "${1:-}" in'
+  ];
+  for (const matcher of exactMatchers) {
+    lines.push(`    ${matcher}) echo "${PHASE_LABEL_TYPE_MAP[matcher]}" ;;`);
+  }
+  for (const matcher of prefixMatchers) {
+    lines.push(`    ${matcher}*) echo "${PHASE_LABEL_TYPE_MAP[matcher]}" ;;`);
+  }
+  lines.push(
+    "    *) : ;;",
+    "  esac",
+    "}",
+    "",
+    "# Return 0 when the argument is a conventional-commit `type:*`",
+    "# label \u2014 the ONLY type labels the invariant correction may remove.",
+    "# A `type:*` label owned by another bundle is never removed; the",
+    "# issue is flagged for human triage instead.",
+    "is_conventional_type_label() {",
+    `  case "\${1:-}" in`,
+    `    ${CONVENTIONAL_COMMIT_TYPE_LABELS.join("|")}) return 0 ;;`,
+    "    *) return 1 ;;",
+    "  esac",
+    "}",
+    "",
+    "# Resolve an issue's FULL label list (one label per line on stdin)",
+    "# to the type label the phase-label invariant requires. Emits",
+    "# KEY=VALUE assignments the caller parses:",
+    "#   OUTCOME=none      \u2014 no recognised phase label; invariant N/A",
+    "#   OUTCOME=match     \u2014 plus TYPE_LABEL=<type:bundle>",
+    "#   OUTCOME=ambiguous \u2014 plus CANDIDATE_TYPE_LABELS=<space-separated>",
+    "#   PHASE_LABELS=<space-separated recognised phase labels>",
+    "phase_type_of() {",
+    "  local label resolved",
+    '  local matched_types=""',
+    '  local matched_phase=""',
+    "  while IFS= read -r label; do",
+    '    [ -z "$label" ] && continue',
+    '    resolved=$(phase_label_type_of "$label")',
+    '    [ -z "$resolved" ] && continue',
+    '    matched_phase="${matched_phase}${label} "',
+    '    case " ${matched_types} " in',
+    '      *" ${resolved} "*) ;;',
+    '      *) matched_types="${matched_types}${resolved} " ;;',
+    "    esac",
+    "  done",
+    "  local count=0",
+    "  for resolved in $matched_types; do",
+    "    count=$((count + 1))",
+    "  done",
+    '  if [ "$count" -eq 0 ]; then',
+    '    echo "OUTCOME=none"',
+    '  elif [ "$count" -eq 1 ]; then',
+    '    echo "OUTCOME=match"',
+    '    echo "TYPE_LABEL=${matched_types% }"',
+    "  else",
+    '    echo "OUTCOME=ambiguous"',
+    '    echo "CANDIDATE_TYPE_LABELS=${matched_types% }"',
+    "  fi",
+    '  echo "PHASE_LABELS=${matched_phase% }"',
+    "}"
+  );
+  return lines.join("\n");
+}
+function buildPhaseLabelTypeMap() {
+  const map = {};
+  for (const [bundleName, ownership] of Object.entries(BUNDLE_OWNERSHIP)) {
+    if (ownership.phaseLabelPrefixes.length === 0) {
+      continue;
+    }
+    if (ownership.typeLabels.length !== 1) {
+      throw new Error(
+        `BUNDLE_OWNERSHIP["${bundleName}"] declares ${ownership.phaseLabelPrefixes.length} phase-label matcher(s) but ${ownership.typeLabels.length} type label(s); a phase label must pair with exactly one type label`
+      );
+    }
+    const typeLabel = `type:${ownership.typeLabels[0]}`;
+    for (const matcher of ownership.phaseLabelPrefixes) {
+      const existing = map[matcher];
+      if (existing !== void 0 && existing !== typeLabel) {
+        throw new Error(
+          `Phase-label matcher "${matcher}" resolves to both "${existing}" and "${typeLabel}"; a matcher must imply exactly one type label`
+        );
+      }
+      map[matcher] = typeLabel;
+    }
+  }
+  return map;
+}
+function isTypeLabelOwnedByExcluded(typeLabel, excludedBundles) {
+  if (excludedBundles.length === 0) {
+    return false;
+  }
+  for (const bundleName of excludedBundles) {
+    const ownership = BUNDLE_OWNERSHIP[bundleName];
+    if (!ownership) {
+      continue;
+    }
+    if (ownership.typeLabels.includes(typeLabel)) {
+      const owners = findOwnersOfTypeLabel(typeLabel);
+      const allExcluded = owners.every(
+        (owner) => excludedBundles.includes(owner)
+      );
+      if (allExcluded) {
+        return true;
+      }
+    }
+  }
+  return false;
+}
+function isPhaseLabelOwnedByExcluded(phaseLabel, excludedBundles) {
+  if (excludedBundles.length === 0) {
+    return false;
+  }
+  for (const bundleName of excludedBundles) {
+    const ownership = BUNDLE_OWNERSHIP[bundleName];
+    if (!ownership) {
+      continue;
+    }
+    for (const entry of ownership.phaseLabelPrefixes) {
+      if (entry.endsWith(":")) {
+        if (phaseLabel.startsWith(entry)) {
+          return true;
+        }
+      } else if (phaseLabel === entry) {
+        return true;
+      }
+    }
+  }
+  return false;
+}
+function isScheduledTaskOwnedByExcluded(taskId, excludedBundles) {
+  if (excludedBundles.length === 0) {
+    return false;
+  }
+  for (const bundleName of excludedBundles) {
+    const ownership = BUNDLE_OWNERSHIP[bundleName];
+    if (!ownership) {
+      continue;
+    }
+    if (ownership.scheduledTaskIds.includes(taskId)) {
+      return true;
+    }
+  }
+  return false;
+}
+function hasAnyDocsEmittingBundle(excludedBundles) {
+  for (const [bundleName, ownership] of Object.entries(BUNDLE_OWNERSHIP)) {
+    if (!ownership.emitsDocs) {
+      continue;
+    }
+    if (!excludedBundles.includes(bundleName)) {
+      return true;
+    }
+  }
+  return false;
+}
+function hasAnyDownstreamIssueKindBundle(excludedBundles) {
+  for (const [bundleName, ownership] of Object.entries(BUNDLE_OWNERSHIP)) {
+    if (!ownership.downstreamIssueKinds) {
+      continue;
+    }
+    if (!excludedBundles.includes(bundleName)) {
+      return true;
+    }
+  }
+  return false;
+}
+function findOwnersOfTypeLabel(typeLabel) {
+  const owners = [];
+  for (const [bundleName, ownership] of Object.entries(BUNDLE_OWNERSHIP)) {
+    if (ownership.typeLabels.includes(typeLabel)) {
+      owners.push(bundleName);
+    }
+  }
+  return owners;
+}
+
+// src/agent/bundles/issue-type.ts
+var GITHUB_ISSUE_TYPES = ["Epic", "Feature", "Bug", "Task"];
+var DEFAULT_GITHUB_ISSUE_TYPE = "Task";
+var NON_DEFAULT_TITLE_PREFIX_TYPES = {
+  "epic:": "Epic",
+  "feat:": "Feature",
+  "fix:": "Bug"
+};
+var GITHUB_ISSUE_TYPE_BY_TITLE_PREFIX = buildTitlePrefixTypeMap();
+function githubIssueTypeForTitle(title) {
+  const colon = title.indexOf(":");
+  if (colon === -1) {
+    return DEFAULT_GITHUB_ISSUE_TYPE;
+  }
+  const prefix2 = title.slice(0, colon + 1).trim().toLowerCase();
+  return GITHUB_ISSUE_TYPE_BY_TITLE_PREFIX[prefix2] ?? DEFAULT_GITHUB_ISSUE_TYPE;
+}
+var SET_ISSUE_TYPE_HELPER_PATH = ".claude/procedures/set-issue-type.sh";
+function renderSetIssueTypeFallbackLines() {
+  return [
+    "```bash",
+    "gh api graphql -f query='query($owner:String!,$repo:String!){repository(owner:$owner,name:$repo){issueTypes(first:50){nodes{id name}}}}' -f owner=<owner> -f repo=<repo>",
+    "gh issue view <issue-number> --json id --jq '.id'",
+    "gh api graphql -f query='mutation($issueId:ID!,$typeId:ID!){updateIssueIssueType(input:{issueId:$issueId,issueTypeId:$typeId}){issue{number issueType{name}}}}' -f issueId=<issue-node-id> -f typeId=<issue-type-node-id>",
+    "```"
+  ];
+}
+function renderGithubIssueTypeSectionLines() {
+  const defaultPrefixes = Object.keys(GITHUB_ISSUE_TYPE_BY_TITLE_PREFIX).filter(
+    (prefix2) => GITHUB_ISSUE_TYPE_BY_TITLE_PREFIX[prefix2] === DEFAULT_GITHUB_ISSUE_TYPE
+  ).sort().map((prefix2) => `\`${prefix2}\``).join(", ");
+  return [
+    "## GitHub Issue Type",
+    "",
+    "A GitHub **issue type** is a distinct field from the `type:*` **label**:",
+    "the label routes and dedups, the issue type drives triage and Epic",
+    "tracking. Setting one does not set the other. Derive it from the",
+    "**title prefix**:",
+    "",
+    "| Prefix | GitHub Issue Type |",
+    "|--------|------------------|",
+    "| `epic:` | Epic |",
+    "| `feat:` | Feature |",
+    "| `fix:` | Bug |",
+    `| ${defaultPrefixes} | ${DEFAULT_GITHUB_ISSUE_TYPE} |`,
+    "| any bundle-phase prefix (`company:`, `req:`, \u2026), or no prefix | Task |",
+    "",
+    "### Assigning the GitHub issue type",
+    "",
+    "`gh issue create` **cannot** set the issue type \u2014 there is no `--type`",
+    "flag \u2014 so assign it in a follow-up call immediately after creation, for",
+    "every issue an agent files (auto-enqueued downstream issues included).",
+    "An issue that skips that call stays untyped forever. The",
+    "`github-workflow` bundle ships a one-step helper:",
+    "",
+    "```bash",
+    `${SET_ISSUE_TYPE_HELPER_PATH} <issue-number> <${GITHUB_ISSUE_TYPES.join("|")}>`,
+    "```",
+    "",
+    "When that helper is absent (the bundle is excluded), run the",
+    "`updateIssueIssueType` GraphQL flow it wraps:",
+    "",
+    ...renderSetIssueTypeFallbackLines()
+  ];
+}
+function renderTitlePrefixTypeBullets(indent = "   ") {
+  const nonDefault = Object.entries(NON_DEFAULT_TITLE_PREFIX_TYPES).map(
+    ([prefix2, issueType]) => `${indent}- \`${prefix2}\` \u2192 ${issueType}`
+  );
+  const defaults = Object.keys(GITHUB_ISSUE_TYPE_BY_TITLE_PREFIX).filter(
+    (prefix2) => GITHUB_ISSUE_TYPE_BY_TITLE_PREFIX[prefix2] === DEFAULT_GITHUB_ISSUE_TYPE
+  ).sort().map((prefix2) => `\`${prefix2}\``).join(", ");
+  return [
+    ...nonDefault,
+    `${indent}- ${defaults} \u2192 ${DEFAULT_GITHUB_ISSUE_TYPE}`,
+    `${indent}- any bundle-phase prefix (\`company:\`, \`req:\`, \`bcm:\`, \u2026) \u2192 ${DEFAULT_GITHUB_ISSUE_TYPE}`
+  ];
+}
+function renderGithubIssueTypeSection() {
+  return renderGithubIssueTypeSectionLines().join("\n");
+}
+function renderIssueTypeAssignmentStep(options = {}) {
+  const indent = options.indent ?? "   ";
+  const issueType = options.issueType ?? DEFAULT_GITHUB_ISSUE_TYPE;
+  const lead = options.bullet ? `${indent}- ` : indent;
+  const cont = options.bullet ? `${indent}  ` : indent;
+  return [
+    `${lead}Then assign the new issue's **GitHub issue type** (\`${issueType}\`) \u2014`,
+    `${cont}the \`type:*\` label does not set it:`,
+    `${cont}\`${SET_ISSUE_TYPE_HELPER_PATH} <issue-number> ${issueType}\`. See`,
+    `${cont}**Assigning the GitHub issue type** for the no-helper fallback.`
+  ];
+}
+function renderIssueTypeAssignmentBlanket(indent = "", issueType = DEFAULT_GITHUB_ISSUE_TYPE) {
+  return [
+    `${indent}**Every** issue this phase files needs a **GitHub issue type**`,
+    `${indent}assigned right after creation \u2014 the \`type:*\` label does not set`,
+    `${indent}it, and \`gh issue create\` cannot:`,
+    `${indent}\`${SET_ISSUE_TYPE_HELPER_PATH} <issue-number> ${issueType}\`. See`,
+    `${indent}**Assigning the GitHub issue type** for the prefix table (nearly`,
+    `${indent}every downstream issue is a \`${issueType}\`) and the no-helper fallback.`
+  ];
+}
+function buildTitlePrefixTypeMap() {
+  const map = {};
+  for (const label of CONVENTIONAL_COMMIT_TYPE_LABELS) {
+    map[`${label.slice("type:".length)}:`] = DEFAULT_GITHUB_ISSUE_TYPE;
+  }
+  for (const [prefix2, issueType] of Object.entries(
+    NON_DEFAULT_TITLE_PREFIX_TYPES
+  )) {
+    map[prefix2] = issueType;
+  }
+  return map;
+}
+
 // src/agent/bundles/project-context.ts
 var PROJECT_CONTEXT_PATH = "docs/src/content/docs/project-context.md";
 var SUBPROJECT_ROLE_GUIDANCE = [
@@ -872,6 +1469,9 @@ var draftAgendaSkill = {
     '   - `desired_outcomes` \u2014 1\u20133 bullets describing "done"',
     "   - `pre_reads` \u2014 relative paths to existing docs (optional)",
     "   - `related_docs` \u2014 relative paths for context (optional)",
+    "",
+    ...renderIssueTypeAssignmentStep(),
+    "",
     "2. Execute Phase 1 (Draft) of the agenda-analyst agent.",
     "3. If the draft phase inline-finalizes (default path), no",
     "   downstream issues are created.",
@@ -936,6 +1536,9 @@ var finalizeAgendaSkill = {
     "   - Path to the draft agenda",
     "     (`<meetingsRoot>/<YYYY-MM-DD>-<slug>/agenda.md`)",
     "   - Any late-added items to incorporate",
+    "",
+    ...renderIssueTypeAssignmentStep(),
+    "",
     "2. Execute Phase 2 (Finalize) of the agenda-analyst agent.",
     "",
     "## Output",
@@ -1481,6 +2084,14 @@ function renderIssueTemplatesStarterPage(_it) {
     "`status:*` label from the conventions documented in the",
     "`issue-label-conventions` rule.",
     "",
+    "Every recipe also ends with a **GitHub issue type** assignment.",
+    "`gh issue create` cannot set the issue type, so it takes a second",
+    "call \u2014 an issue that skips it stays untyped forever. Derive the type",
+    "from the title prefix (`epic:` \u2192 Epic, `feat:` \u2192 Feature, `fix:` \u2192",
+    "Bug, everything else \u2014 including every bundle-phase prefix \u2014 \u2192",
+    "Task); see **Assigning the GitHub issue type** in the",
+    "`issue-conventions` rule for the command and its fallback.",
+    "",
     "Before creating any profile-style issue (people, companies,",
     "software), run the duplicate check documented in the owning",
     "bundle's rule \u2014 the issue-templates page is a recipe catalogue,",
@@ -1515,6 +2126,13 @@ function renderIssueTemplatesStarterPage(_it) {
     "- [ ] <criterion 1>",
     "- [ ] <criterion 2>",
     '"',
+    "```",
+    "",
+    "Then assign the GitHub issue type (`Task` for a phase-labelled",
+    "title):",
+    "",
+    "```bash",
+    `${SET_ISSUE_TYPE_HELPER_PATH} <issue-number> ${DEFAULT_GITHUB_ISSUE_TYPE}`,
     "```"
   ].join("\n");
 }
@@ -4619,16 +5237,7 @@ function buildBaseBundle(paths = DEFAULT_AGENT_PATHS) {
           "| `release:` | Release preparation, version bumps |",
           "| `hotfix:` | Urgent production fixes |",
           "",
-          "## GitHub Issue Type",
-          "",
-          "When creating issues, always assign the appropriate **GitHub issue type** based on the title prefix:",
-          "",
-          "| Prefix | GitHub Issue Type |",
-          "|--------|------------------|",
-          "| `epic:` | Epic |",
-          "| `feat:` | Feature |",
-          "| `fix:` | Bug |",
-          "| `chore:`, `docs:`, `refactor:`, `release:`, `hotfix:` | Task |",
+          ...renderGithubIssueTypeSectionLines(),
           "",
           "## Prerequisite Issues",
           "",
@@ -5318,6 +5927,8 @@ function buildBcmWriterSubAgent(paths, issueDefaults) {
       `   - \`priority:${labelsForPhase(issueDefaults, "people:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "people:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "   **Unfamiliar company (enabling vendor, partner, competitor).**",
       "   Hand off to the `company-profile` bundle by creating a",
       "   `company:research` issue. The issue must carry:",
@@ -5327,6 +5938,8 @@ function buildBcmWriterSubAgent(paths, issueDefaults) {
       `   - \`priority:${labelsForPhase(issueDefaults, "company:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "company:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "   **Missing research topic (value stream, market sizing, etc.).**",
       "   Hand off to the `research-pipeline` bundle by creating a",
       "   `research:scope` issue. The issue must carry:",
@@ -5336,6 +5949,8 @@ function buildBcmWriterSubAgent(paths, issueDefaults) {
       `   - \`priority:${labelsForPhase(issueDefaults, "research:scope").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "research:scope").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "   This phase assumes the `people-profile`, `company-profile`, and",
       "   `research-pipeline` bundles are enabled in the consuming project.",
       "   If a bundle is not enabled, flag the connect issue with",
@@ -5458,6 +6073,8 @@ function buildWriteBcmSkill(paths, issueDefaults) {
       `   \`priority:${labelsForPhase(issueDefaults, "bcm:outline").priority}\`, and \`status:${labelsForPhase(issueDefaults, "bcm:outline").status}\`. Body must include the`,
       "   verbatim capability name and any overrides.",
       "",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 1 (Outline) of the bcm-writer agent.",
       "",
       "3. Phase 1 creates a `bcm:scaffold` issue, which Phase 2 follows with",
@@ -6744,6 +7361,8 @@ function buildScanBusinessModelsSkill(paths, issueDefaults) {
       "1. Create a `business-models:scan` issue with `type:business-model`,",
       `   \`priority:${labelsForPhase(issueDefaults, "business-models:scan").priority}\`, and \`status:${labelsForPhase(issueDefaults, "business-models:scan").status}\`. The body must include the`,
       "   industry slug, the source plan path (if any), and any overrides.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 1 (Scan) of the business-models-analyst agent.",
       "3. Phase 1 creates one `business-models:canvas` issue per in-scope",
       "   segment. Each canvas issue declares its `Depends on:`",
@@ -6818,6 +7437,8 @@ function buildCanvasBusinessModelSkill(paths, issueDefaults) {
       `   \`type:business-model\`, \`priority:${labelsForPhase(issueDefaults, "business-models:canvas").priority}\`, and \`status:${labelsForPhase(issueDefaults, "business-models:canvas").status}\`.`,
       "   The body must include the industry slug, segment slug, and any",
       "   scan-report reference.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 2 (Canvas) of the business-models-analyst agent.",
       "3. Phase 2 writes the nine-block canvas and creates a",
       "   `business-models:complete` issue for the downstream Phase 3.",
@@ -6877,6 +7498,8 @@ function buildCompleteBusinessModelSkill(paths, issueDefaults) {
       "1. Create a `business-models:complete` issue with",
       `   \`type:business-model\`, \`priority:${labelsForPhase(issueDefaults, "business-models:complete").priority}\`, and \`status:${labelsForPhase(issueDefaults, "business-models:complete").status}\`.`,
       "   Body must include the canvas document path.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 3 (Complete) of the business-models-analyst agent.",
       "",
       "## Output",
@@ -7401,6 +8024,8 @@ function buildCompanyProfileAnalystSubAgent(paths, issueDefaults, tier) {
       `   - \`priority:${labelsForPhase(issueDefaults, "people:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "people:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "   The issue body must include:",
       "   - A **discovery source** line naming this company profile",
       "     (`Discovered while profiling: <company name>`)",
@@ -7418,6 +8043,8 @@ function buildCompanyProfileAnalystSubAgent(paths, issueDefaults, tier) {
       `   - \`priority:${labelsForPhase(issueDefaults, "software:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "software:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "   The issue body must include:",
       "   - A **discovery source** line naming this company profile",
       "     (`Discovered while profiling: <company name>`)",
@@ -7969,6 +8596,8 @@ function buildProfileCompanySkill(paths, issueDefaults) {
       "1. Create a `company:research` issue with `type:company-profile`,",
       `   \`priority:${labelsForPhase(issueDefaults, "company:research").priority}\`, and \`status:${labelsForPhase(issueDefaults, "company:research").status}\`. Body must include the`,
       "   company name, selected type, framing, and any overrides.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 1 (Research) of the company-profile-analyst agent.",
       "3. Phase 1 creates the `company:draft` issue. Phase 2 may create a",
       "   `company:followup` issue **and** a `company:match` issue. Each",
@@ -8043,6 +8672,8 @@ function buildMatchCompanySkill(paths, issueDefaults) {
       "1. Create a `company:match` issue with `type:company-profile`,",
       `   \`priority:${labelsForPhase(issueDefaults, "company:match").priority}\`, and \`status:${labelsForPhase(issueDefaults, "company:match").status}\`. Body must include the`,
       "   profile path and any overrides.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 4 (Match) of the company-profile-analyst agent.",
       "",
       "## Output",
@@ -8116,6 +8747,8 @@ function buildRefreshCompanySkill(paths, issueDefaults) {
       "1. Create a `company:refresh` issue with `type:company-profile`,",
       `   \`priority:${labelsForPhase(issueDefaults, "company:refresh").priority}\`, and \`status:${labelsForPhase(issueDefaults, "company:refresh").status}\`. Body must include the`,
       "   profile path and any overrides.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 5 (Refresh) of the company-profile-analyst agent.",
       "",
       "## Output",
@@ -8189,6 +8822,8 @@ function buildAnalyzeSegmentSkill(paths, issueDefaults) {
       "1. Create a `company:analyze` issue with `type:company-profile`,",
       `   \`priority:${labelsForPhase(issueDefaults, "company:analyze").priority}\`, and \`status:${labelsForPhase(issueDefaults, "company:analyze").status}\`. Body must include the`,
       "   segment slug and any overrides.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 6 (Analyze) of the company-profile-analyst agent.",
       "",
       "## Output",
@@ -8777,6 +9412,8 @@ function buildCustomerProfileAnalystSubAgent(paths, issueDefaults, tier) {
       `   - \`priority:${labelsForPhase(issueDefaults, "company:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "company:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "9. **Create `people:research` issues** for notable contacts",
       "   (economic buyers, technical buyers, user champions) surfaced in",
       "   sources. Keep the list small \u2014 at most three individuals per",
@@ -8788,6 +9425,8 @@ function buildCustomerProfileAnalystSubAgent(paths, issueDefaults, tier) {
       `   - \`priority:${labelsForPhase(issueDefaults, "people:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "people:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "10. **Verify all handoffs were created** before committing.",
       "",
       "11. **Commit and push** the archetype page. Close the profile issue.",
@@ -8889,6 +9528,8 @@ function buildCustomerProfileAnalystSubAgent(paths, issueDefaults, tier) {
       `   - \`priority:${labelsForPhase(issueDefaults, "req:scan").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "req:scan").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "   The body must also:",
       "   - Link back to the archetype page and the competitor page",
       "   - Cite the specific unmet-need row and the originating job",
@@ -8905,6 +9546,8 @@ function buildCustomerProfileAnalystSubAgent(paths, issueDefaults, tier) {
       `   - \`priority:${labelsForPhase(issueDefaults, "company:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "company:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "9. **Create `people:research` issues** for notable competitor",
       "   leadership or customer-advocacy figures surfaced in the analysis.",
       "   Keep this list small \u2014 at most three individuals per competitors",
@@ -8916,6 +9559,8 @@ function buildCustomerProfileAnalystSubAgent(paths, issueDefaults, tier) {
       `   - \`priority:${labelsForPhase(issueDefaults, "people:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "people:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "10. **Commit and push** the competitor-analysis page and the",
       "    updated archetype page. Close the competitors issue.",
       "",
@@ -9102,6 +9747,8 @@ function buildDiscoverCustomersSkill(paths, issueDefaults) {
       "1. Create a `customer:discover` issue with `type:customer-profile`,",
       `   \`priority:${labelsForPhase(issueDefaults, "customer:discover").priority}\`, and \`status:${labelsForPhase(issueDefaults, "customer:discover").status}\`. The body must include the`,
       "   scope slug and any known archetypes to include or exclude.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 1 (Discover) of the customer-profile-analyst agent.",
       "3. Phase 1 writes the discovery report and creates one",
       "   `customer:profile` issue per prioritized archetype.",
@@ -9177,6 +9824,8 @@ function buildProfileCustomerSkill(paths, issueDefaults) {
       "1. Create a `customer:profile` issue with `type:customer-profile`,",
       `   \`priority:${labelsForPhase(issueDefaults, "customer:profile").priority}\`, and \`status:${labelsForPhase(issueDefaults, "customer:profile").status}\`. The body must include the`,
       "   archetype slug and (optionally) the segment slug.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 2 (Profile) of the customer-profile-analyst agent.",
       "   The agent runs 4\u20138 targeted web searches and populates the",
       "   archetype page.",
@@ -9253,6 +9902,8 @@ function buildAnalyzeCustomerCompetitorsSkill(paths, issueDefaults) {
       `   \`status:${labelsForPhase(issueDefaults, "customer:competitors").status}\` (or \`status:blocked\` when still dependent on a`,
       "   Phase 2 profile issue). Body must include the archetype page",
       "   path.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 3 (Competitors) of the customer-profile-analyst",
       "   agent. The agent reads `<MATRIX_FILE>` and runs up to 4\u20138 web",
       "   searches only to close competitor-coverage gaps the matrix does",
@@ -10962,10 +11613,7 @@ function buildGithubWorkflowBundle(buildPolicy = DEFAULT_BUILD_POLICY) {
           "   - If unclear, ask the user which type applies",
           "2. **Compose the issue title** in the format: `<type>: <short description>`",
           "3. **Determine the GitHub issue type** based on the prefix:",
-          "   - `epic:` \u2192 Epic",
-          "   - `feat:` \u2192 Feature",
-          "   - `fix:` \u2192 Bug",
-          "   - `chore:`, `docs:`, `refactor:`, `release:`, `hotfix:` \u2192 Task",
+          ...renderTitlePrefixTypeBullets(),
           "4. **Identify prerequisite issues** \u2014 if the user mentions dependencies or blockers, include a **Dependencies** section in the body with `Depends on: #<issue-number>`",
           "5. **Determine labels** \u2014 every issue must be created with the following labels:",
           "   - **`type:*`** \u2014 derived from the issue title prefix:",
@@ -11451,6 +12099,7 @@ function buildIndustryDiscoveryAnalystSubAgent(paths, issueDefaults) {
       "     downstream research needs to answer)",
       "   - Cite the evaluation row that justified advancing the vertical",
       "   - Reference the plan file path for traceability",
+      ...renderIssueTypeAssignmentStep({ indent: "   ", bullet: true }),
       "",
       "5. **Cross-link** \u2014 update the plan file's `## Cleared Verticals`",
       "   table so each row references its newly-created `research:scope`",
@@ -11541,6 +12190,8 @@ function buildDiscoverIndustriesSkill(paths, issueDefaults) {
       "1. Create an `industry:discover` issue with `type:industry-discovery`,",
       `   \`priority:${labelsForPhase(issueDefaults, "industry:discover").priority}\`, and \`status:${labelsForPhase(issueDefaults, "industry:discover").status}\`. Body must include the`,
       "   verbatim scope, authorized sources, and any overrides.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 1 (Discover) of the industry-discovery-analyst",
       "   agent.",
       "3. Phase 1 creates an `industry:evaluate` issue, which Phase 2 follows",
@@ -11819,6 +12470,8 @@ function buildMaintenanceAuditSubAgent(paths, tier) {
       "4. Commit, push, open a PR (if applicable), and close the issue per",
       "   your project's PR workflow.",
       "",
+      ...renderIssueTypeAssignmentBlanket(),
+      "",
       "---",
       "",
       ...renderClaimVerificationSection(),
@@ -12251,6 +12904,8 @@ function buildMaintenanceAuditSkill(paths, issueDefaults) {
       "   - `<AUDIT_ROOT>` \u2014 where to write the audit report",
       "   - `<AUDIT_SLUG>` \u2014 short identifier for this audit",
       "   - The audit checks to run (defaults to the full check catalog)",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 1 (Scan) of the maintenance-audit agent.",
       "3. If auto-fixable findings exist, a `maint:fix` issue is created",
       "   automatically.",
@@ -12315,6 +12970,8 @@ function buildMaintenanceVerifySkill(issueDefaults) {
       "   - The Phase 2 fix report path (if one exists)",
       "   - The `Paths Touched` list (copied from the fix report)",
       "   - The audit check catalog (copied from the scan issue)",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 3 (Verify) of the maintenance-audit agent.",
       "",
       "## Output",
@@ -12824,6 +13481,8 @@ function buildMeetingAnalystSubAgent(tier) {
       "   - Always create a `meeting:link` issue \u2014 blocked on the draft issue if one",
       "     was created, otherwise blocked on the notes issue",
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "7. **Commit the extraction content first.** Stage and commit",
       "   the `insights/{type}/<basename>.md` file (and any newly",
       "   created `insights/index.md` / `insights/{type}/index.md`",
@@ -13023,6 +13682,8 @@ function buildMeetingAnalystSubAgent(tier) {
       "",
       "### Steps",
       "",
+      ...renderIssueTypeAssignmentBlanket(),
+      "",
       "1. Read the drafts from Phase 3 (if they exist) and the extraction",
       "   from Phase 1 at `<meetingsRoot>/insights/{type}/<basename>.md`.",
       "   Re-read the extraction frontmatter for `meeting_kind` and `areas`,",
@@ -13079,707 +13740,228 @@ function buildMeetingAnalystSubAgent(tier) {
       "   (the degenerate case above). For the kind `planning`, also",
       "   update the active sprint-plan doc directly (when the",
       "   sprint-plan doc's area is in-scope, or always when no",
-      "   `meetingAreas` are declared); for the kind `review`, mark",
-      "   completed tasks in that same doc.",
-      "7. **Update the extraction file** at",
-      "   `<meetingsRoot>/insights/{type}/<basename>.md` with a",
-      "   `## Downstream Artifacts` section listing every issue and",
-      "   document created from this meeting. Note any items that were",
-      "   deferred to follow-up issues because of the area gate.",
-      "8. **Update the meeting notes** at",
-      "   `<meetingsRoot>/notes/{type}/<basename>.md` with a",
-      "   `## Related Issues` section listing all issues created from this",
-      "   meeting.",
-      "9. Comment on the parent extract issue with a summary linking to all",
-      "   created artifacts.",
-      "10. Commit and push (if any file changes were made), then close the link issue.",
-      "",
-      "---",
-      "",
-      "## GitHub Integration",
-      "",
-      "- Use `gh` CLI for all GitHub operations",
-      "- Apply the appropriate `meeting:*` phase label to each phase issue",
-      "- Use `type:docs` for documentation-producing issues, `type:chore` for",
-      "  maintenance/organizational tasks the pipeline can action",
-      "- Do **not** file issues for human-owned action items \u2014 per the",
-      "  **Action-item filing policy** they live only in the notes",
-      "  `## Action Items` table",
-      "- Use `status:` labels to track progress (`status:ready`, `status:in-progress`, `status:done`)",
-      "- Reference the source meeting transcript in all created issues",
-      "- Link phase issues with `Depends on: #N` to enforce ordering",
-      "",
-      "## When to Shorten the Pipeline",
-      "",
-      "- **Short meetings** (<30 min, <2000 words): combine extract + notes into one session",
-      "- **No requirements or decisions**: Phase 1 skips creating the `meeting:draft` issue",
-      "- **Only action items**: extract + notes + link (3 phase issues)"
-    ].join("\n")
-  };
-}
-var processMeetingSkill = {
-  name: "process-meeting",
-  description: "Process a meeting transcript through the 4-phase meeting analysis pipeline",
-  disableModelInvocation: true,
-  userInvocable: true,
-  context: "fork",
-  agent: "meeting-analyst",
-  platforms: { cursor: { exclude: true } },
-  instructions: [
-    "# Process Meeting",
-    "",
-    "Kick off meeting processing by executing Phase 1 (Extract) and",
-    "creating downstream phase issues for the remaining phases. Inputs",
-    "live in the **sibling-tree layout**: pass any file from",
-    "`<meetingsRoot>/notes/{type}/` or `<meetingsRoot>/transcripts/{type}/`",
-    "(both, notes-only, and transcript-only are all valid input cases).",
-    "",
-    "## Usage",
-    "",
-    "/process-meeting <path-to-notes-or-transcript>",
-    "",
-    "## Basename-pairing algorithm",
-    "",
-    "The user may pass either a notes-tree path or a transcripts-tree",
-    "path. Resolve the sibling implicitly via filesystem lookup \u2014",
-    "do **not** prompt the user or fail-loud when the sibling is",
-    "absent:",
-    "",
-    "1. Infer the **basename** (filename without the `.md` extension)",
-    "   and the `{internal,external}` partition from the provided path.",
-    "   Both segments are usually adjacent in the path \u2014",
-    "   `\u2026/notes/internal/2026-03-14-sprint-kickoff.md` yields basename",
-    "   `2026-03-14-sprint-kickoff` and type `internal`.",
-    "2. Determine the **input tree** from the path:",
-    "   - If the path contains `/notes/`, treat it as the notes input",
-    "     and look for the sibling at",
-    "     `<meetingsRoot>/transcripts/<type>/<basename>.md`.",
-    "   - If the path contains `/transcripts/`, treat it as the",
-    "     transcript input and look for the sibling at",
-    "     `<meetingsRoot>/notes/<type>/<basename>.md`.",
-    "   - If the path matches neither (e.g. an ad-hoc location), infer",
-    "     basename + type as best you can from the filename and",
-    "     surrounding folder segments, then proceed with whichever",
-    "     sibling-tree lookups succeed. Best-effort, never fail-loud.",
-    "3. Read **every** sibling that exists on disk. The combination",
-    "   (notes present, transcript present, both present) selects the",
-    "   Phase-1 input case from the **input-case matrix** in the",
-    "   `meeting-analyst` agent prompt.",
-    "4. A missing sibling is a normal outcome \u2014 proceed with whatever",
-    "   was found. Notes-only and transcript-only are both valid",
-    "   Phase-1 input cases; the agent never warns or prompts the",
-    "   user about the absence.",
-    "",
-    "## Steps",
-    "",
-    "1. Resolve the basename, partition, and any sibling files using",
-    "   the **Basename-pairing algorithm** above",
-    "2. Execute Phase 1 (Extract) \u2014 categorize the available content into",
-    "   decisions, requirements, action items, open questions, and more.",
-    "   Tag each action item's disposition (`agent-workable` vs",
-    "   `human-owned`) per the agent's **Action-item filing policy** so",
-    "   Phase 4 keeps human-owned tasks out of the issue queue",
-    "3. Write the extraction to",
-    "   `<meetingsRoot>/insights/{type}/<basename>.md`",
-    "4. Create downstream phase issues using `gh issue create`:",
-    "   - `meeting:notes` issue (always)",
-    "   - `meeting:draft` issue (if requirements or decisions were found)",
-    "   - `meeting:link` issue (always)",
-    "5. Each downstream issue includes `Depends on:` linking to its predecessor",
-    "6. Commit and push the extraction file",
-    "",
-    "## Input",
-    "",
-    "Provide a path to a file in either `notes/` or `transcripts/`. The",
-    "agent will look up the sibling automatically via basename match. A",
-    "missing sibling is a normal case (notes-only or transcript-only) \u2014",
-    "the agent handles all three input cases.",
-    "",
-    "## Output",
-    "",
-    "- A structured extraction at",
-    "  `<meetingsRoot>/insights/{type}/<basename>.md`",
-    "- Phase issues with `meeting:*` labels for downstream agent sessions",
-    "  to pick up (notes, draft, link)"
-  ].join("\n")
-};
-function buildMeetingAnalysisBundle(tier = AGENT_MODEL.BALANCED) {
-  return {
-    name: "meeting-analysis",
-    description: "Meeting transcript processing workflow with 4-phase pipeline (extract, notes, draft, link)",
-    appliesWhen: () => true,
-    rules: [
-      {
-        name: "meeting-processing-workflow",
-        description: "Describes the 4-phase meeting processing pipeline, extraction taxonomy, and labeling conventions",
-        scope: AGENT_RULE_SCOPE.ALWAYS,
-        content: [
-          "# Meeting Processing Workflow",
-          "",
-          "Use `/process-meeting <path>` to process a meeting through a",
-          "4-phase pipeline (extract \u2192 notes \u2192 draft \u2192 link). Each phase runs as a",
-          "separate agent session tracked by a GitHub issue with a `meeting:*` label.",
-          "See the `meeting-analyst` agent definition for full workflow details.",
-          "",
-          "Meeting artifacts live in **three parallel trees** rooted at the",
-          "project's meetings root:",
-          "",
-          "- `transcripts/{internal,external}/` \u2014 verbatim transcripts (evidence)",
-          "- `notes/{internal,external}/` \u2014 curated narrative summary",
-          "  (input + Phase 2 output)",
-          "- `insights/{internal,external}/` \u2014 structured extraction (Phase 1 output)",
-          "",
-          "The three trees share identical basenames so a meeting's siblings",
-          "are looked up by filename, not by frontmatter cross-references.",
-          "Phase 1 accepts every input case (notes + transcript, notes only,",
-          "or transcript only) and Phase 2 enhances the notes file in place",
-          "rather than authoring it from scratch.",
-          "",
-          "Notes and insights files may carry optional frontmatter fields",
-          "`slug`, `source`, `transcript_available`, and `confidence`",
-          "alongside the existing `meeting_type` and `areas` fields. Missing",
-          "frontmatter is treated as a normal input case \u2014 never fail-loud.",
-          "",
-          "Meeting notes may declare a `meeting_type` (one of the project's",
-          "recognized types) and an `areas: [...]` list. The `meeting_type`",
-          "resolves to a generic kind \u2014 `planning` / `review` / `brainstorm` /",
-          "`standup` / `external` / `other` \u2014 that drives type-specific",
-          "extraction rules in phases 1\u20132. The `areas` list scopes phase-4",
-          "direct edits to the doc-root sub-folders declared in the project's",
-          "**Area \u2192 doc-root mapping** table. When both fields are absent",
-          "the pipeline falls back to the default workflow (kind `other`,",
-          "no area gating).",
-          "",
-          "Phase 4 applies an **agent-workability split** to action items:",
-          "items that yield a documentation deliverable an agent can author",
-          "are filed through their dedicated downstream channel",
-          "(`req:write`, `docs:write`, `bcm:*`, `research:scope`, roadmap",
-          "follow-up); human-owned tasks (send / schedule / install /",
-          "decide / communicate / get-access / build-elsewhere) are",
-          "recorded **only** in the notes `## Action Items` table, which is",
-          "the **system of record for human follow-ups** \u2014 no GitHub issue",
-          "is filed for them. Consumers tune or disable the split via",
-          "`AgentConfigOptions.meetings.actionItemFiling`."
-        ].join("\n"),
-        platforms: {
-          cursor: { exclude: true }
-        },
-        tags: ["workflow"]
-      }
-    ],
-    skills: [processMeetingSkill],
-    subAgents: [buildMeetingAnalystSubAgent(tier)],
-    labels: [
-      {
-        name: "type:meeting-processing",
-        color: "5319E7",
-        description: "Meeting transcript processing pipeline"
-      },
-      {
-        name: "meeting:extract",
-        color: "C5DEF5",
-        description: "Phase 1: raw extraction from a meeting transcript"
-      },
-      {
-        name: "meeting:notes",
-        color: "BFDADC",
-        description: "Phase 2: curated notes derived from an extraction"
-      },
-      {
-        name: "meeting:draft",
-        color: "D4C5F9",
-        description: "Phase 3: draft follow-up issues proposed from notes"
-      },
-      {
-        name: "meeting:link",
-        color: "FEF2C0",
-        description: "Phase 4: linking/reconciling drafted issues with existing work"
-      }
-    ]
-  };
-}
-var meetingAnalysisBundle = buildMeetingAnalysisBundle();
-
-// src/agent/bundles/bundle-ownership.ts
-var BUNDLE_OWNERSHIP = {
-  agenda: {
-    typeLabels: ["agenda"],
-    phaseLabelPrefixes: ["agenda:"],
-    scheduledTaskIds: ["worker-agenda"],
-    emitsDocs: true,
-    downstreamIssueKinds: true
-  },
-  "bcm-writer": {
-    typeLabels: ["bcm-document"],
-    phaseLabelPrefixes: ["bcm:"],
-    scheduledTaskIds: ["worker-bcm-writer"],
-    emitsDocs: true,
-    downstreamIssueKinds: true
-  },
-  "business-models": {
-    typeLabels: ["business-model"],
-    phaseLabelPrefixes: ["business-models:"],
-    scheduledTaskIds: ["worker-business-models"],
-    emitsDocs: true,
-    downstreamIssueKinds: true
-  },
-  "company-profile": {
-    typeLabels: ["company-profile"],
-    phaseLabelPrefixes: ["company:"],
-    scheduledTaskIds: ["worker-company-profile"],
-    emitsDocs: true,
-    downstreamIssueKinds: true
-  },
-  "customer-profile": {
-    typeLabels: ["customer-profile"],
-    phaseLabelPrefixes: ["customer:"],
-    scheduledTaskIds: ["worker-customer-profile"],
-    emitsDocs: true,
-    downstreamIssueKinds: true
-  },
-  "docs-sync": {
-    typeLabels: ["docs-sync"],
-    phaseLabelPrefixes: ["docs-sync:"],
-    scheduledTaskIds: ["worker-docs-sync"],
-    emitsDocs: true,
-    downstreamIssueKinds: true
-  },
-  "industry-discovery": {
-    typeLabels: ["industry-discovery"],
-    phaseLabelPrefixes: ["industry:"],
-    scheduledTaskIds: ["worker-industry-discovery"],
-    emitsDocs: true,
-    downstreamIssueKinds: true
-  },
-  "maintenance-audit": {
-    typeLabels: ["maintenance"],
-    phaseLabelPrefixes: ["maint:"],
-    scheduledTaskIds: ["worker-maintenance"],
-    emitsDocs: false,
-    downstreamIssueKinds: true
-  },
-  "meeting-analysis": {
-    typeLabels: ["meeting-processing"],
-    phaseLabelPrefixes: ["meeting:"],
-    scheduledTaskIds: ["worker-meeting-analysis"],
-    emitsDocs: true,
-    downstreamIssueKinds: true
-  },
-  orchestrator: {
-    // The orchestrator pipeline manager itself ships with the
-    // `worker-orchestrator` scheduled task. It owns no `type:*` label
-    // (it dispatches every type) and no phase-label prefix.
-    typeLabels: [],
-    phaseLabelPrefixes: [],
-    scheduledTaskIds: ["worker-orchestrator"],
-    emitsDocs: false,
-    downstreamIssueKinds: false
-  },
-  "people-profile": {
-    typeLabels: ["people-profile"],
-    phaseLabelPrefixes: ["people:"],
-    scheduledTaskIds: ["worker-people-profile"],
-    emitsDocs: true,
-    downstreamIssueKinds: true
-  },
-  "pr-review": {
-    typeLabels: ["pr-review"],
-    phaseLabelPrefixes: [],
-    scheduledTaskIds: ["worker-pr-review"],
-    emitsDocs: false,
-    downstreamIssueKinds: false
-  },
-  "regulatory-research": {
-    typeLabels: ["regulatory-research"],
-    phaseLabelPrefixes: ["regulatory:"],
-    scheduledTaskIds: ["worker-regulatory-research"],
-    emitsDocs: true,
-    downstreamIssueKinds: true
-  },
-  "requirements-analyst": {
-    typeLabels: ["requirement"],
-    phaseLabelPrefixes: ["req:"],
-    scheduledTaskIds: ["worker-requirements-analyst"],
-    emitsDocs: true,
-    downstreamIssueKinds: true
-  },
-  "requirements-reviewer": {
-    // Co-owns `type:requirement` with the analyst and writer; owns
-    // the `req:review` and `req:deprecate` phase labels exactly.
-    typeLabels: ["requirement"],
-    phaseLabelPrefixes: ["req:review", "req:deprecate"],
-    scheduledTaskIds: ["worker-requirements-reviewer"],
-    emitsDocs: true,
-    downstreamIssueKinds: true
-  },
-  "requirements-writer": {
-    // Co-owns `type:requirement` with the analyst and reviewer; owns
-    // the `req:write` phase label exactly.
-    typeLabels: ["requirement"],
-    phaseLabelPrefixes: ["req:write"],
-    scheduledTaskIds: ["worker-requirements-writer"],
-    emitsDocs: true,
-    downstreamIssueKinds: true
-  },
-  "research-pipeline": {
-    typeLabels: ["research"],
-    phaseLabelPrefixes: ["research:"],
-    scheduledTaskIds: ["worker-research"],
-    emitsDocs: true,
-    downstreamIssueKinds: true
-  },
-  "software-profile": {
-    typeLabels: ["software-profile"],
-    phaseLabelPrefixes: ["software:"],
-    scheduledTaskIds: ["worker-software-profile"],
-    emitsDocs: true,
-    downstreamIssueKinds: true
-  },
-  "standards-research": {
-    typeLabels: ["standards-research"],
-    phaseLabelPrefixes: ["standards:"],
-    scheduledTaskIds: ["worker-standards-research"],
-    emitsDocs: true,
-    downstreamIssueKinds: true
-  }
-};
-var CONVENTIONAL_COMMIT_TYPE_LABELS = [
-  "type:chore",
-  "type:docs",
-  "type:feat",
-  "type:fix",
-  "type:hotfix",
-  "type:refactor",
-  "type:release"
-];
-var PHASE_LABEL_TYPE_MAP = buildPhaseLabelTypeMap();
-function typeLabelForPhaseLabel(phaseLabel) {
-  const exact = PHASE_LABEL_TYPE_MAP[phaseLabel];
-  if (exact !== void 0 && !phaseLabel.endsWith(":")) {
-    return exact;
-  }
-  let bestMatcher;
-  for (const matcher of Object.keys(PHASE_LABEL_TYPE_MAP)) {
-    if (!matcher.endsWith(":")) {
-      continue;
-    }
-    if (!phaseLabel.startsWith(matcher)) {
-      continue;
-    }
-    if (bestMatcher === void 0 || matcher.length > bestMatcher.length) {
-      bestMatcher = matcher;
-    }
-  }
-  return bestMatcher === void 0 ? void 0 : PHASE_LABEL_TYPE_MAP[bestMatcher];
-}
-function resolveTypeLabelForLabels(labels) {
-  const phaseLabels = [];
-  const candidates = /* @__PURE__ */ new Set();
-  for (const label of labels) {
-    const typeLabel = typeLabelForPhaseLabel(label);
-    if (typeLabel === void 0) {
-      continue;
-    }
-    phaseLabels.push(label);
-    candidates.add(typeLabel);
-  }
-  const candidateTypeLabels = Array.from(candidates).sort();
-  if (candidateTypeLabels.length === 0) {
-    return { outcome: "none", candidateTypeLabels: [], phaseLabels: [] };
-  }
-  if (candidateTypeLabels.length === 1) {
-    return {
-      outcome: "match",
-      typeLabel: candidateTypeLabels[0],
-      candidateTypeLabels,
-      phaseLabels
-    };
-  }
-  return { outcome: "ambiguous", candidateTypeLabels, phaseLabels };
+      "   `meetingAreas` are declared); for the kind `review`, mark",
+      "   completed tasks in that same doc.",
+      "7. **Update the extraction file** at",
+      "   `<meetingsRoot>/insights/{type}/<basename>.md` with a",
+      "   `## Downstream Artifacts` section listing every issue and",
+      "   document created from this meeting. Note any items that were",
+      "   deferred to follow-up issues because of the area gate.",
+      "8. **Update the meeting notes** at",
+      "   `<meetingsRoot>/notes/{type}/<basename>.md` with a",
+      "   `## Related Issues` section listing all issues created from this",
+      "   meeting.",
+      "9. Comment on the parent extract issue with a summary linking to all",
+      "   created artifacts.",
+      "10. Commit and push (if any file changes were made), then close the link issue.",
+      "",
+      "---",
+      "",
+      "## GitHub Integration",
+      "",
+      "- Use `gh` CLI for all GitHub operations",
+      "- Apply the appropriate `meeting:*` phase label to each phase issue",
+      "- Use `type:docs` for documentation-producing issues, `type:chore` for",
+      "  maintenance/organizational tasks the pipeline can action",
+      "- Do **not** file issues for human-owned action items \u2014 per the",
+      "  **Action-item filing policy** they live only in the notes",
+      "  `## Action Items` table",
+      "- Use `status:` labels to track progress (`status:ready`, `status:in-progress`, `status:done`)",
+      "- Reference the source meeting transcript in all created issues",
+      "- Link phase issues with `Depends on: #N` to enforce ordering",
+      "",
+      "## When to Shorten the Pipeline",
+      "",
+      "- **Short meetings** (<30 min, <2000 words): combine extract + notes into one session",
+      "- **No requirements or decisions**: Phase 1 skips creating the `meeting:draft` issue",
+      "- **Only action items**: extract + notes + link (3 phase issues)"
+    ].join("\n")
+  };
 }
-function renderPhaseTypeInvariantSection(excludeBundles = []) {
-  const rows = Object.keys(PHASE_LABEL_TYPE_MAP).filter(
-    (matcher) => !isPhaseLabelMatcherOwnedByExcluded(matcher, excludeBundles)
-  ).sort().map((matcher) => {
-    const display = matcher.endsWith(":") ? `${matcher}*` : matcher;
-    const kind = matcher.endsWith(":") ? "prefix" : "exact";
-    return `| \`${display}\` | ${kind} | \`${PHASE_LABEL_TYPE_MAP[matcher]}\` |`;
-  });
-  return [
-    "## Phase-label \u2192 `type:<bundle>` invariant",
-    "",
-    "Every phased-pipeline bundle pairs its `<bundle>:<phase>` labels",
-    "with exactly one `type:<bundle>` label. That type label is the",
-    "**dedup + dispatch signal**: agents de-duplicate downstream work",
-    'with `gh issue list --label "type:<bundle>"`, and Phase E derives',
-    "its funnel-tier sort key from the issue's `type:*` label. An issue",
-    "that carries the phase label but a conventional-commit `type:*`",
-    "(`type:feat`, `type:docs`, \u2026, stamped from its title prefix by the",
-    "generic create-issue workflow) is invisible to that dedup query and",
-    "mis-tiers in dispatch.",
-    "",
-    "The pairing below is derived from the canonical bundle-ownership",
-    "map \u2014 the same source of truth that generates the label registry.",
-    "Matchers ending in `*` match by prefix; the rest match exactly, and",
-    "an exact match always beats a prefix match.",
+var processMeetingSkill = {
+  name: "process-meeting",
+  description: "Process a meeting transcript through the 4-phase meeting analysis pipeline",
+  disableModelInvocation: true,
+  userInvocable: true,
+  context: "fork",
+  agent: "meeting-analyst",
+  platforms: { cursor: { exclude: true } },
+  instructions: [
+    "# Process Meeting",
     "",
-    "| Phase label | Match | Required type label |",
-    "|-------------|-------|---------------------|",
-    ...rows,
+    "Kick off meeting processing by executing Phase 1 (Extract) and",
+    "creating downstream phase issues for the remaining phases. Inputs",
+    "live in the **sibling-tree layout**: pass any file from",
+    "`<meetingsRoot>/notes/{type}/` or `<meetingsRoot>/transcripts/{type}/`",
+    "(both, notes-only, and transcript-only are all valid input cases).",
     "",
-    "### Enforcement",
+    "## Usage",
     "",
-    "The Phase D maintenance sweep runs the invariant in auto-correct",
-    "mode and emits one summary line:",
+    "/process-meeting <path-to-notes-or-transcript>",
     "",
-    "```",
-    "LABEL_INVARIANT_DONE mode=fix checked=<N> ok=<O> violations=<V> corrected=<C> flagged=<F>",
-    "```",
+    "## Basename-pairing algorithm",
     "",
-    "A **report-only** audit is available for repos that prefer",
-    "report-then-fix over auto-correct \u2014 same sweep, no mutations:",
+    "The user may pass either a notes-tree path or a transcripts-tree",
+    "path. Resolve the sibling implicitly via filesystem lookup \u2014",
+    "do **not** prompt the user or fail-loud when the sibling is",
+    "absent:",
     "",
-    "```bash",
-    ".claude/procedures/check-blocked.sh label-invariant        # report only",
-    ".claude/procedures/check-blocked.sh label-invariant --fix  # apply",
-    "```",
+    "1. Infer the **basename** (filename without the `.md` extension)",
+    "   and the `{internal,external}` partition from the provided path.",
+    "   Both segments are usually adjacent in the path \u2014",
+    "   `\u2026/notes/internal/2026-03-14-sprint-kickoff.md` yields basename",
+    "   `2026-03-14-sprint-kickoff` and type `internal`.",
+    "2. Determine the **input tree** from the path:",
+    "   - If the path contains `/notes/`, treat it as the notes input",
+    "     and look for the sibling at",
+    "     `<meetingsRoot>/transcripts/<type>/<basename>.md`.",
+    "   - If the path contains `/transcripts/`, treat it as the",
+    "     transcript input and look for the sibling at",
+    "     `<meetingsRoot>/notes/<type>/<basename>.md`.",
+    "   - If the path matches neither (e.g. an ad-hoc location), infer",
+    "     basename + type as best you can from the filename and",
+    "     surrounding folder segments, then proceed with whichever",
+    "     sibling-tree lookups succeed. Best-effort, never fail-loud.",
+    "3. Read **every** sibling that exists on disk. The combination",
+    "   (notes present, transcript present, both present) selects the",
+    "   Phase-1 input case from the **input-case matrix** in the",
+    "   `meeting-analyst` agent prompt.",
+    "4. A missing sibling is a normal outcome \u2014 proceed with whatever",
+    "   was found. Notes-only and transcript-only are both valid",
+    "   Phase-1 input cases; the agent never warns or prompts the",
+    "   user about the absence.",
     "",
-    "### Correction policy",
+    "## Steps",
     "",
-    "An issue must carry **exactly one** `type:*` label. Merely *adding*",
-    "the required type label to an issue that already carries a",
-    "conventional-commit one would leave two, making the funnel-tier sort",
-    "key (which reads the **first** `type:*` label) non-deterministic and",
-    "violating the label conventions. The correction therefore",
-    "**replaces**, in a single atomic `gh issue edit`, so the issue is",
-    "never observable carrying two `type:*` labels:",
+    "1. Resolve the basename, partition, and any sibling files using",
+    "   the **Basename-pairing algorithm** above",
+    "2. Execute Phase 1 (Extract) \u2014 categorize the available content into",
+    "   decisions, requirements, action items, open questions, and more.",
+    "   Tag each action item's disposition (`agent-workable` vs",
+    "   `human-owned`) per the agent's **Action-item filing policy** so",
+    "   Phase 4 keeps human-owned tasks out of the issue queue",
+    "3. Write the extraction to",
+    "   `<meetingsRoot>/insights/{type}/<basename>.md`",
+    "4. Create downstream phase issues using `gh issue create`:",
+    "   - `meeting:notes` issue (always)",
+    "   - `meeting:draft` issue (if requirements or decisions were found)",
+    "   - `meeting:link` issue (always)",
     "",
-    "| Issue state | Action |",
-    "|-------------|--------|",
-    "| Required type label present, nothing else | none \u2014 compliant, left untouched |",
-    "| No `type:*` label at all | **add** the required label |",
-    "| Only conventional-commit `type:*` label(s) | **replace** \u2014 remove them, add the required label |",
-    "| Required label present **plus** a stray conventional-commit one | **remove** the stray, leaving exactly one |",
-    "| A `type:*` label owned by a **different** bundle | **flag** `status:needs-attention` \u2014 never guessed at |",
-    "| Phase labels imply **two or more** type labels | **flag** `status:needs-attention` \u2014 never auto-corrected |",
+    ...renderIssueTypeAssignmentStep(),
+    "5. Each downstream issue includes `Depends on:` linking to its predecessor",
+    "6. Commit and push the extraction file",
     "",
-    "Only a conventional-commit `type:*` label is ever removed. A",
-    "`type:*` label owned by another bundle carries real routing",
-    "information, so the sweep refuses to guess and hands the issue to a",
-    "human instead. Ambiguity is narrower than it looks: all three",
-    "requirements bundles declare `type:requirement`, so every `req:*`",
-    "phase label resolves to the same type label \u2014 genuine ambiguity",
-    "needs phase labels from two bundles with *different* type labels.",
+    "## Input",
     "",
-    "`status:needs-attention` is applied **additively** \u2014 the base",
-    "`status:*` label always stays, per the additive-flag rule. Flagging",
-    "is idempotent: an issue already carrying the flag is reported but",
-    "not re-flagged."
-  ].join("\n");
-}
-function isPhaseLabelMatcherOwnedByExcluded(matcher, excludeBundles) {
-  if (excludeBundles.length === 0) {
-    return false;
-  }
-  let owned = false;
-  for (const [bundleName, ownership] of Object.entries(BUNDLE_OWNERSHIP)) {
-    if (!ownership.phaseLabelPrefixes.includes(matcher)) {
-      continue;
-    }
-    owned = true;
-    if (!excludeBundles.includes(bundleName)) {
-      return false;
-    }
-  }
-  return owned;
-}
-function renderPhaseTypeInvariantShellHelpers() {
-  const matchers = Object.keys(PHASE_LABEL_TYPE_MAP);
-  const exactMatchers = matchers.filter((m) => !m.endsWith(":")).sort();
-  const prefixMatchers = matchers.filter((m) => m.endsWith(":")).sort((a, b) => b.length - a.length || a.localeCompare(b));
-  const lines = [
-    "# Resolve ONE phase label to the `type:<bundle>` label its owning",
-    "# bundle declares. Echoes the label (with the `type:` prefix) or",
-    "# nothing when no bundle owns it. Exact-match branches come first,",
-    "# so `req:write` (requirements-writer) beats the `req:` prefix",
-    "# (requirements-analyst). Generated from BUNDLE_OWNERSHIP \u2014 do not",
-    "# hand-edit.",
-    "phase_label_type_of() {",
-    '  case "${1:-}" in'
-  ];
-  for (const matcher of exactMatchers) {
-    lines.push(`    ${matcher}) echo "${PHASE_LABEL_TYPE_MAP[matcher]}" ;;`);
-  }
-  for (const matcher of prefixMatchers) {
-    lines.push(`    ${matcher}*) echo "${PHASE_LABEL_TYPE_MAP[matcher]}" ;;`);
-  }
-  lines.push(
-    "    *) : ;;",
-    "  esac",
-    "}",
+    "Provide a path to a file in either `notes/` or `transcripts/`. The",
+    "agent will look up the sibling automatically via basename match. A",
+    "missing sibling is a normal case (notes-only or transcript-only) \u2014",
+    "the agent handles all three input cases.",
     "",
-    "# Return 0 when the argument is a conventional-commit `type:*`",
-    "# label \u2014 the ONLY type labels the invariant correction may remove.",
-    "# A `type:*` label owned by another bundle is never removed; the",
-    "# issue is flagged for human triage instead.",
-    "is_conventional_type_label() {",
-    `  case "\${1:-}" in`,
-    `    ${CONVENTIONAL_COMMIT_TYPE_LABELS.join("|")}) return 0 ;;`,
-    "    *) return 1 ;;",
-    "  esac",
-    "}",
+    "## Output",
     "",
-    "# Resolve an issue's FULL label list (one label per line on stdin)",
-    "# to the type label the phase-label invariant requires. Emits",
-    "# KEY=VALUE assignments the caller parses:",
-    "#   OUTCOME=none      \u2014 no recognised phase label; invariant N/A",
-    "#   OUTCOME=match     \u2014 plus TYPE_LABEL=<type:bundle>",
-    "#   OUTCOME=ambiguous \u2014 plus CANDIDATE_TYPE_LABELS=<space-separated>",
-    "#   PHASE_LABELS=<space-separated recognised phase labels>",
-    "phase_type_of() {",
-    "  local label resolved",
-    '  local matched_types=""',
-    '  local matched_phase=""',
-    "  while IFS= read -r label; do",
-    '    [ -z "$label" ] && continue',
-    '    resolved=$(phase_label_type_of "$label")',
-    '    [ -z "$resolved" ] && continue',
-    '    matched_phase="${matched_phase}${label} "',
-    '    case " ${matched_types} " in',
-    '      *" ${resolved} "*) ;;',
-    '      *) matched_types="${matched_types}${resolved} " ;;',
-    "    esac",
-    "  done",
-    "  local count=0",
-    "  for resolved in $matched_types; do",
-    "    count=$((count + 1))",
-    "  done",
-    '  if [ "$count" -eq 0 ]; then',
-    '    echo "OUTCOME=none"',
-    '  elif [ "$count" -eq 1 ]; then',
-    '    echo "OUTCOME=match"',
-    '    echo "TYPE_LABEL=${matched_types% }"',
-    "  else",
-    '    echo "OUTCOME=ambiguous"',
-    '    echo "CANDIDATE_TYPE_LABELS=${matched_types% }"',
-    "  fi",
-    '  echo "PHASE_LABELS=${matched_phase% }"',
-    "}"
-  );
-  return lines.join("\n");
-}
-function buildPhaseLabelTypeMap() {
-  const map = {};
-  for (const [bundleName, ownership] of Object.entries(BUNDLE_OWNERSHIP)) {
-    if (ownership.phaseLabelPrefixes.length === 0) {
-      continue;
-    }
-    if (ownership.typeLabels.length !== 1) {
-      throw new Error(
-        `BUNDLE_OWNERSHIP["${bundleName}"] declares ${ownership.phaseLabelPrefixes.length} phase-label matcher(s) but ${ownership.typeLabels.length} type label(s); a phase label must pair with exactly one type label`
-      );
-    }
-    const typeLabel = `type:${ownership.typeLabels[0]}`;
-    for (const matcher of ownership.phaseLabelPrefixes) {
-      const existing = map[matcher];
-      if (existing !== void 0 && existing !== typeLabel) {
-        throw new Error(
-          `Phase-label matcher "${matcher}" resolves to both "${existing}" and "${typeLabel}"; a matcher must imply exactly one type label`
-        );
-      }
-      map[matcher] = typeLabel;
-    }
-  }
-  return map;
-}
-function isTypeLabelOwnedByExcluded(typeLabel, excludedBundles) {
-  if (excludedBundles.length === 0) {
-    return false;
-  }
-  for (const bundleName of excludedBundles) {
-    const ownership = BUNDLE_OWNERSHIP[bundleName];
-    if (!ownership) {
-      continue;
-    }
-    if (ownership.typeLabels.includes(typeLabel)) {
-      const owners = findOwnersOfTypeLabel(typeLabel);
-      const allExcluded = owners.every(
-        (owner) => excludedBundles.includes(owner)
-      );
-      if (allExcluded) {
-        return true;
+    "- A structured extraction at",
+    "  `<meetingsRoot>/insights/{type}/<basename>.md`",
+    "- Phase issues with `meeting:*` labels for downstream agent sessions",
+    "  to pick up (notes, draft, link)"
+  ].join("\n")
+};
+function buildMeetingAnalysisBundle(tier = AGENT_MODEL.BALANCED) {
+  return {
+    name: "meeting-analysis",
+    description: "Meeting transcript processing workflow with 4-phase pipeline (extract, notes, draft, link)",
+    appliesWhen: () => true,
+    rules: [
+      {
+        name: "meeting-processing-workflow",
+        description: "Describes the 4-phase meeting processing pipeline, extraction taxonomy, and labeling conventions",
+        scope: AGENT_RULE_SCOPE.ALWAYS,
+        content: [
+          "# Meeting Processing Workflow",
+          "",
+          "Use `/process-meeting <path>` to process a meeting through a",
+          "4-phase pipeline (extract \u2192 notes \u2192 draft \u2192 link). Each phase runs as a",
+          "separate agent session tracked by a GitHub issue with a `meeting:*` label.",
+          "See the `meeting-analyst` agent definition for full workflow details.",
+          "",
+          "Meeting artifacts live in **three parallel trees** rooted at the",
+          "project's meetings root:",
+          "",
+          "- `transcripts/{internal,external}/` \u2014 verbatim transcripts (evidence)",
+          "- `notes/{internal,external}/` \u2014 curated narrative summary",
+          "  (input + Phase 2 output)",
+          "- `insights/{internal,external}/` \u2014 structured extraction (Phase 1 output)",
+          "",
+          "The three trees share identical basenames so a meeting's siblings",
+          "are looked up by filename, not by frontmatter cross-references.",
+          "Phase 1 accepts every input case (notes + transcript, notes only,",
+          "or transcript only) and Phase 2 enhances the notes file in place",
+          "rather than authoring it from scratch.",
+          "",
+          "Notes and insights files may carry optional frontmatter fields",
+          "`slug`, `source`, `transcript_available`, and `confidence`",
+          "alongside the existing `meeting_type` and `areas` fields. Missing",
+          "frontmatter is treated as a normal input case \u2014 never fail-loud.",
+          "",
+          "Meeting notes may declare a `meeting_type` (one of the project's",
+          "recognized types) and an `areas: [...]` list. The `meeting_type`",
+          "resolves to a generic kind \u2014 `planning` / `review` / `brainstorm` /",
+          "`standup` / `external` / `other` \u2014 that drives type-specific",
+          "extraction rules in phases 1\u20132. The `areas` list scopes phase-4",
+          "direct edits to the doc-root sub-folders declared in the project's",
+          "**Area \u2192 doc-root mapping** table. When both fields are absent",
+          "the pipeline falls back to the default workflow (kind `other`,",
+          "no area gating).",
+          "",
+          "Phase 4 applies an **agent-workability split** to action items:",
+          "items that yield a documentation deliverable an agent can author",
+          "are filed through their dedicated downstream channel",
+          "(`req:write`, `docs:write`, `bcm:*`, `research:scope`, roadmap",
+          "follow-up); human-owned tasks (send / schedule / install /",
+          "decide / communicate / get-access / build-elsewhere) are",
+          "recorded **only** in the notes `## Action Items` table, which is",
+          "the **system of record for human follow-ups** \u2014 no GitHub issue",
+          "is filed for them. Consumers tune or disable the split via",
+          "`AgentConfigOptions.meetings.actionItemFiling`."
+        ].join("\n"),
+        platforms: {
+          cursor: { exclude: true }
+        },
+        tags: ["workflow"]
       }
-    }
-  }
-  return false;
-}
-function isPhaseLabelOwnedByExcluded(phaseLabel, excludedBundles) {
-  if (excludedBundles.length === 0) {
-    return false;
-  }
-  for (const bundleName of excludedBundles) {
-    const ownership = BUNDLE_OWNERSHIP[bundleName];
-    if (!ownership) {
-      continue;
-    }
-    for (const entry of ownership.phaseLabelPrefixes) {
-      if (entry.endsWith(":")) {
-        if (phaseLabel.startsWith(entry)) {
-          return true;
-        }
-      } else if (phaseLabel === entry) {
-        return true;
+    ],
+    skills: [processMeetingSkill],
+    subAgents: [buildMeetingAnalystSubAgent(tier)],
+    labels: [
+      {
+        name: "type:meeting-processing",
+        color: "5319E7",
+        description: "Meeting transcript processing pipeline"
+      },
+      {
+        name: "meeting:extract",
+        color: "C5DEF5",
+        description: "Phase 1: raw extraction from a meeting transcript"
+      },
+      {
+        name: "meeting:notes",
+        color: "BFDADC",
+        description: "Phase 2: curated notes derived from an extraction"
+      },
+      {
+        name: "meeting:draft",
+        color: "D4C5F9",
+        description: "Phase 3: draft follow-up issues proposed from notes"
+      },
+      {
+        name: "meeting:link",
+        color: "FEF2C0",
+        description: "Phase 4: linking/reconciling drafted issues with existing work"
       }
-    }
-  }
-  return false;
-}
-function isScheduledTaskOwnedByExcluded(taskId, excludedBundles) {
-  if (excludedBundles.length === 0) {
-    return false;
-  }
-  for (const bundleName of excludedBundles) {
-    const ownership = BUNDLE_OWNERSHIP[bundleName];
-    if (!ownership) {
-      continue;
-    }
-    if (ownership.scheduledTaskIds.includes(taskId)) {
-      return true;
-    }
-  }
-  return false;
-}
-function hasAnyDocsEmittingBundle(excludedBundles) {
-  for (const [bundleName, ownership] of Object.entries(BUNDLE_OWNERSHIP)) {
-    if (!ownership.emitsDocs) {
-      continue;
-    }
-    if (!excludedBundles.includes(bundleName)) {
-      return true;
-    }
-  }
-  return false;
-}
-function hasAnyDownstreamIssueKindBundle(excludedBundles) {
-  for (const [bundleName, ownership] of Object.entries(BUNDLE_OWNERSHIP)) {
-    if (!ownership.downstreamIssueKinds) {
-      continue;
-    }
-    if (!excludedBundles.includes(bundleName)) {
-      return true;
-    }
-  }
-  return false;
-}
-function findOwnersOfTypeLabel(typeLabel) {
-  const owners = [];
-  for (const [bundleName, ownership] of Object.entries(BUNDLE_OWNERSHIP)) {
-    if (ownership.typeLabels.includes(typeLabel)) {
-      owners.push(bundleName);
-    }
-  }
-  return owners;
+    ]
+  };
 }
+var meetingAnalysisBundle = buildMeetingAnalysisBundle();
 
 // src/agent/bundles/run-ratio.ts
 var DEFAULT_DISPATCH_TO_HOUSEKEEPING_RATIO = 4;
@@ -19416,6 +19598,8 @@ function buildPeopleProfileAnalystSubAgent(paths, issueDefaults, tier) {
       `   - \`priority:${labelsForPhase(issueDefaults, "company:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "company:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "   The issue body must include:",
       "   - A **discovery source** line naming this person profile",
       "     (`Discovered while profiling: <person name>`)",
@@ -19436,6 +19620,8 @@ function buildPeopleProfileAnalystSubAgent(paths, issueDefaults, tier) {
       `   - \`priority:${labelsForPhase(issueDefaults, "software:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "software:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "   The issue body must include:",
       "   - A **discovery source** line naming this person profile",
       "     (`Discovered while profiling: <person name>`)",
@@ -19718,6 +19904,8 @@ function buildProfilePersonSkill(paths, issueDefaults) {
       `   \`priority:${labelsForPhase(issueDefaults, "people:research").priority}\`, and \`status:${labelsForPhase(issueDefaults, "people:research").status}\`. Body must include the`,
       "   person's name, selected role, primary company, framing, and any",
       "   overrides.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 1 (Research) of the people-profile-analyst agent.",
       "3. Phase 1 creates the `people:draft` issue. Phase 2 may create a",
       "   `people:followup` issue. Each downstream issue declares its",
@@ -19809,6 +19997,8 @@ function buildRefreshPersonSkill(paths, issueDefaults) {
       "1. Create a `people:refresh` issue with `type:people-profile`,",
       `   \`priority:${labelsForPhase(issueDefaults, "people:refresh").priority}\`, and \`status:${labelsForPhase(issueDefaults, "people:refresh").status}\`. Body must include the`,
       "   profile path and any overrides.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 4 (Refresh) of the people-profile-analyst agent.",
       "",
       "## Output",
@@ -23505,6 +23695,8 @@ function buildRegulatoryResearchAnalystSubAgent(paths, issueDefaults) {
       `   - \`priority:${labelsForPhase(issueDefaults, "company:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "company:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "9. **Verify all handoffs were created** before committing.",
       "",
       "10. **Commit and push** the regulation page. Close the research",
@@ -23615,6 +23807,8 @@ function buildRegulatoryResearchAnalystSubAgent(paths, issueDefaults) {
       `   - \`priority:${labelsForPhase(issueDefaults, "req:scan").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "req:scan").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "   The body must also:",
       "   - Identify the target category as **SEC** (security & compliance)",
       "     in the body so the downstream writer phase picks up the right",
@@ -23634,6 +23828,8 @@ function buildRegulatoryResearchAnalystSubAgent(paths, issueDefaults) {
       `   - \`priority:${labelsForPhase(issueDefaults, "company:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "company:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "6. **Create `people:research` issues** for notable regulatory",
       "   leaders (commissioners, agency directors, lead policy authors)",
       "   mentioned on the regulation page. Keep this list small \u2014 at most",
@@ -23645,6 +23841,8 @@ function buildRegulatoryResearchAnalystSubAgent(paths, issueDefaults) {
       `   - \`priority:${labelsForPhase(issueDefaults, "people:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "people:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "7. **Commit and push** the updated regulation page. Close the",
       "   impact issue.",
       "",
@@ -23812,6 +24010,8 @@ function buildScanRegulatoryLandscapeSkill(paths, issueDefaults) {
       `   \`priority:${labelsForPhase(issueDefaults, "regulatory:scan").priority}\`, and \`status:${labelsForPhase(issueDefaults, "regulatory:scan").status}\`. The body must include the`,
       "   scope slug, the scope type, and any known regulations to include",
       "   or exclude.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 1 (Scan) of the regulatory-research-analyst agent.",
       "3. Phase 1 writes the scan report and creates one",
       "   `regulatory:research` issue per prioritized regulation.",
@@ -23888,6 +24088,8 @@ function buildResearchRegulationSkill(paths, issueDefaults) {
       `   \`type:regulatory-research\`, \`priority:${labelsForPhase(issueDefaults, "regulatory:research").priority}\`, and`,
       `   \`status:${labelsForPhase(issueDefaults, "regulatory:research").status}\`. The body must include the scope slug and the`,
       "   regulation slug.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 2 (Research) of the regulatory-research-analyst",
       "   agent. The agent runs 6\u201312 targeted web searches and populates",
       "   the regulation page.",
@@ -23955,6 +24157,8 @@ function buildImpactRegulationSkill(paths, issueDefaults) {
       `   \`status:${labelsForPhase(issueDefaults, "regulatory:impact").status}\` (or \`status:blocked\` when still dependent on a`,
       "   Phase 2 research issue). Body must include the regulation page",
       "   path.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 3 (Impact) of the regulatory-research-analyst",
       "   agent. No web searches \u2014 pure synthesis from the regulation",
       "   page and project context.",
@@ -26790,6 +26994,8 @@ function buildWriteRequirementSkill(paths, issueDefaults) {
       "   Body must include the category, tier, output path, and a pointer",
       "   to the upstream proposal (or a direct user description if no",
       "   proposals file exists).",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute the write phase of the requirements-writer agent.",
       "3. The agent writes one requirement document, updates the category",
       "   index, opens a PR, and closes the issue.",
@@ -27379,6 +27585,8 @@ function buildRequirementsAnalystSubAgent(paths, issueDefaults) {
       `   \`--label "tier:<tier-slug>"\`, \`--label "status:${labelsForPhase(issueDefaults, "req:write").status}"\`, and`,
       `   \`--label "priority:${labelsForPhase(issueDefaults, "req:write").priority}"\`.`,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "   The body must carry the three writer-required fields in an",
       "   `## Objective` block, written as bold-prefixed lines so the",
       "   writer's intake parser can pull them out, plus the reserved-ID",
@@ -27525,6 +27733,8 @@ function buildScanRequirementsSkill(issueDefaults) {
       "",
       `1. Create a \`req:scan\` issue with \`type:requirement\`, \`priority:${labelsForPhase(issueDefaults, "req:scan").priority}\`,`,
       `   and \`status:${labelsForPhase(issueDefaults, "req:scan").status}\`. Body must list the files to read and the scan scope.`,
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 1 (Scan) of the requirements-analyst agent.",
       "3. If gaps are found, a `req:draft-trace` issue is created automatically.",
       "",
@@ -28573,6 +28783,7 @@ function buildRequirementsReviewerSubAgent(paths, issueDefaults) {
       "- Labels: `type:requirement`, `req:write`, the matching",
       "  `tier:*` label derived from the referencing document's Tier,",
       `  \`priority:${labelsForPhase(issueDefaults, "req:write").priority}\`, \`status:${labelsForPhase(issueDefaults, "req:write").status}\`.`,
+      ...renderIssueTypeAssignmentStep({ indent: "", bullet: true }),
       "- If any of Category / Tier / Output Path cannot be derived from",
       "  the referencing document, open the follow-up with",
       "  `status:needs-attention` and a `Missing:` line, per the same",
@@ -28728,6 +28939,8 @@ function buildReviewRequirementsSkill(paths, issueDefaults) {
       `   \`priority:${labelsForPhase(issueDefaults, "req:review").priority}\`, and \`status:${labelsForPhase(issueDefaults, "req:review").status}\`. Body must include the`,
       "   scope, the requirements root (or accept the default), and the",
       "   output path.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute the review phase of the requirements-reviewer agent.",
       "3. The agent runs the 12-check audit, writes a structured report",
       "   grouped by Critical / Warning / Info (plus a separate",
@@ -28830,6 +29043,8 @@ function buildDeprecateRequirementSkill(_paths, issueDefaults) {
       `   \`priority:${labelsForPhase(issueDefaults, "req:deprecate").priority}\`, and \`status:${labelsForPhase(issueDefaults, "req:deprecate").status}\`. Body must include the`,
       "   Targets, Transition, and Reason sections above (optionally",
       "   `Pre-approved: yes`).",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute the deprecation phase of the requirements-reviewer",
       "   agent.",
       "3. The agent verifies inputs, pauses for human confirmation (or",
@@ -29404,6 +29619,8 @@ function buildResearchSkill(paths, issueDefaults) {
       "1. Create a `research:scope` issue with `type:research`,",
       `   \`priority:${labelsForPhase(issueDefaults, "research:scope").priority}\`, and \`status:${labelsForPhase(issueDefaults, "research:scope").status}\`. Body must include the`,
       "   verbatim question, authorized sources, and any overrides.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 1 (Scope) of the research-analyst agent.",
       "3. Phase 1 creates `research:slice` issues (one per slice) and a",
       "   single `research:verify` issue. Each downstream issue declares",
@@ -30219,6 +30436,8 @@ function buildSoftwareProfileAnalystSubAgent(paths, issueDefaults, tier) {
       `   - \`priority:${labelsForPhase(issueDefaults, "bcm:outline").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "bcm:outline").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "   The issue body must include:",
       "   - A **discovery source** line naming this software profile",
       "     (`Discovered while mapping: <product name>`)",
@@ -30287,6 +30506,8 @@ function buildSoftwareProfileAnalystSubAgent(paths, issueDefaults, tier) {
       "   `software:research` phase with `type:software-profile`,",
       `   \`priority:${labelsForPhase(issueDefaults, "software:research").priority}\`, and \`status:${labelsForPhase(issueDefaults, "software:research").status}\`.`,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "3. **Enqueue a `company:research` issue for the vendor company** if",
       "   no matching profile already exists under `<COMPANY_PROFILES_DIR>/`.",
       "   The vendor (the company that builds or maintains the product)",
@@ -30299,6 +30520,8 @@ function buildSoftwareProfileAnalystSubAgent(paths, issueDefaults, tier) {
       `   - \`priority:${labelsForPhase(issueDefaults, "company:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "company:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "   The issue body must include:",
       "   - A **discovery source** line naming this software profile",
       "     (`Discovered while profiling: <product name>`)",
@@ -30318,6 +30541,8 @@ function buildSoftwareProfileAnalystSubAgent(paths, issueDefaults, tier) {
       `   - \`priority:${labelsForPhase(issueDefaults, "people:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "people:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "   The issue body must include:",
       "   - A **discovery source** line naming this software profile",
       "     (`Discovered while profiling: <product name>`)",
@@ -30508,6 +30733,8 @@ function buildProfileSoftwareSkill(paths, issueDefaults) {
       "1. Create a `software:research` issue with `type:software-profile`,",
       `   \`priority:${labelsForPhase(issueDefaults, "software:research").priority}\`, and \`status:${labelsForPhase(issueDefaults, "software:research").status}\`. Body must include the`,
       "   product name, selected type, framing, and any overrides.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 1 (Research) of the software-profile-analyst",
       "   agent.",
       "3. Phase 1 creates the `software:profile` issue. Phase 2 creates",
@@ -30596,6 +30823,8 @@ function buildMapSoftwareSkill(paths, issueDefaults) {
       "1. Create a `software:map` issue with `type:software-profile`,",
       `   \`priority:${labelsForPhase(issueDefaults, "software:map").priority}\`, and \`status:${labelsForPhase(issueDefaults, "software:map").status}\`. Body must include the`,
       "   profile path and any overrides.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 4 (Map) of the software-profile-analyst agent.",
       "3. Phase 4 writes the `## Capability Mapping` section, enqueues",
       "   `bcm:outline` issues for unmapped features above the threshold,",
@@ -31208,6 +31437,8 @@ function buildStandardsResearchAnalystSubAgent(paths, issueDefaults) {
       `   - \`priority:${labelsForPhase(issueDefaults, "company:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "company:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "6. **Create `people:research` issues** for every entry in *People of",
       "   Interest* that does not already have a canonical person profile",
       "   or an open `people:research` issue. The `people-profile` bundle",
@@ -31219,6 +31450,8 @@ function buildStandardsResearchAnalystSubAgent(paths, issueDefaults) {
       `   - \`priority:${labelsForPhase(issueDefaults, "people:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "people:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "7. **Verify all handoffs were created** before committing. For each",
       "   entity in both tables, confirm an existing profile or a fresh",
       "   handoff issue exists. Do not commit with missing handoffs.",
@@ -31512,6 +31745,8 @@ function buildStandardsResearchAnalystSubAgent(paths, issueDefaults) {
       `   - \`priority:${labelsForPhase(issueDefaults, "company:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "company:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "6. **Hand off canonical people profiles** by creating one",
       "   `people:research` issue per leadership entry that does not",
       "   already have a canonical profile or an open `people:research`",
@@ -31523,6 +31758,8 @@ function buildStandardsResearchAnalystSubAgent(paths, issueDefaults) {
       `   - \`priority:${labelsForPhase(issueDefaults, "people:research").priority}\``,
       `   - \`status:${labelsForPhase(issueDefaults, "people:research").status}\``,
       "",
+      ...renderIssueTypeAssignmentStep(),
+      "",
       "7. **Commit and push** the organization page. Close the",
       "   organizations issue.",
       "",
@@ -31697,6 +31934,8 @@ function buildScopeStandardsResearchSkill(paths, issueDefaults) {
       `   \`priority:${labelsForPhase(issueDefaults, "standards:scope").priority}\`, and \`status:${labelsForPhase(issueDefaults, "standards:scope").status}\`. The body must include the`,
       "   standard slug, the list of target versions (or a request to",
       "   enumerate), and any known governance bodies.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 1 (Scope) of the standards-research-analyst agent.",
       "3. Phase 1 writes the query plan and creates one `standards:research`",
       "   issue per target version, one `standards:compare` issue (blocked",
@@ -31761,6 +32000,8 @@ function buildResearchStandardSkill(paths, issueDefaults) {
       "1. Create a `standards:research` issue with",
       `   \`type:standards-research\`, \`priority:${labelsForPhase(issueDefaults, "standards:research").priority}\`, and \`status:${labelsForPhase(issueDefaults, "standards:research").status}\`.`,
       "   The body must include the standard slug and the version slug.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 2 (Research) of the standards-research-analyst",
       "   agent. The agent runs 6\u201310 targeted web searches and populates",
       "   the version page.",
@@ -31834,6 +32075,8 @@ function buildCompareStandardsSkill(paths, issueDefaults) {
       `   \`type:standards-research\`, \`priority:${labelsForPhase(issueDefaults, "standards:compare").priority}\`, and \`status:${labelsForPhase(issueDefaults, "standards:compare").status}\`.`,
       "   Body must include the standard slug and the list of version",
       "   pages under comparison.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 3 (Compare) of the standards-research-analyst",
       "   agent. No web searches \u2014 pure synthesis from the version pages.",
       "",
@@ -31902,6 +32145,8 @@ function buildExtensionStandardSkill(paths, issueDefaults) {
       "   The body must include the standard slug, the entity slug, the",
       "   closest resource, and a link to the source BCM or canvas",
       "   document.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 4 (Extension) of the standards-research-analyst",
       "   agent. The agent runs 4\u20138 targeted web searches against",
       "   community registries, implementation guides, and working-group",
@@ -31967,6 +32212,8 @@ function buildOrganizationsStandardSkill(paths, issueDefaults) {
       `   \`type:standards-research\`, \`priority:${labelsForPhase(issueDefaults, "standards:organizations").priority}\`, and \`status:${labelsForPhase(issueDefaults, "standards:organizations").status}\`.`,
       "   Body must include the standard slug, the organization slug, and",
       "   the organization's governance role.",
+      "",
+      ...renderIssueTypeAssignmentStep(),
       "2. Execute Phase 5 (Organizations) of the",
       "   standards-research-analyst agent. The agent runs 4\u20138 targeted",
       "   web searches.",
@@ -32276,6 +32523,14 @@ var UPSTREAM_CONFIGULATOR_DOCS_SUMMARY = [
   "",
   "Pick the `type:*` and matching prefix that describes the work (`feat:`, `fix:`, `chore:`, `docs:`, `refactor:`). Set `priority:*` from the urgency and use `status:blocked` instead of `status:ready` if the issue depends on another open issue.",
   "",
+  "Then set the new issue's **GitHub issue type** \u2014 a separate field from the `type:*` label, which `gh issue create` cannot set. Derive it from the title prefix (`epic:` \u2192 Epic, `feat:` \u2192 Feature, `fix:` \u2192 Bug, everything else \u2192 Task). The local `.claude/procedures/set-issue-type.sh` helper resolves owner/repo from the **current** checkout, so a cross-repo filing needs the `updateIssueIssueType` GraphQL flow with an explicit owner/repo:",
+  "",
+  "```sh",
+  "gh api graphql -f query='query($owner:String!,$repo:String!){repository(owner:$owner,name:$repo){issueTypes(first:50){nodes{id name}}}}' -f owner=codedrifters -f repo=packages",
+  "gh issue view <issue-number> --repo codedrifters/packages --json id --jq '.id'",
+  "gh api graphql -f query='mutation($issueId:ID!,$typeId:ID!){updateIssueIssueType(input:{issueId:$issueId,issueTypeId:$typeId}){issue{number issueType{name}}}}' -f issueId=<issue-node-id> -f typeId=<issue-type-node-id>",
+  "```",
+  "",
   "See `.claude/rules/upstream-configulator-docs-detail.md` for the full reference \u2014 extended `gh` recipes, common pitfalls (rate limits, base64 decoding, search vs. browse), and a complete issue-creation walkthrough."
 ].join("\n");
 var UPSTREAM_CONFIGULATOR_DOCS_DETAIL = [
@@ -32384,6 +32639,16 @@ var UPSTREAM_CONFIGULATOR_DOCS_DETAIL = [
   "- `priority:*` \u2014 pick exactly one of `priority:critical`, `priority:high`, `priority:medium`, `priority:low`, `priority:trivial`. Default to `priority:medium` when nothing in the request signals urgency. Use `priority:high` for blockers and `priority:critical` only for outages or release-blocking work.",
   "- `status:*` \u2014 `status:ready` for self-contained issues, `status:blocked` when the issue declares `Depends on: #<n>` against another open issue.",
   "",
+  "### GitHub issue type",
+  "",
+  "The GitHub **issue type** (Epic / Feature / Bug / Task) is a separate field from the `type:*` label, and `gh issue create` cannot set it. Derive it from the title prefix \u2014 `epic:` \u2192 Epic, `feat:` \u2192 Feature, `fix:` \u2192 Bug, everything else \u2192 Task \u2014 and apply it in a follow-up call. The bundled `.claude/procedures/set-issue-type.sh` helper resolves owner/repo from the **current** checkout, so a cross-repo filing against `codedrifters/packages` uses the `updateIssueIssueType` GraphQL flow with an explicit owner/repo instead:",
+  "",
+  "```sh",
+  "gh api graphql -f query='query($owner:String!,$repo:String!){repository(owner:$owner,name:$repo){issueTypes(first:50){nodes{id name}}}}' -f owner=codedrifters -f repo=packages",
+  "gh issue view <issue-number> --repo codedrifters/packages --json id --jq '.id'",
+  "gh api graphql -f query='mutation($issueId:ID!,$typeId:ID!){updateIssueIssueType(input:{issueId:$issueId,issueTypeId:$typeId}){issue{number issueType{name}}}}' -f issueId=<issue-node-id> -f typeId=<issue-type-node-id>",
+  "```",
+  "",
   "### Worked example",
   "",
   "Suppose configulator's `software-profile-analyst` agent prompt is missing a step you need. Instead of forking the prompt locally:",
@@ -41195,6 +41460,7 @@ export {
   DEFAULT_DECOMPOSITION_TEMPLATE,
   DEFAULT_DISPATCH_MODEL,
   DEFAULT_DISPATCH_TO_HOUSEKEEPING_RATIO,
+  DEFAULT_GITHUB_ISSUE_TYPE,
   DEFAULT_HOUSEKEEPING_MODEL,
   DEFAULT_ISSUE_PRIORITY,
   DEFAULT_ISSUE_STATUS,
@@ -41241,6 +41507,8 @@ export {
   DEFAULT_UNBLOCK_DEPENDENTS_ENABLED,
   DEFAULT_UPSTREAM_CONFIGULATOR_ENABLED,
   DOCS_SYNC_AUDIT_SCHEMA_VERSION,
+  GITHUB_ISSUE_TYPES,
+  GITHUB_ISSUE_TYPE_BY_TITLE_PREFIX,
   JsiiFaker,
   LAYOUT_ENFORCEMENT,
   LAYOUT_ROOT_BY_PROJECT_TYPE,
@@ -41265,6 +41533,7 @@ export {
   ResetTask,
   SCHEDULED_TASK_MODEL_VALUES,
   SCOPE_CLASS_VALUES,
+  SET_ISSUE_TYPE_HELPER_PATH,
   SHARED_EDITING_CONFLICT_STRATEGY_VALUES,
   STARLIGHT_ROLE,
   SUPPRESSED_WORKFLOW_RULE_NAMES,
@@ -41350,6 +41619,7 @@ export {
   formatLayoutViolation,
   formatStarlightSingletonViolation,
   getLatestEligibleVersion,
+  githubIssueTypeForTitle,
   githubWorkflowBundle,
   hasAnyDocsEmittingBundle,
   hasAnyDownstreamIssueKindBundle,
@@ -41407,10 +41677,14 @@ export {
   renderCustomDocSections,
   renderExtractApiProcedure,
   renderFocusSection,
+  renderGithubIssueTypeSection,
+  renderGithubIssueTypeSectionLines,
   renderIssueTemplatesBundleHook,
   renderIssueTemplatesCheckerScript,
   renderIssueTemplatesRuleContent,
   renderIssueTemplatesStarterPage,
+  renderIssueTypeAssignmentBlanket,
+  renderIssueTypeAssignmentStep,
   renderMeetingTypesSection,
   renderNextRequirementIdProcedure,
   renderPhaseTypeInvariantSection,
@@ -41427,6 +41701,7 @@ export {
   renderScheduledTasksSection,
   renderScopeGateSection,
   renderScopeGateShellHelpers,
+  renderSetIssueTypeFallbackLines,
   renderSharedEditingBundleHook,
   renderSharedEditingHelperScript,
   renderSharedEditingRuleContent,
@@ -41437,6 +41712,7 @@ export {
   renderStripToolArtifactTagsProcedure,
   renderTemporalFramingCheckerScript,
   renderTemporalFramingRuleContent,
+  renderTitlePrefixTypeBullets,
   renderUnblockDependentsScript,
   renderUnblockDependentsSection,
   requirementsAnalystBundle,