@codedrifters/configulator 0.0.405 → 0.0.407

package/lib/index.js

@@ -228,6 +228,7 @@ __export(index_exports, {
   DEFAULT_DECOMPOSITION_TEMPLATE: () => DEFAULT_DECOMPOSITION_TEMPLATE,
   DEFAULT_DISPATCH_MODEL: () => DEFAULT_DISPATCH_MODEL,
   DEFAULT_DISPATCH_TO_HOUSEKEEPING_RATIO: () => DEFAULT_DISPATCH_TO_HOUSEKEEPING_RATIO,
+  DEFAULT_GITHUB_ISSUE_TYPE: () => DEFAULT_GITHUB_ISSUE_TYPE,
   DEFAULT_HOUSEKEEPING_MODEL: () => DEFAULT_HOUSEKEEPING_MODEL,
   DEFAULT_ISSUE_PRIORITY: () => DEFAULT_ISSUE_PRIORITY,
   DEFAULT_ISSUE_STATUS: () => DEFAULT_ISSUE_STATUS,
@@ -274,6 +275,9 @@ __export(index_exports, {
   DEFAULT_UNBLOCK_DEPENDENTS_ENABLED: () => DEFAULT_UNBLOCK_DEPENDENTS_ENABLED,
   DEFAULT_UPSTREAM_CONFIGULATOR_ENABLED: () => DEFAULT_UPSTREAM_CONFIGULATOR_ENABLED,
   DOCS_SYNC_AUDIT_SCHEMA_VERSION: () => DOCS_SYNC_AUDIT_SCHEMA_VERSION,
+  GITHUB_ISSUE_TYPES: () => GITHUB_ISSUE_TYPES,
+  GITHUB_ISSUE_TYPE_BY_TITLE_PREFIX: () => GITHUB_ISSUE_TYPE_BY_TITLE_PREFIX,
+  ISSUE_TEMPLATES_GENERATED_SUFFIX: () => ISSUE_TEMPLATES_GENERATED_SUFFIX,
   JsiiFaker: () => JsiiFaker,
   LAYOUT_ENFORCEMENT: () => LAYOUT_ENFORCEMENT,
   LAYOUT_ROOT_BY_PROJECT_TYPE: () => LAYOUT_ROOT_BY_PROJECT_TYPE,
@@ -298,6 +302,7 @@ __export(index_exports, {
   ResetTask: () => ResetTask,
   SCHEDULED_TASK_MODEL_VALUES: () => SCHEDULED_TASK_MODEL_VALUES,
   SCOPE_CLASS_VALUES: () => SCOPE_CLASS_VALUES,
+  SET_ISSUE_TYPE_HELPER_PATH: () => SET_ISSUE_TYPE_HELPER_PATH,
   SHARED_EDITING_CONFLICT_STRATEGY_VALUES: () => SHARED_EDITING_CONFLICT_STRATEGY_VALUES,
   STARLIGHT_ROLE: () => STARLIGHT_ROLE,
   SUPPRESSED_WORKFLOW_RULE_NAMES: () => SUPPRESSED_WORKFLOW_RULE_NAMES,
@@ -368,6 +373,7 @@ __export(index_exports, {
   checkLinksProcedure: () => checkLinksProcedure,
   classifyIssueScope: () => classifyIssueScope,
   classifyRun: () => classifyRun,
+  collectIssueTemplateRecipeStubs: () => collectIssueTemplateRecipeStubs,
   companyProfileBundle: () => companyProfileBundle,
   compileFencedSamples: () => compileFencedSamples,
   createApiDiffCheck: () => createApiDiffCheck,
@@ -383,6 +389,7 @@ __export(index_exports, {
   formatLayoutViolation: () => formatLayoutViolation,
   formatStarlightSingletonViolation: () => formatStarlightSingletonViolation,
   getLatestEligibleVersion: () => getLatestEligibleVersion,
+  githubIssueTypeForTitle: () => githubIssueTypeForTitle,
   githubWorkflowBundle: () => githubWorkflowBundle,
   hasAnyDocsEmittingBundle: () => hasAnyDocsEmittingBundle,
   hasAnyDownstreamIssueKindBundle: () => hasAnyDownstreamIssueKindBundle,
@@ -392,6 +399,8 @@ __export(index_exports, {
   isScheduledTaskOwnedByExcluded: () => isScheduledTaskOwnedByExcluded,
   isSuppressedWorkflowRule: () => isSuppressedWorkflowRule,
   isTypeLabelOwnedByExcluded: () => isTypeLabelOwnedByExcluded,
+  issueTemplatesChildGlob: () => issueTemplatesChildGlob,
+  issueTemplatesGeneratedPath: () => issueTemplatesGeneratedPath,
   jestBundle: () => jestBundle,
   labelsForPhase: () => labelsForPhase,
   maintenanceAuditBundle: () => maintenanceAuditBundle,
@@ -440,10 +449,16 @@ __export(index_exports, {
   renderCustomDocSections: () => renderCustomDocSections,
   renderExtractApiProcedure: () => renderExtractApiProcedure,
   renderFocusSection: () => renderFocusSection,
+  renderGithubIssueTypeSection: () => renderGithubIssueTypeSection,
+  renderGithubIssueTypeSectionLines: () => renderGithubIssueTypeSectionLines,
+  renderIssueTemplateLabelsCheckerScript: () => renderIssueTemplateLabelsCheckerScript,
   renderIssueTemplatesBundleHook: () => renderIssueTemplatesBundleHook,
   renderIssueTemplatesCheckerScript: () => renderIssueTemplatesCheckerScript,
+  renderIssueTemplatesGeneratedPage: () => renderIssueTemplatesGeneratedPage,
   renderIssueTemplatesRuleContent: () => renderIssueTemplatesRuleContent,
   renderIssueTemplatesStarterPage: () => renderIssueTemplatesStarterPage,
+  renderIssueTypeAssignmentBlanket: () => renderIssueTypeAssignmentBlanket,
+  renderIssueTypeAssignmentStep: () => renderIssueTypeAssignmentStep,
   renderMeetingTypesSection: () => renderMeetingTypesSection,
   renderNextRequirementIdProcedure: () => renderNextRequirementIdProcedure,
   renderPhaseTypeInvariantSection: () => renderPhaseTypeInvariantSection,
@@ -460,6 +475,7 @@ __export(index_exports, {
   renderScheduledTasksSection: () => renderScheduledTasksSection,
   renderScopeGateSection: () => renderScopeGateSection,
   renderScopeGateShellHelpers: () => renderScopeGateShellHelpers,
+  renderSetIssueTypeFallbackLines: () => renderSetIssueTypeFallbackLines,
   renderSharedEditingBundleHook: () => renderSharedEditingBundleHook,
   renderSharedEditingHelperScript: () => renderSharedEditingHelperScript,
   renderSharedEditingRuleContent: () => renderSharedEditingRuleContent,
@@ -470,6 +486,7 @@ __export(index_exports, {
   renderStripToolArtifactTagsProcedure: () => renderStripToolArtifactTagsProcedure,
   renderTemporalFramingCheckerScript: () => renderTemporalFramingCheckerScript,
   renderTemporalFramingRuleContent: () => renderTemporalFramingRuleContent,
+  renderTitlePrefixTypeBullets: () => renderTitlePrefixTypeBullets,
   renderUnblockDependentsScript: () => renderUnblockDependentsScript,
   renderUnblockDependentsSection: () => renderUnblockDependentsSection,
   requirementsAnalystBundle: () => requirementsAnalystBundle,
@@ -638,6 +655,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 = [
@@ -1230,6 +1844,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.",
@@ -1294,6 +1911,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",
@@ -1585,12 +2205,111 @@ var awsCdkBundle = {
   ]
 };
 
+// src/agent/bundles/issue-defaults.ts
+var VALID_STATUS_VALUES = [
+  "ready",
+  "blocked",
+  "in-progress",
+  "ready-for-review",
+  "needs-attention",
+  "done",
+  "deferred"
+];
+var VALID_PRIORITY_VALUES = [
+  "critical",
+  "high",
+  "medium",
+  "low",
+  "trivial"
+];
+var DEFAULT_ISSUE_STATUS = "ready";
+var DEFAULT_ISSUE_PRIORITY = "medium";
+var DEFAULT_RESOLVED_ISSUE_DEFAULTS = {
+  defaults: {
+    status: DEFAULT_ISSUE_STATUS,
+    priority: DEFAULT_ISSUE_PRIORITY
+  },
+  overrides: {}
+};
+function resolveIssueDefaults(config) {
+  if (config === void 0) {
+    return DEFAULT_RESOLVED_ISSUE_DEFAULTS;
+  }
+  const overrides = {};
+  for (const [phaseLabel, override] of Object.entries(config)) {
+    assertValidPhaseLabel(phaseLabel);
+    assertValidOverride(phaseLabel, override);
+    overrides[phaseLabel] = {
+      status: override.status ?? DEFAULT_ISSUE_STATUS,
+      priority: override.priority ?? DEFAULT_ISSUE_PRIORITY
+    };
+  }
+  return {
+    defaults: {
+      status: DEFAULT_ISSUE_STATUS,
+      priority: DEFAULT_ISSUE_PRIORITY
+    },
+    overrides
+  };
+}
+function validateIssueDefaultsConfig(config) {
+  return resolveIssueDefaults(config);
+}
+function labelsForPhase(resolved, phaseLabel) {
+  return resolved.overrides[phaseLabel] ?? resolved.defaults;
+}
+function assertValidPhaseLabel(phaseLabel) {
+  if (typeof phaseLabel !== "string" || phaseLabel.trim() === "") {
+    throw new Error(
+      "AgentConfigOptions.issueDefaults: phase-label keys must be non-empty strings (e.g. `people:research`)."
+    );
+  }
+}
+function assertValidOverride(phaseLabel, override) {
+  if (override === null || typeof override !== "object" || Array.isArray(override)) {
+    throw new Error(
+      `AgentConfigOptions.issueDefaults["${phaseLabel}"] must be an object with optional \`status\` and \`priority\` fields.`
+    );
+  }
+  const { status, priority } = override;
+  if (status === void 0 && priority === void 0) {
+    throw new Error(
+      `AgentConfigOptions.issueDefaults["${phaseLabel}"] must declare at least one of \`status\` or \`priority\`. Empty entries are rejected because they are almost always a typo on the field name.`
+    );
+  }
+  if (status !== void 0 && !VALID_STATUS_VALUES.includes(status)) {
+    throw new Error(
+      `AgentConfigOptions.issueDefaults["${phaseLabel}"].status="${status}" is not a recognised status value. Allowed values: ${VALID_STATUS_VALUES.join(", ")}.`
+    );
+  }
+  if (priority !== void 0 && !VALID_PRIORITY_VALUES.includes(priority)) {
+    throw new Error(
+      `AgentConfigOptions.issueDefaults["${phaseLabel}"].priority="${priority}" is not a recognised priority value. Allowed values: ${VALID_PRIORITY_VALUES.join(", ")}.`
+    );
+  }
+}
+
 // src/agent/bundles/issue-templates.ts
 var DEFAULT_ISSUE_TEMPLATES_ENABLED = true;
 var DEFAULT_ISSUE_TEMPLATES_PATH = "docs/src/content/docs/agents/issue-templates.md";
 var DEFAULT_ISSUE_TEMPLATES_BUNDLE_PATH_PATTERNS = [".claude/agents/**/*.md", ".claude/skills/**/*.md"];
 var DEFAULT_ISSUE_TEMPLATES_EMIT_CHECKER = false;
 var DEFAULT_ISSUE_TEMPLATES_EMIT_STARTER = false;
+var ISSUE_TEMPLATES_GENERATED_SUFFIX = "-generated";
+function issueTemplatesGeneratedPath(templatesPath) {
+  const slash = templatesPath.lastIndexOf("/");
+  const dot = templatesPath.lastIndexOf(".");
+  if (dot > slash) {
+    return `${templatesPath.slice(0, dot)}${ISSUE_TEMPLATES_GENERATED_SUFFIX}${templatesPath.slice(dot)}`;
+  }
+  return `${templatesPath}${ISSUE_TEMPLATES_GENERATED_SUFFIX}`;
+}
+function issueTemplatesChildGlob(templatesPath) {
+  const slash = templatesPath.lastIndexOf("/");
+  const dot = templatesPath.lastIndexOf(".");
+  const stem = dot > slash ? templatesPath.slice(0, dot) : templatesPath;
+  return `${stem}/*.md`;
+}
 var DEFAULT_ISSUE_TEMPLATES_REQUIRE_REFERENCE = true;
 function resolveIssueTemplates(config) {
   const templatesPath = config?.templatesPath ?? DEFAULT_ISSUE_TEMPLATES_PATH;
@@ -1674,7 +2393,40 @@ function renderIssueTemplatesRuleContent(it, hasDownstreamBundles = true) {
     "issue kind appends one section; retiring a kind removes one. The",
     "label taxonomy, body template shape, and placeholder conventions",
     "are shared across every section.",
-    "",
+    ""
+  ];
+  if (it.emitStarterDoc) {
+    lines.push(
+      "## Scaffolded Starting Point",
+      "",
+      "The page is hand-authored, but it does not start empty. Two files",
+      "ship together:",
+      "",
+      `1. \`${it.templatesPath}\` \u2014 **written once**, then yours. Titles,`,
+      "   bodies, and the callers list are hand-authored here and never",
+      "   overwritten.",
+      `2. \`${issueTemplatesGeneratedPath(it.templatesPath)}\` \u2014`,
+      "   **regenerated on every synth**. One",
+      "   `## Template: <phase-label>` stub per phase label the active",
+      "   bundles contribute to the label registry, with the phase label,",
+      "   the `type:<bundle>` label its owning bundle declares, and the",
+      "   configured `status:*` / `priority:*` defaults pre-filled.",
+      "",
+      "Only the **label set** is generated. Title and body stay",
+      "angle-bracket placeholders, so the scaffold answers *which labels*",
+      "without dictating *what the issue says*. Copy a stub into the",
+      "hand-authored page, flesh out its body, and leave the label block",
+      "as generated.",
+      "",
+      "The split is load-bearing. A write-once scaffold alone freezes",
+      "every consumer on whatever skeleton shipped the day they adopted",
+      "the convention \u2014 a new phase label minted upstream never reaches",
+      "them. Regenerating the label half fixes that without ever",
+      "clobbering an authored body.",
+      ""
+    );
+  }
+  lines.push(
     "## Reference-Don't-Inline Rule",
     "",
     `Every bundle rule, agent prompt, or skill instruction that files a`,
@@ -1745,8 +2497,12 @@ function renderIssueTemplatesRuleContent(it, hasDownstreamBundles = true) {
     "   placeholders (`<Organization Name>`, `<slug>`) that match",
     "   existing templates. Consistency across sections lets callers",
     "   substitute without re-reading the body every time.",
+    "5. **Does the recipe assign a GitHub issue type?** `gh issue",
+    "   create` cannot set it and the `type:*` label does not either, so",
+    "   every section ends with the follow-up call. An issue that skips",
+    "   it stays untyped forever.",
     ""
-  ];
+  );
   if (it.emitChecker) {
     lines.push(
       "## Automated Lint",
@@ -1777,6 +2533,33 @@ function renderIssueTemplatesRuleContent(it, hasDownstreamBundles = true) {
       "(which documents the conventional `gh issue create` call shape",
       "as taxonomy, not a downstream template). All other bundle",
       "files in the pattern set are in scope.",
+      "",
+      "### Recipe label correctness",
+      "",
+      "A companion lint,",
+      "`.claude/procedures/check-issue-template-labels.sh`, checks the",
+      "recipes themselves rather than where they live. It walks the",
+      "templates page, its router-style child pages, and the generated",
+      "label-set companion, and fails non-zero when a",
+      "`## Template: <phase-label>` section:",
+      "",
+      "- never passes `--label <phase-label>` \u2014 the heading and the",
+      "  command disagree;",
+      "- carries no `type:*` label, more than one, or one that is not",
+      "  the `type:<bundle>` label the phase label's owning bundle",
+      "  declares;",
+      "- has no GitHub issue-type assignment step.",
+      "",
+      "```bash",
+      ".claude/procedures/check-issue-template-labels.sh",
+      "```",
+      "",
+      "The phase-label \u2192 type-label pairing is generated from the same",
+      "bundle-ownership map that drives `.github/labels.yml` and the",
+      "orchestrator's invariant sweep, so a hand-edit can never",
+      "reintroduce a mismatch the registry has already ruled out.",
+      "Sections whose heading matches no bundle-owned phase label are",
+      "skipped \u2014 consumer-specific labels are deliberately not policed.",
       ""
     );
   }
@@ -1785,8 +2568,10 @@ function renderIssueTemplatesRuleContent(it, hasDownstreamBundles = true) {
     "",
     "The convention intentionally does not:",
     "",
-    "- Auto-generate the templates page \u2014 repo-specific phase labels",
-    "  and body conventions are too varied for a one-size template.",
+    "- Auto-generate recipe **bodies**. Only the label set is",
+    "  scaffolded, because labels are derivable from the bundle",
+    "  registry and bodies are not \u2014 repo-specific objectives,",
+    "  acceptance criteria, and callers lists stay hand-authored.",
     "- Prescribe a fixed body shape across templates. Each section",
     "  may carry its own `## Acceptance Criteria`, `## Scope Size`,",
     "  or `## Output Path` fields as the downstream agent requires;",
@@ -1817,7 +2602,8 @@ function renderIssueTemplatesBundleHook(it, bundleLabel) {
     "as an inline template vs. a prose mention."
   ].join("\n");
 }
-function renderIssueTemplatesStarterPage(_it) {
+function renderIssueTemplatesStarterPage(it) {
+  const generatedLink = `./${basename(issueTemplatesGeneratedPath(it.templatesPath))}`;
   return [
     "---",
     "title: Issue Templates",
@@ -1839,11 +2625,33 @@ 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,",
     "not a duplicate-check layer.",
     "",
+    "## Generated label sets",
+    "",
+    `[Generated Issue-Template Label Sets](${generatedLink}) carries one`,
+    "correct-by-construction stub per phase label the active bundles",
+    "emit \u2014 the phase label paired with the `type:<bundle>` label its",
+    "owning bundle declares, plus the configured `status:*` /",
+    "`priority:*` defaults. That page regenerates on every `projen` run,",
+    "so it never goes stale as phase labels come and go.",
+    "",
+    "This page is the opposite: written once, then owned by you. Copy a",
+    "stub across, flesh out its title and body here, and leave the label",
+    "block exactly as generated \u2014 the label-consistency lint holds both",
+    "copies to the same pairing.",
+    "",
     "## Template: example-phase",
     "",
     "Replace this example with the real templates for this repo. Each",
@@ -1873,9 +2681,125 @@ 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");
 }
+function collectIssueTemplateRecipeStubs(bundles, issueDefaults = DEFAULT_RESOLVED_ISSUE_DEFAULTS) {
+  const stubs = /* @__PURE__ */ new Map();
+  for (const bundle of bundles) {
+    for (const label of bundle.labels ?? []) {
+      const typeLabel = typeLabelForPhaseLabel(label.name);
+      if (typeLabel === void 0) {
+        continue;
+      }
+      if (stubs.has(label.name)) {
+        continue;
+      }
+      const defaults = labelsForPhase(issueDefaults, label.name);
+      stubs.set(label.name, {
+        phaseLabel: label.name,
+        typeLabel,
+        bundleName: bundle.name,
+        description: label.description ?? "",
+        status: defaults.status,
+        priority: defaults.priority,
+        issueType: githubIssueTypeForTitle(`${label.name}: placeholder`)
+      });
+    }
+  }
+  return [...stubs.values()].sort(
+    (a, b) => a.phaseLabel.localeCompare(b.phaseLabel)
+  );
+}
+function renderIssueTemplatesGeneratedPage(it, stubs) {
+  const lines = [
+    "---",
+    "title: Generated Issue-Template Label Sets",
+    "description: Auto-generated label-correct gh issue create stubs \u2014 one per phase label.",
+    "---",
+    "",
+    "**Generated file \u2014 do not edit.** Every section below is",
+    "regenerated from the active bundle set on each `projen` run; hand",
+    "edits are overwritten. The hand-authored recipes live in",
+    `[the issue-templates page](./${basename(it.templatesPath)}) \u2014 this`,
+    "page exists so the **label half** of every recipe stays",
+    "correct-by-construction as phase labels come and go.",
+    "",
+    "## How to use",
+    "",
+    "Each section carries the exact label set the phase-label invariant",
+    "requires: the phase label itself, the `type:<bundle>` label its",
+    "owning bundle declares, and the configured `status:*` / `priority:*`",
+    "defaults for that phase. Title and body are placeholders \u2014 copy the",
+    "stub into the hand-authored templates page and flesh out the body",
+    "there, or run it as-is when no repo-specific body exists yet.",
+    "",
+    "Every stub ends with the **GitHub issue type** assignment. `gh issue",
+    "create` cannot set the issue type and the `type:*` label does not",
+    "set it either, so an issue that skips the follow-up call stays",
+    "untyped forever. See **Assigning the GitHub issue type** in the",
+    "`issue-conventions` rule for the no-helper fallback.",
+    ""
+  ];
+  if (stubs.length === 0) {
+    lines.push(
+      "## No phase labels",
+      "",
+      "No active bundle contributes a phase label, so there is nothing to",
+      "scaffold. Enable a phased-pipeline bundle (or drop it from",
+      "`excludeBundles`) and re-run `projen`."
+    );
+    return lines.join("\n");
+  }
+  for (const stub of stubs) {
+    lines.push(
+      `## Template: ${stub.phaseLabel}`,
+      "",
+      ...stub.description === "" ? [] : [stub.description, ""],
+      `**Owning bundle:** \`${stub.bundleName}\` \u2014 **required type label:**`,
+      `\`${stub.typeLabel}\` (paired by the bundle-ownership map).`,
+      "",
+      "**Callers:** <name the bundles and agents that file this issue>",
+      "",
+      "```bash",
+      "gh issue create \\",
+      `  --title "${stub.phaseLabel}: <short description>" \\`,
+      `  --label "${stub.typeLabel}" \\`,
+      `  --label "${stub.phaseLabel}" \\`,
+      `  --label "priority:${stub.priority}" \\`,
+      `  --label "status:${stub.status}" \\`,
+      '  --body "## Objective',
+      "",
+      "<1-3 sentences describing the work>.",
+      "",
+      "## Context",
+      "",
+      "- **Discovered in:** <source description> (#<parent-issue>)",
+      "",
+      "## Acceptance Criteria",
+      "",
+      "- [ ] <criterion 1>",
+      '"',
+      "```",
+      "",
+      `Then assign the GitHub issue type (\`${stub.issueType}\`):`,
+      "",
+      "```bash",
+      `${SET_ISSUE_TYPE_HELPER_PATH} <issue-number> ${stub.issueType}`,
+      "```",
+      ""
+    );
+  }
+  lines.pop();
+  return lines.join("\n");
+}
 function renderIssueTemplatesCheckerScript(it) {
   const patternsLiteral = it.bundlePathPatterns.map((p) => `  ${JSON.stringify(p)}`).join("\n");
   return [
@@ -2064,6 +2988,157 @@ function renderIssueTemplatesCheckerScript(it) {
     "exit 0"
   ].join("\n");
 }
+function renderIssueTemplateLabelsCheckerScript(it) {
+  const generatedPath = issueTemplatesGeneratedPath(it.templatesPath);
+  const childGlob = issueTemplatesChildGlob(it.templatesPath);
+  return [
+    "#!/usr/bin/env bash",
+    "# check-issue-template-labels.sh \u2014 Enforce recipe label correctness.",
+    "#",
+    "# Usage:",
+    "#   .claude/procedures/check-issue-template-labels.sh [<file>...]",
+    "#",
+    "# With no arguments the lint walks the templates page, its",
+    "# router-style child pages, and the generated label-set companion.",
+    "# Positional arguments override that default set.",
+    "#",
+    "# For every `## Template: <phase-label>` section it asserts the",
+    "# recipe passes the heading's phase label, carries exactly one",
+    "# `type:*` label matching the phase-label invariant, and assigns a",
+    "# GitHub issue type. Sections whose heading matches no bundle-owned",
+    "# phase label are skipped \u2014 unrecognised labels are consumer-",
+    "# specific and deliberately not policed.",
+    "#",
+    "# The resolver below is generated from the canonical bundle-",
+    "# ownership map \u2014 do not edit by hand; regenerate via",
+    "# `pnpm exec projen`.",
+    "",
+    "set -uo pipefail",
+    "",
+    "err() {",
+    '  printf "check-issue-template-labels.sh: %s\\n" "$*" >&2',
+    "}",
+    "",
+    renderPhaseTypeInvariantShellHelpers(),
+    "",
+    `templates_path=${JSON.stringify(it.templatesPath)}`,
+    `generated_path=${JSON.stringify(generatedPath)}`,
+    `child_glob=${JSON.stringify(childGlob)}`,
+    "",
+    "# Emit one TAB-separated record per `## Template:` section:",
+    "#   <file>\\t<line>\\t<phase-label>\\t<comma-joined labels>\\t<0|1 typed>",
+    "# Quote characters are folded to spaces up front so a recipe written",
+    "# with single quotes, double quotes, or none at all parses the same.",
+    "# Fenced blocks are tracked so the `## Objective` heading inside a",
+    "# recipe's --body string never reads as the end of the section.",
+    "scan_file() {",
+    '  local file="$1"',
+    `  tr '\\042\\047' '  ' < "$file" | awk -v FNAME="$file" '`,
+    "    function flush() {",
+    '      if (phase != "") {',
+    '        printf "%s\\t%d\\t%s\\t%s\\t%d\\n", FNAME, start, phase, labels, hastype;',
+    "      }",
+    '      phase = ""; labels = ""; hastype = 0;',
+    "    }",
+    "    {",
+    "      if ($0 ~ /^[ \\t]*```/) {",
+    "        fence = 1 - fence;",
+    '      } else if (fence == 0 && index($0, "## ") == 1) {',
+    "        flush();",
+    '        if (index($0, "## Template: ") == 1) {',
+    "          phase = substr($0, 14);",
+    '          gsub(/[ \\t`]/, "", phase);',
+    "          start = NR;",
+    "        }",
+    "        next;",
+    "      }",
+    '      if (phase == "") next;',
+    "      if ($0 ~ /set-issue-type\\.sh/ || $0 ~ /updateIssueIssueType/) {",
+    "        hastype = 1;",
+    "      }",
+    "      line = $0;",
+    "      while (match(line, /--label[ \\t]+[^ \\t]+/)) {",
+    "        tok = substr(line, RSTART, RLENGTH);",
+    "        line = substr(line, RSTART + RLENGTH);",
+    '        sub(/^--label[ \\t]+/, "", tok);',
+    '        gsub(/[\\\\`]/, "", tok);',
+    '        labels = labels tok ",";',
+    "      }",
+    "    }",
+    "    END { flush(); }",
+    "  '",
+    "}",
+    "",
+    "# Collect the file list: positional args override the default set.",
+    "files=()",
+    "if [[ $# -gt 0 ]]; then",
+    '  files=("$@")',
+    "else",
+    '  [[ -f "$templates_path" ]] && files+=("$templates_path")',
+    '  [[ -f "$generated_path" ]] && files+=("$generated_path")',
+    "  for child in $child_glob; do",
+    '    [[ -f "$child" ]] && files+=("$child")',
+    "  done",
+    "fi",
+    "",
+    "if [[ ${#files[@]} -eq 0 ]]; then",
+    "  exit 0",
+    "fi",
+    "",
+    "violations=()",
+    "checked=0",
+    "",
+    'for file in "${files[@]}"; do',
+    '  [[ -f "$file" ]] || continue',
+    "  while IFS=$'\\t' read -r rec_file rec_line phase labels hastype; do",
+    '    [[ -z "$phase" ]] && continue',
+    '    required=$(phase_label_type_of "$phase")',
+    '    [[ -z "$required" ]] && continue',
+    "    checked=$(( checked + 1 ))",
+    '    case ",${labels}" in',
+    '      *",${phase},"*) ;;',
+    `      *) violations+=("$rec_file:$rec_line: recipe for '$phase' never passes --label $phase") ;;`,
+    "    esac",
+    '    type_labels=""',
+    "    type_count=0",
+    '    for entry in $(printf "%s" "$labels" | tr , " "); do',
+    '      case "$entry" in',
+    "        type:*)",
+    '          type_labels="${type_labels}${entry} "',
+    "          type_count=$(( type_count + 1 ))",
+    "          ;;",
+    "      esac",
+    "    done",
+    '    if [[ "$type_count" -eq 0 ]]; then',
+    `      violations+=("$rec_file:$rec_line: recipe for '$phase' carries no type:* label (expected $required)")`,
+    '    elif [[ "$type_count" -gt 1 ]]; then',
+    "      violations+=(\"$rec_file:$rec_line: recipe for '$phase' carries ${type_count} type:* labels (${type_labels% }); exactly one is allowed\")",
+    '    elif [[ "${type_labels% }" != "$required" ]]; then',
+    `      violations+=("$rec_file:$rec_line: recipe for '$phase' carries \${type_labels% } but the phase label requires $required")`,
+    "    fi",
+    '    if [[ "$hastype" != "1" ]]; then',
+    `      violations+=("$rec_file:$rec_line: recipe for '$phase' has no GitHub issue-type assignment step")`,
+    "    fi",
+    '  done < <(scan_file "$file")',
+    "done",
+    "",
+    "if [[ ${#violations[@]} -gt 0 ]]; then",
+    '  err "issue-template recipes disagree with the phase-label invariant:"',
+    '  for v in "${violations[@]}"; do',
+    '    err "  - $v"',
+    "  done",
+    `  err "each '## Template: <phase-label>' recipe must pass its own phase label, exactly one matching type:<bundle> label, and a set-issue-type.sh (or updateIssueIssueType) step"`,
+    "  exit 1",
+    "fi",
+    "",
+    'printf "check-issue-template-labels.sh: %d recipe(s) OK\\n" "$checked"',
+    "exit 0"
+  ].join("\n");
+}
+function basename(path8) {
+  const slash = path8.lastIndexOf("/");
+  return slash === -1 ? path8 : path8.slice(slash + 1);
+}
 function assertValidTemplatesPath(value) {
   if (typeof value !== "string" || value.trim().length === 0) {
     throw new Error(
@@ -4977,16 +6052,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",
           "",
@@ -5075,90 +6141,6 @@ function buildBaseBundle(paths = DEFAULT_AGENT_PATHS) {
 }
 var baseBundle = buildBaseBundle();
 
-// src/agent/bundles/issue-defaults.ts
-var VALID_STATUS_VALUES = [
-  "ready",
-  "blocked",
-  "in-progress",
-  "ready-for-review",
-  "needs-attention",
-  "done",
-  "deferred"
-];
-var VALID_PRIORITY_VALUES = [
-  "critical",
-  "high",
-  "medium",
-  "low",
-  "trivial"
-];
-var DEFAULT_ISSUE_STATUS = "ready";
-var DEFAULT_ISSUE_PRIORITY = "medium";
-var DEFAULT_RESOLVED_ISSUE_DEFAULTS = {
-  defaults: {
-    status: DEFAULT_ISSUE_STATUS,
-    priority: DEFAULT_ISSUE_PRIORITY
-  },
-  overrides: {}
-};
-function resolveIssueDefaults(config) {
-  if (config === void 0) {
-    return DEFAULT_RESOLVED_ISSUE_DEFAULTS;
-  }
-  const overrides = {};
-  for (const [phaseLabel, override] of Object.entries(config)) {
-    assertValidPhaseLabel(phaseLabel);
-    assertValidOverride(phaseLabel, override);
-    overrides[phaseLabel] = {
-      status: override.status ?? DEFAULT_ISSUE_STATUS,
-      priority: override.priority ?? DEFAULT_ISSUE_PRIORITY
-    };
-  }
-  return {
-    defaults: {
-      status: DEFAULT_ISSUE_STATUS,
-      priority: DEFAULT_ISSUE_PRIORITY
-    },
-    overrides
-  };
-}
-function validateIssueDefaultsConfig(config) {
-  return resolveIssueDefaults(config);
-}
-function labelsForPhase(resolved, phaseLabel) {
-  return resolved.overrides[phaseLabel] ?? resolved.defaults;
-}
-function assertValidPhaseLabel(phaseLabel) {
-  if (typeof phaseLabel !== "string" || phaseLabel.trim() === "") {
-    throw new Error(
-      "AgentConfigOptions.issueDefaults: phase-label keys must be non-empty strings (e.g. `people:research`)."
-    );
-  }
-}
-function assertValidOverride(phaseLabel, override) {
-  if (override === null || typeof override !== "object" || Array.isArray(override)) {
-    throw new Error(
-      `AgentConfigOptions.issueDefaults["${phaseLabel}"] must be an object with optional \`status\` and \`priority\` fields.`
-    );
-  }
-  const { status, priority } = override;
-  if (status === void 0 && priority === void 0) {
-    throw new Error(
-      `AgentConfigOptions.issueDefaults["${phaseLabel}"] must declare at least one of \`status\` or \`priority\`. Empty entries are rejected because they are almost always a typo on the field name.`
-    );
-  }
-  if (status !== void 0 && !VALID_STATUS_VALUES.includes(status)) {
-    throw new Error(
-      `AgentConfigOptions.issueDefaults["${phaseLabel}"].status="${status}" is not a recognised status value. Allowed values: ${VALID_STATUS_VALUES.join(", ")}.`
-    );
-  }
-  if (priority !== void 0 && !VALID_PRIORITY_VALUES.includes(priority)) {
-    throw new Error(
-      `AgentConfigOptions.issueDefaults["${phaseLabel}"].priority="${priority}" is not a recognised priority value. Allowed values: ${VALID_PRIORITY_VALUES.join(", ")}.`
-    );
-  }
-}
-
 // src/agent/bundles/bcm-writer.ts
 function buildBcmWriterSubAgent(paths, issueDefaults) {
   return {
@@ -5676,6 +6658,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:",
@@ -5685,6 +6669,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:",
@@ -5694,6 +6680,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",
@@ -5816,6 +6804,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",
@@ -7096,6 +8086,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:`",
@@ -7170,6 +8162,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.",
@@ -7229,6 +8223,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",
@@ -7753,6 +8749,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>`)",
@@ -7770,6 +8768,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>`)",
@@ -8321,6 +9321,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",
@@ -8395,6 +9397,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",
@@ -8468,6 +9472,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",
@@ -8541,6 +9547,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",
@@ -9129,6 +10137,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",
@@ -9140,6 +10150,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.",
@@ -9241,6 +10253,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",
@@ -9257,6 +10271,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",
@@ -9268,6 +10284,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.",
       "",
@@ -9454,6 +10472,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.",
@@ -9529,6 +10549,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.",
@@ -9605,6 +10627,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",
@@ -11314,10 +12338,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:",
@@ -11803,6 +12824,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`",
@@ -11893,6 +12915,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",
@@ -12171,6 +13195,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(),
@@ -12603,6 +13629,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.",
@@ -12667,6 +13695,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",
@@ -13176,6 +14206,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`",
@@ -13375,6 +14407,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`,",
@@ -13438,700 +14472,221 @@ function buildMeetingAnalystSubAgent(tier) {
       "   `## 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 };
+      "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;
@@ -19768,6 +20323,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>`)",
@@ -19788,6 +20345,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>`)",
@@ -20070,6 +20629,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",
@@ -20161,6 +20722,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",
@@ -23857,6 +24420,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",
@@ -23967,6 +24532,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",
@@ -23986,6 +24553,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",
@@ -23997,6 +24566,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.",
       "",
@@ -24164,6 +24735,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.",
@@ -24240,6 +24813,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.",
@@ -24307,6 +24882,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.",
@@ -27142,6 +27719,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.",
@@ -27731,6 +28310,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",
@@ -27877,6 +28458,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.",
       "",
@@ -28925,6 +29508,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",
@@ -29080,6 +29664,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",
@@ -29182,6 +29768,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",
@@ -29756,6 +30344,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",
@@ -30571,6 +31161,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>`)",
@@ -30639,6 +31231,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)",
@@ -30651,6 +31245,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>`)",
@@ -30670,6 +31266,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>`)",
@@ -30860,6 +31458,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",
@@ -30948,6 +31548,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,",
@@ -31560,6 +32162,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",
@@ -31571,6 +32175,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.",
@@ -31864,6 +32470,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`",
@@ -31875,6 +32483,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.",
       "",
@@ -32049,6 +32659,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",
@@ -32113,6 +32725,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.",
@@ -32186,6 +32800,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.",
       "",
@@ -32254,6 +32870,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",
@@ -32319,6 +32937,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.",
@@ -32628,6 +33248,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 = [
@@ -32736,6 +33364,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:",
@@ -32749,6 +33387,8 @@ var UPSTREAM_CONFIGULATOR_DOCS_DETAIL = [
   "  --body $'## Summary\\n\\nThe `software-profile-analyst` Phase 2 prompt does not capture the vendor pricing tier (free / paid / enterprise), which downstream consumers need for segment matching.\\n\\n## Details\\n\\n- Add a `Pricing tier` field to the profile template at `docs/src/content/docs/agents/software-profile-analyst.md`\\n- Update the Phase 2 instructions to require the field before commit\\n- Add a regression test in `bundles.test.ts`'",
   "```",
   "",
+  "The call above does **not** set the GitHub issue type \u2014 `gh issue create` cannot. Assign it immediately, in the same session, with the cross-repo GraphQL flow above (`feat:` title \u2192 **Feature**; every other prefix except `epic:` / `fix:` \u2192 **Task**). Skipping it leaves the upstream issue untyped, and nobody comes back for it later.",
+  "",
   "After filing, reference the upstream issue from any local workaround so it can be reverted once the upstream fix lands:",
   "",
   "```typescript",
@@ -34925,11 +35565,34 @@ var AgentConfig = class _AgentConfig extends import_projen8.Component {
           ).split("\n"),
           executable: true
         });
+        new import_projen8.TextFile(
+          this,
+          ".claude/procedures/check-issue-template-labels.sh",
+          {
+            lines: renderIssueTemplateLabelsCheckerScript(
+              resolvedIssueTemplates
+            ).split("\n"),
+            executable: true
+          }
+        );
       }
       if (resolvedIssueTemplates.emitStarterDoc) {
         new import_projen8.SampleFile(this.project, resolvedIssueTemplates.templatesPath, {
           contents: renderIssueTemplatesStarterPage(resolvedIssueTemplates)
         });
+        new import_projen8.TextFile(
+          this,
+          issueTemplatesGeneratedPath(resolvedIssueTemplates.templatesPath),
+          {
+            lines: renderIssueTemplatesGeneratedPage(
+              resolvedIssueTemplates,
+              collectIssueTemplateRecipeStubs(
+                this.activeBundles,
+                resolveIssueDefaults(this.options.issueDefaults)
+              )
+            ).split("\n")
+          }
+        );
       }
     }
     const resolvedTemporalFraming = validateTemporalFramingConfig(
@@ -41535,6 +42198,7 @@ export const collections = {
   DEFAULT_DECOMPOSITION_TEMPLATE,
   DEFAULT_DISPATCH_MODEL,
   DEFAULT_DISPATCH_TO_HOUSEKEEPING_RATIO,
+  DEFAULT_GITHUB_ISSUE_TYPE,
   DEFAULT_HOUSEKEEPING_MODEL,
   DEFAULT_ISSUE_PRIORITY,
   DEFAULT_ISSUE_STATUS,
@@ -41581,6 +42245,9 @@ export const collections = {
   DEFAULT_UNBLOCK_DEPENDENTS_ENABLED,
   DEFAULT_UPSTREAM_CONFIGULATOR_ENABLED,
   DOCS_SYNC_AUDIT_SCHEMA_VERSION,
+  GITHUB_ISSUE_TYPES,
+  GITHUB_ISSUE_TYPE_BY_TITLE_PREFIX,
+  ISSUE_TEMPLATES_GENERATED_SUFFIX,
   JsiiFaker,
   LAYOUT_ENFORCEMENT,
   LAYOUT_ROOT_BY_PROJECT_TYPE,
@@ -41605,6 +42272,7 @@ export const collections = {
   ResetTask,
   SCHEDULED_TASK_MODEL_VALUES,
   SCOPE_CLASS_VALUES,
+  SET_ISSUE_TYPE_HELPER_PATH,
   SHARED_EDITING_CONFLICT_STRATEGY_VALUES,
   STARLIGHT_ROLE,
   SUPPRESSED_WORKFLOW_RULE_NAMES,
@@ -41675,6 +42343,7 @@ export const collections = {
   checkLinksProcedure,
   classifyIssueScope,
   classifyRun,
+  collectIssueTemplateRecipeStubs,
   companyProfileBundle,
   compileFencedSamples,
   createApiDiffCheck,
@@ -41690,6 +42359,7 @@ export const collections = {
   formatLayoutViolation,
   formatStarlightSingletonViolation,
   getLatestEligibleVersion,
+  githubIssueTypeForTitle,
   githubWorkflowBundle,
   hasAnyDocsEmittingBundle,
   hasAnyDownstreamIssueKindBundle,
@@ -41699,6 +42369,8 @@ export const collections = {
   isScheduledTaskOwnedByExcluded,
   isSuppressedWorkflowRule,
   isTypeLabelOwnedByExcluded,
+  issueTemplatesChildGlob,
+  issueTemplatesGeneratedPath,
   jestBundle,
   labelsForPhase,
   maintenanceAuditBundle,
@@ -41747,10 +42419,16 @@ export const collections = {
   renderCustomDocSections,
   renderExtractApiProcedure,
   renderFocusSection,
+  renderGithubIssueTypeSection,
+  renderGithubIssueTypeSectionLines,
+  renderIssueTemplateLabelsCheckerScript,
   renderIssueTemplatesBundleHook,
   renderIssueTemplatesCheckerScript,
+  renderIssueTemplatesGeneratedPage,
   renderIssueTemplatesRuleContent,
   renderIssueTemplatesStarterPage,
+  renderIssueTypeAssignmentBlanket,
+  renderIssueTypeAssignmentStep,
   renderMeetingTypesSection,
   renderNextRequirementIdProcedure,
   renderPhaseTypeInvariantSection,
@@ -41767,6 +42445,7 @@ export const collections = {
   renderScheduledTasksSection,
   renderScopeGateSection,
   renderScopeGateShellHelpers,
+  renderSetIssueTypeFallbackLines,
   renderSharedEditingBundleHook,
   renderSharedEditingHelperScript,
   renderSharedEditingRuleContent,
@@ -41777,6 +42456,7 @@ export const collections = {
   renderStripToolArtifactTagsProcedure,
   renderTemporalFramingCheckerScript,
   renderTemporalFramingRuleContent,
+  renderTitlePrefixTypeBullets,
   renderUnblockDependentsScript,
   renderUnblockDependentsSection,
   requirementsAnalystBundle,