@codedrifters/configulator 0.0.297 → 0.0.299

package/lib/index.mjs

@@ -175,6 +175,45 @@ var require_lib = __commonJS({
 // src/agent/agent-config.ts
 import { Component as Component8, SampleFile, TextFile as TextFile4 } from "projen";
 
+// src/agent/types.ts
+var AGENT_RULE_SCOPE = {
+  ALWAYS: "always",
+  FILE_PATTERN: "file-pattern"
+};
+var AGENT_PLATFORM = {
+  CURSOR: "cursor",
+  CLAUDE: "claude",
+  CODEX: "codex",
+  COPILOT: "copilot"
+};
+var CLAUDE_RULE_TARGET = {
+  SCOPED_FILE: "scoped-file",
+  AGENTS_MD: "agents-md",
+  CLAUDE_MD: "claude-md"
+};
+var AGENT_MODEL = {
+  INHERIT: "inherit",
+  FAST: "fast",
+  BALANCED: "balanced",
+  POWERFUL: "powerful"
+};
+function resolveModelAlias(model) {
+  if (!model || model === AGENT_MODEL.INHERIT) {
+    return void 0;
+  }
+  const mapping = {
+    [AGENT_MODEL.POWERFUL]: "opus",
+    [AGENT_MODEL.BALANCED]: "sonnet",
+    [AGENT_MODEL.FAST]: "haiku"
+  };
+  return mapping[model] ?? model;
+}
+var MCP_TRANSPORT = {
+  STDIO: "stdio",
+  HTTP: "http",
+  SSE: "sse"
+};
+
 // src/agent/bundles/project-context.ts
 var PROJECT_CONTEXT_PATH = "docs/src/content/docs/project-context.md";
 var SUBPROJECT_ROLE_GUIDANCE = [
@@ -302,45 +341,6 @@ var MONOREPO_LAYOUT_SEED_BLOCK = [
   ""
 ].join("\n");
 
-// src/agent/types.ts
-var AGENT_RULE_SCOPE = {
-  ALWAYS: "always",
-  FILE_PATTERN: "file-pattern"
-};
-var AGENT_PLATFORM = {
-  CURSOR: "cursor",
-  CLAUDE: "claude",
-  CODEX: "codex",
-  COPILOT: "copilot"
-};
-var CLAUDE_RULE_TARGET = {
-  SCOPED_FILE: "scoped-file",
-  AGENTS_MD: "agents-md",
-  CLAUDE_MD: "claude-md"
-};
-var AGENT_MODEL = {
-  INHERIT: "inherit",
-  FAST: "fast",
-  BALANCED: "balanced",
-  POWERFUL: "powerful"
-};
-function resolveModelAlias(model) {
-  if (!model || model === AGENT_MODEL.INHERIT) {
-    return void 0;
-  }
-  const mapping = {
-    [AGENT_MODEL.POWERFUL]: "opus",
-    [AGENT_MODEL.BALANCED]: "sonnet",
-    [AGENT_MODEL.FAST]: "haiku"
-  };
-  return mapping[model] ?? model;
-}
-var MCP_TRANSPORT = {
-  STDIO: "stdio",
-  HTTP: "http",
-  SSE: "sse"
-};
-
 // src/agent/bundles/agenda.ts
 var agendaAnalystSubAgent = {
   name: "agenda-analyst",
@@ -1080,6 +1080,47 @@ var awsCdkBundle = {
         "- When adding a `NodejsFunction` with a bundled handler, ensure the `entry` path is explicitly configured",
         "- Verify the entry is included in the build tool config (e.g., tsup entry list) so the runtime can find the handler",
         "",
+        "## Lambda Construct Encapsulation",
+        "",
+        "When a Lambda construct is event-driven, it should own:",
+        "",
+        "- The EventBridge Rule (or other trigger) that routes events to itself.",
+        "- The IAM permissions it needs on resources passed in via props.",
+        "",
+        "Pass the resources (event bus, table, queue, etc.) into the Lambda",
+        "construct's props rather than defining triggers and grants in the",
+        "enclosing workflow or service. The Lambda construct then becomes",
+        'self-describing \u2014 "what triggers me, what I write to" lives in one',
+        "file \u2014 and reverting or refactoring a single Lambda doesn't ripple",
+        "through unrelated constructs.",
+        "",
+        "```typescript",
+        "export interface MyLambdaProps {",
+        "  readonly eventBus: IEventBus;",
+        "  readonly dataStoreTable: ITable;",
+        "}",
+        "",
+        "export class MyLambda extends Construct {",
+        "  public readonly lambda: NodejsFunction;",
+        "  public readonly rule: Rule;",
+        "",
+        "  constructor(scope: Construct, props: MyLambdaProps) {",
+        '    super(scope, "my-lambda");',
+        "",
+        '    this.lambda = new NodejsFunction(this, "handler", { /* ... */ });',
+        "    props.dataStoreTable.grantReadWriteData(this.lambda);",
+        '    this.rule = new Rule(this, "rule", {',
+        "      eventBus: props.eventBus,",
+        "      eventPattern: { /* ... */ },",
+        "      targets: [new LambdaFunction(this.lambda)],",
+        "    });",
+        "  }",
+        "}",
+        "```",
+        "",
+        "A workflow or service construct then composes these Lambda constructs",
+        "without owning their triggers or grants directly.",
+        "",
         "## CDK Testing",
         "",
         "- Mock `Code.fromAsset` in any test file that synthesizes CDK stacks",
@@ -3361,6 +3402,7 @@ function buildBaseBundle(paths = DEFAULT_AGENT_PATHS) {
           "- **After modifying Projen configuration**, run the three-step regen sequence: `pnpm i`, then `pnpm exec projen`, then `pnpm i` again. The leading `pnpm i` syncs `node_modules` with the lockfile so synth runs against the right configulator/projen/plugin versions; the trailing `pnpm i` refreshes the lockfile to match anything projen rewrote in `package.json`.",
           "- **Configure dependencies through Projen** \u2014 never use `npm install`, `pnpm add`, or `yarn add`. Add them to `deps` or `devDeps` in Projen config.",
           "- **Export from index.ts** to maintain clean public APIs",
+          '- **`defaultMode: "dontAsk"` is configulator\'s hardcoded default** for the rendered Claude Code `settings.json`. Scheduled-task workers (issue-worker, orchestrator, pr-reviewer, and the analyst/writer family) run autonomously and would deadlock on confirmation prompts, so the synthesised default suppresses them. Override only after revisiting the autonomous-worker contract end-to-end; the override path is `claudeSettings.defaultMode` on `AgentConfigOptions`.',
           "",
           "## Repository Layout",
           "",
@@ -5836,11 +5878,11 @@ function buildBusinessModelsBundle(paths = DEFAULT_AGENT_PATHS, issueDefaults =
 var businessModelsBundle = buildBusinessModelsBundle();
 
 // src/agent/bundles/company-profile.ts
-function buildCompanyProfileAnalystSubAgent(paths, issueDefaults) {
+function buildCompanyProfileAnalystSubAgent(paths, issueDefaults, tier) {
   return {
     name: "company-profile-analyst",
     description: "Researches an external company (competitor, vendor, partner, customer, etc.) from public sources and produces a structured markdown profile, then enqueues downstream `people:research` and `software:research` issues for notable people and software products surfaced during profiling. Also handles profile enrichment against business-model canvases (`company:match`), maintenance refreshes on a configurable staleness cadence (`company:refresh`), and cross-profile competitive synthesis for a segment (`company:analyze`). One company or segment per session, tracked by company:* GitHub issue labels.",
-    model: AGENT_MODEL.POWERFUL,
+    model: tier,
     maxTurns: 80,
     platforms: { cursor: { exclude: true } },
     prompt: [
@@ -7027,7 +7069,7 @@ function buildAnalyzeSegmentSkill(paths, issueDefaults) {
     ].join("\n")
   };
 }
-function buildCompanyProfileBundle(paths = DEFAULT_AGENT_PATHS, issueDefaults = DEFAULT_RESOLVED_ISSUE_DEFAULTS) {
+function buildCompanyProfileBundle(paths = DEFAULT_AGENT_PATHS, issueDefaults = DEFAULT_RESOLVED_ISSUE_DEFAULTS, tier = AGENT_MODEL.BALANCED) {
   return {
     name: "company-profile",
     description: "Company research and profiling pipeline: research, draft profile, followup, match, refresh, analyze. Enabled by default; domain-neutral; filesystem-durable between phases. Phase 3 (Followup) hands surfaced people and software products off to the `people-profile` and `software-profile` bundles via `people:research` and `software:research` issues. Phase 4 (Match) enriches profiles against business-model canvases. Phase 5 (Refresh) re-verifies profiles on a configurable staleness cadence. Phase 6 (Analyze) synthesizes profiles in a segment into a competitive-analysis document.",
@@ -7085,7 +7127,7 @@ function buildCompanyProfileBundle(paths = DEFAULT_AGENT_PATHS, issueDefaults =
       buildRefreshCompanySkill(paths, issueDefaults),
       buildAnalyzeSegmentSkill(paths, issueDefaults)
     ],
-    subAgents: [buildCompanyProfileAnalystSubAgent(paths, issueDefaults)],
+    subAgents: [buildCompanyProfileAnalystSubAgent(paths, issueDefaults, tier)],
     labels: [
       {
         name: "type:company-profile",
@@ -7265,11 +7307,11 @@ var CUSTOMER_PROFILE_REFERENCE_FILES = [
     content: TEMPLATE_CUSTOMER_PROFILE
   }
 ];
-function buildCustomerProfileAnalystSubAgent(paths, issueDefaults) {
+function buildCustomerProfileAnalystSubAgent(paths, issueDefaults, tier) {
   return {
     name: "customer-profile-analyst",
     description: "Authors customer-archetype research through a 3-phase pipeline (discover \u2192 profile \u2192 competitors). Segments customer archetypes, profiles each archetype's goals, jobs-to-be-done, constraints, and buying process, then maps competitor features (from the shared software-profile feature matrix) to each archetype's needs and hands off unmet-need gaps to the requirements-analyst as req:scan seeds. One phase per session, tracked by customer:* GitHub issue labels with filesystem-based durability between phases.",
-    model: AGENT_MODEL.POWERFUL,
+    model: tier,
     maxTurns: 80,
     platforms: { cursor: { exclude: true } },
     prompt: [
@@ -8094,7 +8136,7 @@ function buildAnalyzeCustomerCompetitorsSkill(paths, issueDefaults) {
     ].join("\n")
   };
 }
-function buildCustomerProfileBundle(paths = DEFAULT_AGENT_PATHS, issueDefaults = DEFAULT_RESOLVED_ISSUE_DEFAULTS) {
+function buildCustomerProfileBundle(paths = DEFAULT_AGENT_PATHS, issueDefaults = DEFAULT_RESOLVED_ISSUE_DEFAULTS, tier = AGENT_MODEL.BALANCED) {
   return {
     name: "customer-profile",
     description: "Customer-archetype research pipeline: discover, profile, competitors. 3 phases with customer:* phase labels. Segments customer archetypes, profiles each archetype's goals, jobs-to-be-done, constraints, and buying process, then maps competitor features (from the shared software-profile feature matrix) to each archetype's needs and hands off unmet-need gaps to the requirements-analyst bundle as req:scan seeds. Enabled by default; domain-neutral; customer-centric (distinct from company-profile); filesystem-durable between phases.",
@@ -8169,7 +8211,9 @@ function buildCustomerProfileBundle(paths = DEFAULT_AGENT_PATHS, issueDefaults =
       buildProfileCustomerSkill(paths, issueDefaults),
       buildAnalyzeCustomerCompetitorsSkill(paths, issueDefaults)
     ],
-    subAgents: [buildCustomerProfileAnalystSubAgent(paths, issueDefaults)],
+    subAgents: [
+      buildCustomerProfileAnalystSubAgent(paths, issueDefaults, tier)
+    ],
     labels: [
       {
         name: "type:customer-profile",
@@ -9952,11 +9996,11 @@ var jestBundle = {
 };
 
 // src/agent/bundles/maintenance-audit.ts
-function buildMaintenanceAuditSubAgent(paths) {
+function buildMaintenanceAuditSubAgent(paths, tier) {
   return {
     name: "maintenance-audit",
     description: "Audits documentation registries and cross-references for integrity (broken links, registry drift, stale indexes), applies idempotent fixes, then re-runs the checks to confirm the fixes cleared the reported findings. One phase per session, tracked by maint:* GitHub issue labels with filesystem-based durability between phases.",
-    model: AGENT_MODEL.POWERFUL,
+    model: tier,
     maxTurns: 80,
     platforms: { cursor: { exclude: true } },
     prompt: [
@@ -10590,7 +10634,7 @@ function buildMaintenanceVerifySkill(issueDefaults) {
     ].join("\n")
   };
 }
-function buildMaintenanceAuditBundle(paths = DEFAULT_AGENT_PATHS, issueDefaults = DEFAULT_RESOLVED_ISSUE_DEFAULTS) {
+function buildMaintenanceAuditBundle(paths = DEFAULT_AGENT_PATHS, issueDefaults = DEFAULT_RESOLVED_ISSUE_DEFAULTS, tier = AGENT_MODEL.BALANCED) {
   return {
     name: "maintenance-audit",
     description: "Documentation-maintenance agent bundle. 3-phase pipeline (scan, fix, verify) with maint:* phase labels for auditing registries and cross-references, applying idempotent fixes, and confirming the fixes cleared the originally-flagged findings. Enabled by default.",
@@ -10637,7 +10681,7 @@ function buildMaintenanceAuditBundle(paths = DEFAULT_AGENT_PATHS, issueDefaults
       buildMaintenanceAuditSkill(paths, issueDefaults),
       buildMaintenanceVerifySkill(issueDefaults)
     ],
-    subAgents: [buildMaintenanceAuditSubAgent(paths)],
+    subAgents: [buildMaintenanceAuditSubAgent(paths, tier)],
     labels: [
       {
         name: "type:maintenance",
@@ -10665,351 +10709,353 @@ function buildMaintenanceAuditBundle(paths = DEFAULT_AGENT_PATHS, issueDefaults
 var maintenanceAuditBundle = buildMaintenanceAuditBundle();
 
 // src/agent/bundles/meeting-analysis.ts
-var meetingAnalystSubAgent = {
-  name: "meeting-analyst",
-  description: "Processes meeting transcripts through a 4-phase pipeline: extract, notes, draft, and link",
-  model: AGENT_MODEL.POWERFUL,
-  maxTurns: 80,
-  platforms: { cursor: { exclude: true } },
-  prompt: [
-    "# Meeting Analyst Agent",
-    "",
-    "You process meeting transcripts through a structured 4-phase pipeline.",
-    "Each phase runs as a **separate agent session**, triggered by its own",
-    "GitHub issue with a `meeting:*` phase label. You handle exactly **one",
-    "phase per session** \u2014 read the issue to determine which phase to execute.",
-    "",
-    "## Execution Model",
-    "",
-    "1. Each meeting produces up to 4 GitHub issues (one per phase)",
-    "2. Each issue carries a `meeting:*` label identifying the phase",
-    "3. You pick up one issue, execute that phase, commit/push, then close the issue",
-    "4. Phase 1 (Extract) creates the downstream phase issues for phases 2-4",
-    "5. Each downstream issue includes `Depends on: #N` linking to its predecessor",
-    "",
-    "## Design Principles",
-    "",
-    "1. **Extract, don't interpret.** Capture what was said and decided. Flag",
-    "   ambiguity as open items rather than resolving it.",
-    "2. **Route to the right category.** Meeting content maps to requirements,",
-    "   ADRs, product docs, and business strategy. Each output goes to the",
-    "   correct location per the project's taxonomy.",
-    "3. **Preserve provenance.** Every extracted item links back to the meeting",
-    "   source so reviewers can check context.",
-    "4. **Create issues, not documents.** For requirements and ADRs, create",
-    "   GitHub issues that other agents or humans will pick up. Do not write",
-    "   final requirement documents yourself.",
-    "5. **Bi-directional traceability.** Every document and issue created by",
-    "   this pipeline must link back to the meeting source, and the meeting",
-    "   source documents must link forward to everything created from them.",
-    "6. **Respect meeting type and areas.** Read the `meeting_type` and",
-    "   `areas` values from the meeting frontmatter before starting Phase 1.",
-    "   Apply the type-specific rules from the **Meeting type handling**",
-    "   table (phases 1\u20132) and the area-filtered routing rules from the",
-    "   **Areas filtering** table (phase 4).",
-    "",
-    "---",
-    "",
-    "## Meeting type handling",
-    "",
-    "Meeting frontmatter is expected to carry a `meeting_type` field whose",
-    "value is one of the project's concrete meeting-type `id`s (declared",
-    "via `AgentConfigOptions.meetings.meetingTypes`). Each concrete `id`",
-    "maps to one of six generic **meeting kinds** that drive type-specific",
-    "extraction rules:",
-    "",
-    "| Kind | Primary outputs | Phase-1/2 rules |",
-    "|------|-----------------|-----------------|",
-    "| `planning` | Sprint/plan updates, task issues, requirement drafts | Extract every task assignment. Phase 4 updates the active sprint-plan doc directly and creates one issue per assigned task. |",
-    "| `review` | Retro notes, follow-up issues, status updates, requirement revisions | Mark completed tasks in the active sprint-plan doc. Capture retrospective learnings inside the meeting notes \u2014 do not spawn a separate retro document. |",
-    "| `brainstorm` | Future-feature candidates, research topics, very few Firm decisions | Lower the bar for Open Questions. Do **not** create requirement or ADR issues from brainstorm output unless the item is explicitly marked **Firm**. Prefer research/discovery issues for promising ideas. |",
-    "| `standup` | Action items, blockers, status updates | Do not produce requirement, ADR, or BDR drafts. Phase 3 (Draft) is almost always skipped. Focus on action-item issues and sprint-plan status updates. |",
-    "| `external` | Customer/competitive intel, people/company profiles, lead capture | Default every attendee outside the team into **People of Interest**. Default every organization mentioned into **Companies of Interest** (signal threshold still applies). Capture stated customer pain points as candidate **BR** (business requirements), not FR. |",
-    "| `other` | General meeting extraction | Apply the default workflow with no type-specific overrides. |",
-    "",
-    "**How to resolve the kind:**",
-    "",
-    "1. Read `meeting_type` from the frontmatter.",
-    "2. Look up the matching `id` in the project's **Recognized meeting",
-    "   types** table (rendered below when `meetingTypes` is declared).",
-    "3. Use the `Kind` column value. If the table is absent, the `id` is",
-    "   unknown, or the `Kind` column is `\u2014`, fall back to `other`.",
-    "4. Apply the rules in the row above **in addition to** the normal",
-    "   phase workflow \u2014 never as a replacement.",
-    "",
-    "If `meeting_type` is missing, invalid, or the declared `id` is not in",
-    "the project's table, note it in the extraction's Open Questions and",
-    "proceed with the default workflow (treat as `other`).",
-    "",
-    "## Areas filtering",
-    "",
-    "Meeting frontmatter may carry an `areas: [...]` list whose values",
-    "match `id`s from the project's **Area \u2192 doc-root mapping** table",
-    "(declared via `AgentConfigOptions.meetings.meetingAreas`). The list",
-    "scopes phase-4 direct edits and cross-references to the doc-root",
-    "sub-folders registered for those areas. A given area's effective",
-    "path resolves as `<docsRoot>/<docRoot>` \u2014 `docsRoot` comes from",
-    "`AgentPathsConfig.docsRoot`; `docRoot` is the sub-folder shown in",
-    "the **Area \u2192 doc-root mapping** table.",
-    "",
-    "**Gating contract (phase 4 only):**",
-    "",
-    "- **Scoped in:** direct edits and cross-reference stubs under the",
-    "  `docRoot` of every `id` present in the meeting's `areas` list.",
-    "- **Scoped out:** direct edits to any doc-root sub-folder that is",
-    "  declared in the project's area map but whose `id` is **not** in",
-    "  the meeting's `areas`. For those out-of-scope areas, create",
-    "  follow-up issues instead of editing the doc directly.",
-    "- **Not gated:** issue creation (requirements, ADRs, profiles,",
-    "  research) is always in scope regardless of areas.",
-    "",
-    "**Resolution rules:**",
-    "",
-    "1. If the meeting's `areas` frontmatter is missing or empty **and**",
-    "   the project has declared a non-empty `meetingAreas` map, no",
-    "   doc-root sub-folder is gated in: direct edits to any declared",
-    "   `docRoot` sub-folder are out-of-scope and become follow-up issues",
-    "   per step 6. Only the default meetings root (`meetingsRoot`)",
-    "   remains editable.",
-    "2. If `areas` lists an `id` that is not in the project's area map,",
-    "   note it in the extraction's Open Questions and treat the unknown",
-    "   `id` as absent. Do **not** invent a doc-root path for it.",
-    "3. Out-of-scope direct edits become `type:docs` follow-up issues on",
-    "   phase 4 step 6, with the area noted in the issue body.",
-    "",
-    "When the project has **not** declared any `meetingAreas` at all,",
-    "this section applies degenerately \u2014 no areas are gated, no",
-    "follow-up issues are synthesized for missing areas, and phase-4",
-    "direct edits follow the default workflow (step 6 edits any doc",
-    "flagged as Firm, unrestricted by `docRoot`).",
-    "",
-    "---",
-    "",
-    ...PROJECT_CONTEXT_MAINTAINER_SECTION,
-    "## Traceability",
-    "",
-    "All outputs must be bi-directionally linked so any artifact can be traced",
-    "back to the meeting that produced it and forward to everything it spawned.",
-    "",
-    "### Backward links (created artifact \u2192 meeting source)",
-    "",
-    "Every GitHub issue and document created by this pipeline must include a",
-    "`## Traceability` section with:",
-    "",
-    "```markdown",
-    "## Traceability",
-    "",
-    "- **Source meeting:** <path to transcript or meeting notes>",
-    "- **Extraction:** <path to extraction file>",
-    "- **Phase issue:** #<N> (the phase issue that created this artifact)",
-    "```",
-    "",
-    "### Forward links (meeting source \u2192 created artifacts)",
-    "",
-    "After Phase 4 (Link) creates all follow-up issues and documents:",
-    "",
-    "1. **Update the extraction file** with a `## Downstream Artifacts` section",
-    "   listing every issue and document created from this meeting:",
-    "",
-    "   ```markdown",
-    "   ## Downstream Artifacts",
-    "",
-    "   | Artifact | Type | Issue/Path |",
-    "   |----------|------|------------|",
-    "   | <title> | requirement / ADR / action-item / profile | #<N> or <path> |",
-    "   ```",
-    "",
-    "2. **Update the meeting notes** with a similar `## Related Issues` section",
-    "   listing all issues created from this meeting.",
-    "",
-    "3. **Comment on the extract issue** with a summary linking to all created",
-    "   artifacts.",
-    "",
-    "### Within-pipeline links",
-    "",
-    "- Phase issues link to predecessors via `Depends on: #N`",
-    "- Phase issues reference the extraction file path in their body",
-    "- Draft documents reference both the extraction and the meeting notes",
-    "",
-    "---",
-    "",
-    "## Phase 1: Extract (`meeting:extract`)",
-    "",
-    "**Goal:** Read the meeting transcript and categorize all substantive content.",
-    "",
-    "### Steps",
-    "",
-    "1. Read the transcript file specified in the issue body. Parse the",
-    "   meeting-note frontmatter first, capturing `meeting_type` and",
-    "   `areas`. Resolve `meeting_type` to a kind using the **Meeting type",
-    "   handling** table; note the resolved kind in the extraction",
-    "   frontmatter. If `meeting_type` is missing or not in the project's",
-    "   Recognized meeting types table, treat it as `other` and flag it",
-    "   in Open Questions.",
-    "2. Identify and categorize content into these buckets:",
-    "",
-    "   | Bucket | What to look for |",
-    "   |--------|-----------------|",
-    `   | **Decisions** | "We decided...", "Let's go with...", explicit choices |`,
-    '   | **Requirements** | Feature descriptions, acceptance criteria, "it should..." |',
-    "   | **Technology discussions** | Platform comparisons, architecture options, tool evaluations |",
-    '   | **Action items** | "[Person] will...", "Next step is...", assigned tasks |',
-    '   | **Open questions** | "We need to figure out...", unresolved debates |',
-    "   | **People of interest** | Industry contacts, domain experts mentioned |",
-    "   | **Companies of interest** | Competitors, vendors, partners discussed |",
-    "   | **Strategic direction** | Business model changes, market positioning |",
-    "   | **Product direction** | Roadmap changes, feature prioritization |",
-    "",
-    "3. Write the extraction to a markdown file with structured sections:",
-    "   - Attendees",
-    "   - Decisions Made (with category and confidence: Firm / Tentative / Needs confirmation)",
-    "   - Requirements Identified (with category and priority estimate)",
-    "   - Technology Discussions (with status: Decided / Leaning toward / Open)",
-    "   - Action Items (with assignee and due date if stated)",
-    "   - Open Questions",
-    "   - People of Interest (with context and whether a profile exists)",
-    "   - Companies of Interest (with type and context)",
-    "   - Strategic / Product Direction",
-    "",
-    "   Carry `meeting_type`, the resolved `meeting_kind`, and `areas`",
-    "   into the extraction frontmatter so downstream phases can gate",
-    "   behaviour without re-parsing the meeting note.",
-    "",
-    "4. **Apply type-specific rules.** Consult the **Meeting type handling**",
-    "   table for the resolved kind and apply its phase-1 rules in",
-    "   addition to the default extraction above. Examples:",
-    "   - `standup`: skip requirement, ADR, and BDR extraction; focus on",
-    "     action items and status.",
-    "   - `brainstorm`: emphasize Open Questions and Future Features.",
-    "     Only mark decisions as Firm when the transcript is unambiguous.",
-    "   - `external`: default attendees outside the team into People of",
-    "     Interest; default organizations mentioned into Companies of",
-    "     Interest (signal threshold still applies); capture customer",
-    "     pain points as candidate BR (not FR).",
-    "",
-    "5. **Create downstream phase issues** using `gh issue create`:",
-    "   - Always create a `meeting:notes` issue (blocked on this extract issue)",
-    "   - If requirements OR decisions/ADRs identified, create a `meeting:draft` issue",
-    "     (blocked on the notes issue). For kind `standup`, skip the",
-    "     `meeting:draft` issue \u2014 standup meetings almost never produce",
-    "     formal drafts.",
-    "   - Always create a `meeting:link` issue \u2014 blocked on the draft issue if one",
-    "     was created, otherwise blocked on the notes issue",
-    "",
-    "6. Commit, push, and close the extract issue.",
-    "",
-    "---",
-    "",
-    "## Phase 2: Notes (`meeting:notes`)",
-    "",
-    "**Goal:** Transform the extraction into structured meeting notes.",
-    "",
-    "### Steps",
-    "",
-    "1. Read the extraction file referenced in the issue body (output of Phase 1).",
-    "2. Write structured meeting notes with these sections:",
-    "   - Meeting metadata (title, date, attendees)",
-    "   - Agenda / topics covered",
-    "   - Key Discussion Points (organized by topic)",
-    "   - Decisions (numbered, with rationale)",
-    "   - Action Items (table: who, what, when)",
-    "   - Open Questions",
-    "   - Follow-up items",
-    "3. Commit, push, and close the notes issue.",
-    "",
-    "---",
-    "",
-    "## Phase 3: Draft (`meeting:draft`)",
-    "",
-    "**Goal:** Draft proposals for requirements, ADRs, and product/strategy updates.",
-    "",
-    "This phase only exists if the extraction identified requirements, architectural",
-    "decisions, or strategy changes. If this issue exists, execute it.",
-    "",
-    "### Steps",
-    "",
-    "1. Read the extraction file from Phase 1.",
-    "2. Check existing requirement registries and ADR registries for duplicates.",
-    "3. Draft requirement proposals with:",
-    "   - Category (FR, BR, NFR, etc.)",
-    "   - Summary (2-3 sentences)",
-    "   - Draft acceptance criteria",
-    "   - Related existing requirements",
-    "4. Draft ADR proposals for technology decisions with:",
-    "   - Context and problem statement",
-    "   - Options discussed",
-    "   - Stated preferences or decisions",
-    "   - Status: Proposed or Decided",
-    "5. Summarize product/strategy document updates needed.",
-    "6. Commit, push, and close the draft issue.",
-    "",
-    "---",
-    "",
-    "## Phase 4: Link (`meeting:link`)",
-    "",
-    "**Goal:** Create GitHub issues for follow-up work, cross-reference the",
-    "meeting into existing documentation, and complete bi-directional traceability.",
-    "",
-    "### Steps",
-    "",
-    "1. Read the drafts from Phase 3 (if they exist) and the extraction from Phase 1.",
-    "   Re-read the extraction frontmatter for `meeting_kind` and `areas`,",
-    "   then build the area-gate: the set of `docRoot` sub-folders that",
-    "   are in scope for direct edits on this meeting. Apply the rules in",
-    "   the **Areas filtering** section above.",
-    "2. Create requirement issues using `gh issue create` with appropriate labels.",
-    "   Include a `## Traceability` section in each issue body linking back to",
-    "   the source meeting and extraction file. Issue creation is **not**",
-    "   gated by areas.",
-    "3. Create ADR issues if technology decisions need formal records.",
-    "   Include a `## Traceability` section in each. Not gated by areas.",
-    "4. Create action item issues for tasks that are not document-related.",
-    "   Include a `## Traceability` section in each. Not gated by areas.",
-    "5. Cross-reference the meeting in any existing documents that were",
-    "   discussed **and that live under an in-scope `docRoot`**. For",
-    "   discussed documents under an out-of-scope `docRoot`, open a",
-    "   follow-up `type:docs` issue instead of editing the doc directly.",
-    "6. Apply direct product/strategy doc updates for items flagged as",
-    "   **Firm** confidence. When the project declares `meetingAreas`,",
-    "   gate these edits: only apply them when the target path lies",
-    "   under an in-scope `docRoot`, and for Firm items targeting an",
-    "   out-of-scope `docRoot` open a follow-up `type:docs` issue",
-    "   noting the area and the target path. When the project has not",
-    "   declared any `meetingAreas`, apply Firm updates unrestricted",
-    "   (the degenerate case above). For the kind `planning`, also",
-    "   update the active sprint-plan doc directly (when the",
-    "   sprint-plan doc's area is in-scope, or always when no",
-    "   `meetingAreas` are declared); for the kind `review`, mark",
-    "   completed tasks in that same doc.",
-    "7. **Update the extraction file** with a `## Downstream Artifacts` section",
-    "   listing every issue and document created from this meeting. Note",
-    "   any items that were deferred to follow-up issues because of the",
-    "   area gate.",
-    "8. **Update the meeting notes** 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",
-    "- 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 buildMeetingAnalystSubAgent(tier) {
+  return {
+    name: "meeting-analyst",
+    description: "Processes meeting transcripts through a 4-phase pipeline: extract, notes, draft, and link",
+    model: tier,
+    maxTurns: 80,
+    platforms: { cursor: { exclude: true } },
+    prompt: [
+      "# Meeting Analyst Agent",
+      "",
+      "You process meeting transcripts through a structured 4-phase pipeline.",
+      "Each phase runs as a **separate agent session**, triggered by its own",
+      "GitHub issue with a `meeting:*` phase label. You handle exactly **one",
+      "phase per session** \u2014 read the issue to determine which phase to execute.",
+      "",
+      "## Execution Model",
+      "",
+      "1. Each meeting produces up to 4 GitHub issues (one per phase)",
+      "2. Each issue carries a `meeting:*` label identifying the phase",
+      "3. You pick up one issue, execute that phase, commit/push, then close the issue",
+      "4. Phase 1 (Extract) creates the downstream phase issues for phases 2-4",
+      "5. Each downstream issue includes `Depends on: #N` linking to its predecessor",
+      "",
+      "## Design Principles",
+      "",
+      "1. **Extract, don't interpret.** Capture what was said and decided. Flag",
+      "   ambiguity as open items rather than resolving it.",
+      "2. **Route to the right category.** Meeting content maps to requirements,",
+      "   ADRs, product docs, and business strategy. Each output goes to the",
+      "   correct location per the project's taxonomy.",
+      "3. **Preserve provenance.** Every extracted item links back to the meeting",
+      "   source so reviewers can check context.",
+      "4. **Create issues, not documents.** For requirements and ADRs, create",
+      "   GitHub issues that other agents or humans will pick up. Do not write",
+      "   final requirement documents yourself.",
+      "5. **Bi-directional traceability.** Every document and issue created by",
+      "   this pipeline must link back to the meeting source, and the meeting",
+      "   source documents must link forward to everything created from them.",
+      "6. **Respect meeting type and areas.** Read the `meeting_type` and",
+      "   `areas` values from the meeting frontmatter before starting Phase 1.",
+      "   Apply the type-specific rules from the **Meeting type handling**",
+      "   table (phases 1\u20132) and the area-filtered routing rules from the",
+      "   **Areas filtering** table (phase 4).",
+      "",
+      "---",
+      "",
+      "## Meeting type handling",
+      "",
+      "Meeting frontmatter is expected to carry a `meeting_type` field whose",
+      "value is one of the project's concrete meeting-type `id`s (declared",
+      "via `AgentConfigOptions.meetings.meetingTypes`). Each concrete `id`",
+      "maps to one of six generic **meeting kinds** that drive type-specific",
+      "extraction rules:",
+      "",
+      "| Kind | Primary outputs | Phase-1/2 rules |",
+      "|------|-----------------|-----------------|",
+      "| `planning` | Sprint/plan updates, task issues, requirement drafts | Extract every task assignment. Phase 4 updates the active sprint-plan doc directly and creates one issue per assigned task. |",
+      "| `review` | Retro notes, follow-up issues, status updates, requirement revisions | Mark completed tasks in the active sprint-plan doc. Capture retrospective learnings inside the meeting notes \u2014 do not spawn a separate retro document. |",
+      "| `brainstorm` | Future-feature candidates, research topics, very few Firm decisions | Lower the bar for Open Questions. Do **not** create requirement or ADR issues from brainstorm output unless the item is explicitly marked **Firm**. Prefer research/discovery issues for promising ideas. |",
+      "| `standup` | Action items, blockers, status updates | Do not produce requirement, ADR, or BDR drafts. Phase 3 (Draft) is almost always skipped. Focus on action-item issues and sprint-plan status updates. |",
+      "| `external` | Customer/competitive intel, people/company profiles, lead capture | Default every attendee outside the team into **People of Interest**. Default every organization mentioned into **Companies of Interest** (signal threshold still applies). Capture stated customer pain points as candidate **BR** (business requirements), not FR. |",
+      "| `other` | General meeting extraction | Apply the default workflow with no type-specific overrides. |",
+      "",
+      "**How to resolve the kind:**",
+      "",
+      "1. Read `meeting_type` from the frontmatter.",
+      "2. Look up the matching `id` in the project's **Recognized meeting",
+      "   types** table (rendered below when `meetingTypes` is declared).",
+      "3. Use the `Kind` column value. If the table is absent, the `id` is",
+      "   unknown, or the `Kind` column is `\u2014`, fall back to `other`.",
+      "4. Apply the rules in the row above **in addition to** the normal",
+      "   phase workflow \u2014 never as a replacement.",
+      "",
+      "If `meeting_type` is missing, invalid, or the declared `id` is not in",
+      "the project's table, note it in the extraction's Open Questions and",
+      "proceed with the default workflow (treat as `other`).",
+      "",
+      "## Areas filtering",
+      "",
+      "Meeting frontmatter may carry an `areas: [...]` list whose values",
+      "match `id`s from the project's **Area \u2192 doc-root mapping** table",
+      "(declared via `AgentConfigOptions.meetings.meetingAreas`). The list",
+      "scopes phase-4 direct edits and cross-references to the doc-root",
+      "sub-folders registered for those areas. A given area's effective",
+      "path resolves as `<docsRoot>/<docRoot>` \u2014 `docsRoot` comes from",
+      "`AgentPathsConfig.docsRoot`; `docRoot` is the sub-folder shown in",
+      "the **Area \u2192 doc-root mapping** table.",
+      "",
+      "**Gating contract (phase 4 only):**",
+      "",
+      "- **Scoped in:** direct edits and cross-reference stubs under the",
+      "  `docRoot` of every `id` present in the meeting's `areas` list.",
+      "- **Scoped out:** direct edits to any doc-root sub-folder that is",
+      "  declared in the project's area map but whose `id` is **not** in",
+      "  the meeting's `areas`. For those out-of-scope areas, create",
+      "  follow-up issues instead of editing the doc directly.",
+      "- **Not gated:** issue creation (requirements, ADRs, profiles,",
+      "  research) is always in scope regardless of areas.",
+      "",
+      "**Resolution rules:**",
+      "",
+      "1. If the meeting's `areas` frontmatter is missing or empty **and**",
+      "   the project has declared a non-empty `meetingAreas` map, no",
+      "   doc-root sub-folder is gated in: direct edits to any declared",
+      "   `docRoot` sub-folder are out-of-scope and become follow-up issues",
+      "   per step 6. Only the default meetings root (`meetingsRoot`)",
+      "   remains editable.",
+      "2. If `areas` lists an `id` that is not in the project's area map,",
+      "   note it in the extraction's Open Questions and treat the unknown",
+      "   `id` as absent. Do **not** invent a doc-root path for it.",
+      "3. Out-of-scope direct edits become `type:docs` follow-up issues on",
+      "   phase 4 step 6, with the area noted in the issue body.",
+      "",
+      "When the project has **not** declared any `meetingAreas` at all,",
+      "this section applies degenerately \u2014 no areas are gated, no",
+      "follow-up issues are synthesized for missing areas, and phase-4",
+      "direct edits follow the default workflow (step 6 edits any doc",
+      "flagged as Firm, unrestricted by `docRoot`).",
+      "",
+      "---",
+      "",
+      ...PROJECT_CONTEXT_MAINTAINER_SECTION,
+      "## Traceability",
+      "",
+      "All outputs must be bi-directionally linked so any artifact can be traced",
+      "back to the meeting that produced it and forward to everything it spawned.",
+      "",
+      "### Backward links (created artifact \u2192 meeting source)",
+      "",
+      "Every GitHub issue and document created by this pipeline must include a",
+      "`## Traceability` section with:",
+      "",
+      "```markdown",
+      "## Traceability",
+      "",
+      "- **Source meeting:** <path to transcript or meeting notes>",
+      "- **Extraction:** <path to extraction file>",
+      "- **Phase issue:** #<N> (the phase issue that created this artifact)",
+      "```",
+      "",
+      "### Forward links (meeting source \u2192 created artifacts)",
+      "",
+      "After Phase 4 (Link) creates all follow-up issues and documents:",
+      "",
+      "1. **Update the extraction file** with a `## Downstream Artifacts` section",
+      "   listing every issue and document created from this meeting:",
+      "",
+      "   ```markdown",
+      "   ## Downstream Artifacts",
+      "",
+      "   | Artifact | Type | Issue/Path |",
+      "   |----------|------|------------|",
+      "   | <title> | requirement / ADR / action-item / profile | #<N> or <path> |",
+      "   ```",
+      "",
+      "2. **Update the meeting notes** with a similar `## Related Issues` section",
+      "   listing all issues created from this meeting.",
+      "",
+      "3. **Comment on the extract issue** with a summary linking to all created",
+      "   artifacts.",
+      "",
+      "### Within-pipeline links",
+      "",
+      "- Phase issues link to predecessors via `Depends on: #N`",
+      "- Phase issues reference the extraction file path in their body",
+      "- Draft documents reference both the extraction and the meeting notes",
+      "",
+      "---",
+      "",
+      "## Phase 1: Extract (`meeting:extract`)",
+      "",
+      "**Goal:** Read the meeting transcript and categorize all substantive content.",
+      "",
+      "### Steps",
+      "",
+      "1. Read the transcript file specified in the issue body. Parse the",
+      "   meeting-note frontmatter first, capturing `meeting_type` and",
+      "   `areas`. Resolve `meeting_type` to a kind using the **Meeting type",
+      "   handling** table; note the resolved kind in the extraction",
+      "   frontmatter. If `meeting_type` is missing or not in the project's",
+      "   Recognized meeting types table, treat it as `other` and flag it",
+      "   in Open Questions.",
+      "2. Identify and categorize content into these buckets:",
+      "",
+      "   | Bucket | What to look for |",
+      "   |--------|-----------------|",
+      `   | **Decisions** | "We decided...", "Let's go with...", explicit choices |`,
+      '   | **Requirements** | Feature descriptions, acceptance criteria, "it should..." |',
+      "   | **Technology discussions** | Platform comparisons, architecture options, tool evaluations |",
+      '   | **Action items** | "[Person] will...", "Next step is...", assigned tasks |',
+      '   | **Open questions** | "We need to figure out...", unresolved debates |',
+      "   | **People of interest** | Industry contacts, domain experts mentioned |",
+      "   | **Companies of interest** | Competitors, vendors, partners discussed |",
+      "   | **Strategic direction** | Business model changes, market positioning |",
+      "   | **Product direction** | Roadmap changes, feature prioritization |",
+      "",
+      "3. Write the extraction to a markdown file with structured sections:",
+      "   - Attendees",
+      "   - Decisions Made (with category and confidence: Firm / Tentative / Needs confirmation)",
+      "   - Requirements Identified (with category and priority estimate)",
+      "   - Technology Discussions (with status: Decided / Leaning toward / Open)",
+      "   - Action Items (with assignee and due date if stated)",
+      "   - Open Questions",
+      "   - People of Interest (with context and whether a profile exists)",
+      "   - Companies of Interest (with type and context)",
+      "   - Strategic / Product Direction",
+      "",
+      "   Carry `meeting_type`, the resolved `meeting_kind`, and `areas`",
+      "   into the extraction frontmatter so downstream phases can gate",
+      "   behaviour without re-parsing the meeting note.",
+      "",
+      "4. **Apply type-specific rules.** Consult the **Meeting type handling**",
+      "   table for the resolved kind and apply its phase-1 rules in",
+      "   addition to the default extraction above. Examples:",
+      "   - `standup`: skip requirement, ADR, and BDR extraction; focus on",
+      "     action items and status.",
+      "   - `brainstorm`: emphasize Open Questions and Future Features.",
+      "     Only mark decisions as Firm when the transcript is unambiguous.",
+      "   - `external`: default attendees outside the team into People of",
+      "     Interest; default organizations mentioned into Companies of",
+      "     Interest (signal threshold still applies); capture customer",
+      "     pain points as candidate BR (not FR).",
+      "",
+      "5. **Create downstream phase issues** using `gh issue create`:",
+      "   - Always create a `meeting:notes` issue (blocked on this extract issue)",
+      "   - If requirements OR decisions/ADRs identified, create a `meeting:draft` issue",
+      "     (blocked on the notes issue). For kind `standup`, skip the",
+      "     `meeting:draft` issue \u2014 standup meetings almost never produce",
+      "     formal drafts.",
+      "   - Always create a `meeting:link` issue \u2014 blocked on the draft issue if one",
+      "     was created, otherwise blocked on the notes issue",
+      "",
+      "6. Commit, push, and close the extract issue.",
+      "",
+      "---",
+      "",
+      "## Phase 2: Notes (`meeting:notes`)",
+      "",
+      "**Goal:** Transform the extraction into structured meeting notes.",
+      "",
+      "### Steps",
+      "",
+      "1. Read the extraction file referenced in the issue body (output of Phase 1).",
+      "2. Write structured meeting notes with these sections:",
+      "   - Meeting metadata (title, date, attendees)",
+      "   - Agenda / topics covered",
+      "   - Key Discussion Points (organized by topic)",
+      "   - Decisions (numbered, with rationale)",
+      "   - Action Items (table: who, what, when)",
+      "   - Open Questions",
+      "   - Follow-up items",
+      "3. Commit, push, and close the notes issue.",
+      "",
+      "---",
+      "",
+      "## Phase 3: Draft (`meeting:draft`)",
+      "",
+      "**Goal:** Draft proposals for requirements, ADRs, and product/strategy updates.",
+      "",
+      "This phase only exists if the extraction identified requirements, architectural",
+      "decisions, or strategy changes. If this issue exists, execute it.",
+      "",
+      "### Steps",
+      "",
+      "1. Read the extraction file from Phase 1.",
+      "2. Check existing requirement registries and ADR registries for duplicates.",
+      "3. Draft requirement proposals with:",
+      "   - Category (FR, BR, NFR, etc.)",
+      "   - Summary (2-3 sentences)",
+      "   - Draft acceptance criteria",
+      "   - Related existing requirements",
+      "4. Draft ADR proposals for technology decisions with:",
+      "   - Context and problem statement",
+      "   - Options discussed",
+      "   - Stated preferences or decisions",
+      "   - Status: Proposed or Decided",
+      "5. Summarize product/strategy document updates needed.",
+      "6. Commit, push, and close the draft issue.",
+      "",
+      "---",
+      "",
+      "## Phase 4: Link (`meeting:link`)",
+      "",
+      "**Goal:** Create GitHub issues for follow-up work, cross-reference the",
+      "meeting into existing documentation, and complete bi-directional traceability.",
+      "",
+      "### Steps",
+      "",
+      "1. Read the drafts from Phase 3 (if they exist) and the extraction from Phase 1.",
+      "   Re-read the extraction frontmatter for `meeting_kind` and `areas`,",
+      "   then build the area-gate: the set of `docRoot` sub-folders that",
+      "   are in scope for direct edits on this meeting. Apply the rules in",
+      "   the **Areas filtering** section above.",
+      "2. Create requirement issues using `gh issue create` with appropriate labels.",
+      "   Include a `## Traceability` section in each issue body linking back to",
+      "   the source meeting and extraction file. Issue creation is **not**",
+      "   gated by areas.",
+      "3. Create ADR issues if technology decisions need formal records.",
+      "   Include a `## Traceability` section in each. Not gated by areas.",
+      "4. Create action item issues for tasks that are not document-related.",
+      "   Include a `## Traceability` section in each. Not gated by areas.",
+      "5. Cross-reference the meeting in any existing documents that were",
+      "   discussed **and that live under an in-scope `docRoot`**. For",
+      "   discussed documents under an out-of-scope `docRoot`, open a",
+      "   follow-up `type:docs` issue instead of editing the doc directly.",
+      "6. Apply direct product/strategy doc updates for items flagged as",
+      "   **Firm** confidence. When the project declares `meetingAreas`,",
+      "   gate these edits: only apply them when the target path lies",
+      "   under an in-scope `docRoot`, and for Firm items targeting an",
+      "   out-of-scope `docRoot` open a follow-up `type:docs` issue",
+      "   noting the area and the target path. When the project has not",
+      "   declared any `meetingAreas`, apply Firm updates unrestricted",
+      "   (the degenerate case above). For the kind `planning`, also",
+      "   update the active sprint-plan doc directly (when the",
+      "   sprint-plan doc's area is in-scope, or always when no",
+      "   `meetingAreas` are declared); for the kind `review`, mark",
+      "   completed tasks in that same doc.",
+      "7. **Update the extraction file** with a `## Downstream Artifacts` section",
+      "   listing every issue and document created from this meeting. Note",
+      "   any items that were deferred to follow-up issues because of the",
+      "   area gate.",
+      "8. **Update the meeting notes** 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",
+      "- 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",
@@ -11053,64 +11099,67 @@ var processMeetingSkill = {
     "  to pick up (notes, draft, link)"
   ].join("\n")
 };
-var meetingAnalysisBundle = {
-  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 transcript 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 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)."
-      ].join("\n"),
-      platforms: {
-        cursor: { exclude: true }
+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 transcript 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 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)."
+        ].join("\n"),
+        platforms: {
+          cursor: { exclude: true }
+        },
+        tags: ["workflow"]
+      }
+    ],
+    skills: [processMeetingSkill],
+    subAgents: [buildMeetingAnalystSubAgent(tier)],
+    labels: [
+      {
+        name: "meeting:extract",
+        color: "C5DEF5",
+        description: "Phase 1: raw extraction from a meeting transcript"
       },
-      tags: ["workflow"]
-    }
-  ],
-  skills: [processMeetingSkill],
-  subAgents: [meetingAnalystSubAgent],
-  labels: [
-    {
-      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"
-    }
-  ]
-};
+      {
+        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/run-ratio.ts
 var DEFAULT_DISPATCH_TO_HOUSEKEEPING_RATIO = 4;
@@ -13185,11 +13234,10 @@ function shellSingleQuote(value) {
 }
 
 // src/agent/bundles/orchestrator.ts
-function buildCheckBlockedScript(tiers, scopeGate, runRatio) {
+function buildCheckBlockedScript(tiers, scopeGate, _runRatio) {
   const tierCase = renderAgentTierCaseStatement(tiers);
   const scopeHelper = renderScopeGateShellHelpers(scopeGate);
   const scopeHelperIndented = scopeHelper.split("\n").map((line) => line.length > 0 ? line : "").join("\n");
-  const runRatioHelper = renderRunRatioShellHelpers(runRatio);
   return [
     "#!/usr/bin/env bash",
     "# check-blocked.sh \u2014 Token-efficient issue triage for agent loops.",
@@ -13201,9 +13249,9 @@ function buildCheckBlockedScript(tiers, scopeGate, runRatio) {
     "#   .claude/procedures/check-blocked.sh eligible",
     "#   .claude/procedures/check-blocked.sh stale",
     "#   .claude/procedures/check-blocked.sh orphaned",
+    "#   .claude/procedures/check-blocked.sh maintenance",
     "#   .claude/procedures/check-blocked.sh prs",
     "#   .claude/procedures/check-blocked.sh scope <issue-number>",
-    "#   .claude/procedures/check-blocked.sh tick",
     "",
     "set -uo pipefail",
     "",
@@ -13217,9 +13265,6 @@ function buildCheckBlockedScript(tiers, scopeGate, runRatio) {
     `SCOPE_AC_MEDIUM_MAX=${scopeGate.acceptanceCriteria.mediumMax}`,
     `SCOPE_SOURCES_SMALL_MAX=${scopeGate.sources.smallMax}`,
     `SCOPE_SOURCES_MEDIUM_MAX=${scopeGate.sources.mediumMax}`,
-    `RUN_RATIO_ENABLED=${runRatio.enabled ? "1" : "0"}`,
-    `RUN_RATIO_DISPATCH_PER_HOUSEKEEPING=${runRatio.ratio}`,
-    `ORCHESTRATOR_STATE_FILE="${runRatio.stateFilePath}"`,
     "",
     "# \u2500\u2500 helpers \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
     "",
@@ -13250,8 +13295,6 @@ function buildCheckBlockedScript(tiers, scopeGate, runRatio) {
     "",
     scopeHelperIndented,
     "",
-    runRatioHelper,
-    "",
     "# \u2500\u2500 subcommands \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
     "",
     "cmd_unblock() {",
@@ -13262,7 +13305,7 @@ function buildCheckBlockedScript(tiers, scopeGate, runRatio) {
     "  local count",
     `  count=$(echo "$issues" | jq 'length')`,
     '  if [[ "$count" -eq 0 ]]; then',
-    '    echo "NO_BLOCKED_ISSUES"',
+    '    echo "TRIAGE_DONE unblocked=0 still_blocked=0"',
     "    return 0",
     "  fi",
     "",
@@ -13273,18 +13316,36 @@ function buildCheckBlockedScript(tiers, scopeGate, runRatio) {
     '    "\\(.number)\\t\\($dep_line)"',
     "  ')",
     "",
+    "  # Counters for the summary line. The orchestrator reads only",
+    "  # TRIAGE_DONE; the per-issue lines below are for log visibility,",
+    "  # mirroring unblock-dependents.sh.",
+    "  local unblocked_count=0",
+    "  local still_blocked_count=0",
+    "",
     "  while IFS=$'\\t' read -r num dep_line; do",
     '    [[ -z "$num" ]] && continue',
     "",
     '    if [[ -z "$dep_line" ]]; then',
     '      echo "BLOCKED #${num} \u2014 no Depends on field found"',
+    "      still_blocked_count=$((still_blocked_count + 1))",
     "      continue",
     "    fi",
     "",
     "    local deps",
     '    deps=$(parse_deps "$dep_line")',
     '    if [[ -z "${deps// /}" ]]; then',
-    '      echo "UNBLOCK #${num} \u2014 no dependencies"',
+    "      # Empty dependency list \u2014 treat as eligible for unblocking.",
+    '      if gh issue edit "$num" \\',
+    '          --remove-label "status:blocked" \\',
+    '          --add-label "status:ready" >/dev/null 2>&1; then',
+    '        gh issue comment "$num" \\',
+    '          --body "Dependencies resolved \u2014 unblocking." >/dev/null 2>&1 || true',
+    '        echo "UNBLOCKED #${num} \u2014 no dependencies"',
+    "        unblocked_count=$((unblocked_count + 1))",
+    "      else",
+    '        echo "UNBLOCK_FAILED #${num} \u2014 label flip failed (no dependencies)"',
+    "        still_blocked_count=$((still_blocked_count + 1))",
+    "      fi",
     "      continue",
     "    fi",
     "",
@@ -13301,11 +13362,30 @@ function buildCheckBlockedScript(tiers, scopeGate, runRatio) {
     "    done",
     "",
     "    if $all_closed; then",
-    '      echo "UNBLOCK #${num} \u2014 all deps closed (${closed_deps% })"',
+    "      # The label flip is the load-bearing edit; if it fails we must",
+    "      # report the failure so the orchestrator does not double-count.",
+    "      # The comment is best-effort (its absence is recoverable on the",
+    "      # next sweep), so a failed `gh issue comment` does not block the",
+    "      # unblock from being recorded as successful.",
+    '      if gh issue edit "$num" \\',
+    '          --remove-label "status:blocked" \\',
+    '          --add-label "status:ready" >/dev/null 2>&1; then',
+    '        gh issue comment "$num" \\',
+    '          --body "Dependencies resolved \u2014 unblocking." >/dev/null 2>&1 || true',
+    '        echo "UNBLOCKED #${num} \u2014 all deps closed (${closed_deps% })"',
+    "        unblocked_count=$((unblocked_count + 1))",
+    "      else",
+    '        echo "UNBLOCK_FAILED #${num} \u2014 label flip failed (all deps closed: ${closed_deps% })"',
+    "        still_blocked_count=$((still_blocked_count + 1))",
+    "      fi",
     "    else",
-    '      echo "BLOCKED #${num} \u2014 waiting on ${open_deps% }"',
+    '      echo "STILL_BLOCKED #${num} \u2014 waiting on ${open_deps% }"',
+    "      still_blocked_count=$((still_blocked_count + 1))",
     "    fi",
     '  done <<< "$issue_data"',
+    "",
+    "  # Single summary line consumed by the orchestrator.",
+    '  echo "TRIAGE_DONE unblocked=${unblocked_count} still_blocked=${still_blocked_count}"',
     "}",
     "",
     "cmd_eligible() {",
@@ -13497,6 +13577,101 @@ function buildCheckBlockedScript(tiers, scopeGate, runRatio) {
     "  fi",
     "}",
     "",
+    "cmd_maintenance() {",
+    "  # Phase D maintenance sweep: flag stale issues with",
+    "  # `status:needs-attention`, count orphan branches/PRs (no",
+    "  # auto-deletion), and emit a single MAINTENANCE_DONE summary",
+    "  # line so the orchestrator never iterates raw stale/orphan",
+    "  # output. Mirrors the discipline of cmd_unblock \u2014 per-issue",
+    "  # informational lines (FLAGGED #N, ORPHAN_BRANCH \u2026) survive",
+    "  # for log visibility but are not load-bearing for the",
+    "  # orchestrator.",
+    "  #",
+    "  # SAFETY: this subcommand NEVER auto-resets stale issues to",
+    "  # `status:ready`. It only adds `status:needs-attention`; the",
+    "  # existing `status:in-progress` or `status:blocked` label",
+    "  # stays in place so partial implementation work on a branch",
+    "  # remains visible to humans.",
+    "",
+    "  local flagged_stale_count=0",
+    "  local flagged_blocked_count=0",
+    "  local orphan_branches_count=0",
+    "  local orphan_prs_count=0",
+    "",
+    "  # \u2500\u2500 stale detection + flagging \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
+    "  local stale_output",
+    "  stale_output=$(cmd_stale)",
+    "",
+    "  while IFS= read -r line; do",
+    '    [[ -z "$line" ]] && continue',
+    '    case "$line" in',
+    "      'STALE #'*)",
+    "        # Extract the issue number after the '#' and before the ' '.",
+    "        local num=${line#STALE #}",
+    "        num=${num%% *}",
+    '        if gh issue edit "$num" --add-label "status:needs-attention" >/dev/null 2>&1; then',
+    '          gh issue comment "$num" \\',
+    '            --body "Flagged: in-progress for >3 days with no activity." >/dev/null 2>&1 || true',
+    '          echo "FLAGGED_STALE #${num} \u2014 added status:needs-attention"',
+    "          flagged_stale_count=$((flagged_stale_count + 1))",
+    "        else",
+    '          echo "FLAG_FAILED #${num} \u2014 could not add status:needs-attention (stale)"',
+    "        fi",
+    "        # Surface the original informational line for log visibility.",
+    '        echo "$line"',
+    "        ;;",
+    "      'STALE_BLOCKED #'*)",
+    "        local num=${line#STALE_BLOCKED #}",
+    "        num=${num%% *}",
+    '        if gh issue edit "$num" --add-label "status:needs-attention" >/dev/null 2>&1; then',
+    '          gh issue comment "$num" \\',
+    '            --body "Flagged: blocked for >7 days \u2014 may need human intervention." >/dev/null 2>&1 || true',
+    '          echo "FLAGGED_BLOCKED #${num} \u2014 added status:needs-attention"',
+    "          flagged_blocked_count=$((flagged_blocked_count + 1))",
+    "        else",
+    '          echo "FLAG_FAILED #${num} \u2014 could not add status:needs-attention (blocked)"',
+    "        fi",
+    '        echo "$line"',
+    "        ;;",
+    "      'NO_STALE_ISSUES')",
+    "        # Surface the no-op marker for log visibility; counters",
+    "        # stay at zero.",
+    '        echo "$line"',
+    "        ;;",
+    "    esac",
+    '  done <<< "$stale_output"',
+    "",
+    "  # \u2500\u2500 orphan detection (count only \u2014 no auto-deletion) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
+    "  local orphan_output",
+    "  orphan_output=$(cmd_orphaned)",
+    "",
+    "  while IFS= read -r line; do",
+    '    [[ -z "$line" ]] && continue',
+    '    case "$line" in',
+    "      'ORPHAN_BRANCH '*)",
+    "        orphan_branches_count=$((orphan_branches_count + 1))",
+    '        echo "$line"',
+    "        ;;",
+    "      'ORPHAN_PR '*)",
+    "        orphan_prs_count=$((orphan_prs_count + 1))",
+    '        echo "$line"',
+    "        ;;",
+    "      'NO_ORPHANED_RESOURCES')",
+    '        echo "$line"',
+    "        ;;",
+    "    esac",
+    '  done <<< "$orphan_output"',
+    "",
+    "  # \u2500\u2500 needs-attention total \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
+    "  local needs_attention_total",
+    '  needs_attention_total=$(gh issue list --label "status:needs-attention" --state open \\',
+    "    --json number --limit 100 2>/dev/null | jq 'length' 2>/dev/null || echo 0)",
+    "  needs_attention_total=${needs_attention_total:-0}",
+    "",
+    "  # Single summary line consumed by the orchestrator.",
+    '  echo "MAINTENANCE_DONE flagged_stale=${flagged_stale_count} flagged_blocked=${flagged_blocked_count} orphan_branches=${orphan_branches_count} orphan_prs=${orphan_prs_count} needs_attention_total=${needs_attention_total}"',
+    "}",
+    "",
     "cmd_prs() {",
     "  local prs",
     "  prs=$(gh pr list --state open --json number,title,isDraft,headRefName,labels,body \\",
@@ -13635,31 +13810,18 @@ function buildCheckBlockedScript(tiers, scopeGate, runRatio) {
     "  fi",
     "}",
     "",
-    "cmd_tick() {",
-    "  # DEPRECATED: the orchestrator no longer maintains a dispatch /",
-    "  # housekeeping run-counter \u2014 every invocation runs the full",
-    "  # end-to-end cycle. This subcommand is retained as a no-op for one",
-    "  # release so any consumer mid-flight does not error out, then will",
-    "  # be removed entirely. Existing state files at",
-    '  # "$ORCHESTRATOR_STATE_FILE" can be left alone (they will become',
-    "  # orphaned).",
-    '  echo "tick: deprecated no-op (orchestrator runs a single linear cycle every invocation)" >&2',
-    '  echo "run=0 type=dispatch (deprecated)"',
-    "  return 0",
-    "}",
-    "",
     "# \u2500\u2500 main \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
     "",
     'case "${1:-help}" in',
-    '  unblock)   shift; cmd_unblock "$@" ;;',
-    '  eligible)  shift; cmd_eligible "$@" ;;',
-    '  stale)     shift; cmd_stale "$@" ;;',
-    '  orphaned)  shift; cmd_orphaned "$@" ;;',
-    '  prs)       shift; cmd_prs "$@" ;;',
-    '  scope)     shift; cmd_scope "$@" ;;',
-    '  tick)      shift; cmd_tick "$@" ;;',
+    '  unblock)     shift; cmd_unblock "$@" ;;',
+    '  eligible)    shift; cmd_eligible "$@" ;;',
+    '  stale)       shift; cmd_stale "$@" ;;',
+    '  orphaned)    shift; cmd_orphaned "$@" ;;',
+    '  maintenance) shift; cmd_maintenance "$@" ;;',
+    '  prs)         shift; cmd_prs "$@" ;;',
+    '  scope)       shift; cmd_scope "$@" ;;',
     "  help|*)",
-    '    echo "Usage: check-blocked.sh <unblock|eligible|stale|orphaned|prs|scope|tick>"',
+    '    echo "Usage: check-blocked.sh <unblock|eligible|stale|orphaned|maintenance|prs|scope>"',
     "    exit 1",
     "    ;;",
     "esac"
@@ -13668,7 +13830,7 @@ function buildCheckBlockedScript(tiers, scopeGate, runRatio) {
 function buildCheckBlockedProcedure(tiers, scopeGate = resolveScopeGate(), runRatio = resolveRunRatio()) {
   return {
     name: "check-blocked.sh",
-    description: "Token-efficient issue triage script with subcommands: eligible, unblock, stale, orphaned, prs, scope, and (deprecated) tick. Sorts eligible issues by priority desc \u2192 funnel tier asc \u2192 issue number asc; the scope subcommand classifies a single issue against the scope-gate thresholds. The tick subcommand is a deprecation no-op retained for one release (the orchestrator no longer maintains a dispatch/housekeeping run counter).",
+    description: "Token-efficient issue triage script with subcommands: eligible, unblock, stale, orphaned, maintenance, prs, scope. Sorts eligible issues by priority desc \u2192 funnel tier asc \u2192 issue number asc; the scope subcommand classifies a single issue against the scope-gate thresholds; the unblock subcommand applies the `status:blocked` \u2192 `status:ready` label flip itself, posts the canned unblock comment, and emits a single `TRIAGE_DONE unblocked=N still_blocked=M` summary line; the maintenance subcommand flags stale issues with `status:needs-attention` (never auto-resets to `status:ready`), counts orphan branches/PRs, and emits a single `MAINTENANCE_DONE flagged_stale=N flagged_blocked=M orphan_branches=A orphan_prs=B needs_attention_total=T` summary line.",
     content: buildCheckBlockedScript(tiers, scopeGate, runRatio)
   };
 }
@@ -13687,6 +13849,59 @@ function buildUnblockDependentsProcedure(unblockDependents = resolveUnblockDepen
 var unblockDependentsProcedure = buildUnblockDependentsProcedure(
   resolveUnblockDependents()
 );
+function buildPrSweepScript() {
+  return [
+    "#!/usr/bin/env bash",
+    "# pr-sweep.sh \u2014 Token-efficient PR-eligibility filter for the",
+    "# orchestrator's Phase B PR review sweep. Emits one summary line",
+    "# per open PR; the orchestrator reads only the PR numbers and",
+    "# dispatches `pr-reviewer` per eligible PR.",
+    "#",
+    "# Skip rules:",
+    "#   - isDraft = true                          \u2192 reason=draft",
+    "#   - review:human-required label             \u2192 reason=human-required",
+    "#   - review:awaiting-human label             \u2192 reason=awaiting-human",
+    "#",
+    "# Usage:",
+    "#   .claude/procedures/pr-sweep.sh",
+    "",
+    "set -uo pipefail",
+    "",
+    "prs=$(gh pr list --state open --json number,isDraft,labels \\",
+    '  --limit 50 2>/dev/null || echo "[]")',
+    "",
+    `count=$(echo "$prs" | jq 'length')`,
+    'if [[ "$count" -eq 0 ]]; then',
+    '  echo "NO_OPEN_PRS"',
+    "  exit 0",
+    "fi",
+    "",
+    "# Emit one PR_ELIGIBLE / PR_SKIP line per open PR, sorted by PR",
+    "# number ascending so the order is deterministic across runs.",
+    `echo "$prs" | jq -r '`,
+    "  sort_by(.number) |",
+    "  .[] |",
+    "  (.labels | map(.name)) as $labels |",
+    "  if .isDraft then",
+    '    "PR_SKIP #\\(.number) reason=draft"',
+    '  elif ($labels | index("review:human-required")) then',
+    '    "PR_SKIP #\\(.number) reason=human-required"',
+    '  elif ($labels | index("review:awaiting-human")) then',
+    '    "PR_SKIP #\\(.number) reason=awaiting-human"',
+    "  else",
+    '    "PR_ELIGIBLE #\\(.number)"',
+    "  end",
+    "'"
+  ].join("\n");
+}
+function buildPrSweepProcedure() {
+  return {
+    name: "pr-sweep.sh",
+    description: "Token-efficient PR-eligibility filter for the orchestrator's Phase B PR review sweep. Emits one `PR_ELIGIBLE #<n>` or `PR_SKIP #<n> reason=<draft|human-required|awaiting-human>` line per open PR; the orchestrator reads only the eligible numbers and dispatches `pr-reviewer` per eligible PR.",
+    content: buildPrSweepScript()
+  };
+}
+var prSweepProcedure = buildPrSweepProcedure();
 var orchestratorSubAgent = {
   name: "orchestrator",
   description: "End-to-end pipeline manager that runs one full cycle every invocation: triage \u2192 maintenance \u2192 queue scan \u2192 delegate the picked issue to the issue-worker \u2192 cleanup",
@@ -13697,13 +13912,16 @@ var orchestratorSubAgent = {
     "# Orchestrator Agent",
     "",
     "You are the pipeline orchestrator for the **{{repository.owner}}/{{repository.name}}** repository.",
-    "Each invocation runs **one full end-to-end cycle**. The cycle triages",
-    "blocked issues, runs maintenance scans, picks the next ready issue, and",
-    "**delegates implementation to the `issue-worker`** sub-agent in scheduled",
-    "mode. The orchestrator itself never implements code, creates branches, or",
-    "pushes commits \u2014 it routes work to other agents. Approved-PR merging is",
-    "owned by the `pr-reviewer` sub-agent (invoked via `/review-pr` /",
-    "`/review-prs`); the orchestrator does not run a merge sweep.",
+    "Each invocation runs **one full end-to-end cycle**. The cycle pulls",
+    "the default branch, sweeps eligible open PRs through the `pr-reviewer`",
+    "sub-agent, triages blocked issues, runs maintenance scans, picks the",
+    "next ready issue, and **delegates implementation to the `issue-worker`**",
+    "sub-agent in scheduled mode. The orchestrator itself never implements",
+    "code, creates branches, pushes commits, or merges PRs \u2014 it routes",
+    "work to other agents. The merge decision is still owned by the",
+    "`pr-reviewer` sub-agent; the orchestrator only chooses which PRs the",
+    "reviewer should look at and dispatches one reviewer session per",
+    "eligible PR.",
     "",
     "Run the phases below in order on every invocation. There is no",
     "dispatch/housekeeping fork \u2014 every phase runs every time.",
@@ -13711,16 +13929,20 @@ var orchestratorSubAgent = {
     "Phase ordering (each runs exactly once per invocation):",
     "",
     "1. **Phase A \u2014 Startup.** Pull the default branch.",
-    "2. **Phase C \u2014 Triage / Unblock.** Flip dependents that have all",
+    "2. **Phase B \u2014 PR Review Sweep.** Read the procedure-script's",
+    "   eligibility summary and dispatch the `pr-reviewer` sub-agent",
+    "   in scheduled mode against each eligible open PR. Failures on",
+    "   one PR never stop the sweep.",
+    "3. **Phase C \u2014 Triage / Unblock.** Flip dependents that have all",
     "   their dependencies closed back to `status:ready`.",
-    "3. **Phase D \u2014 Maintenance.** Stale-issue and orphaned-resource scan",
+    "4. **Phase D \u2014 Maintenance.** Stale-issue and orphaned-resource scan",
     "   plus a needs-attention summary.",
-    "4. **Phase E \u2014 Queue Scan.** Pick the highest-priority `PICK` line",
+    "5. **Phase E \u2014 Queue Scan.** Pick the highest-priority `PICK` line",
     "   and run the scope gate. If the result is `large`, flag and stop.",
-    "5. **Phase G \u2014 Delegate Implementation.** Hand the picked issue off",
+    "6. **Phase G \u2014 Delegate Implementation.** Hand the picked issue off",
     "   to the `issue-worker` sub-agent in scheduled mode. The worker",
     "   handles claim \u2192 branch \u2192 implement \u2192 commit \u2192 PR autonomously.",
-    "6. **Phase F \u2014 Cleanup.** Return to the default branch and log the",
+    "7. **Phase F \u2014 Cleanup.** Return to the default branch and log the",
     "   run summary.",
     "",
     "Phase letters are stable identifiers \u2014 letters skipped in the list",
@@ -13739,76 +13961,160 @@ var orchestratorSubAgent = {
     "git checkout main && git pull origin main",
     "```",
     "",
-    "## Phase C: Triage \u2014 Unblock",
+    "## Phase B: PR Review Sweep",
+    "",
+    "Sweep every open PR through the `pr-reviewer` sub-agent before the",
+    "queue scan so a single `/orchestrate` invocation merges ready PRs",
+    "and dispatches new issue work in one pass.",
     "",
-    "Check for blocked issues whose dependencies have resolved:",
+    "### Step 1 \u2014 read the eligibility summary",
+    "",
+    "Run the bundled `pr-sweep.sh` procedure and read **only** the",
+    "summary lines it emits. Do **not** iterate raw `gh pr list` JSON",
+    "yourself \u2014 the procedure is the single source of PR-eligibility",
+    "metadata, mirroring the discipline of Phase E's bucketed queue scan.",
     "",
     "```bash",
-    ".claude/procedures/check-blocked.sh unblock",
+    ".claude/procedures/pr-sweep.sh",
     "```",
     "",
-    "This phase is the **fallback safety net** for agent-driven",
-    "unblocking. Every agent that applies `status:done` already runs",
-    "`.claude/procedures/unblock-dependents.sh <n>` as part of that",
-    "transition, so in steady state Phase C should usually report",
-    "`NO_BLOCKED_ISSUES` or leave dependents untouched. Phase C still",
-    "runs on every cycle so issues that slipped through \u2014 human",
-    "closures, manual `status:done` edits, or crashes mid-sweep \u2014 get",
-    "picked up within one cycle. See the **Agent-driven",
-    "unblocking** section in `CLAUDE.md` for the per-agent contract.",
+    "Each line follows one of these shapes:",
     "",
-    "For each `UNBLOCK #N` line:",
-    "```bash",
-    'gh issue edit N --remove-label "status:blocked" --add-label "status:ready"',
-    'gh issue comment N --body "Dependencies resolved \u2014 unblocking."',
+    "```",
+    "PR_ELIGIBLE #<n>",
+    "PR_SKIP #<n> reason=draft",
+    "PR_SKIP #<n> reason=human-required",
+    "PR_SKIP #<n> reason=awaiting-human",
     "```",
     "",
-    "For `BLOCKED #N \u2014 no Depends on field found`: leave as-is (Phase D will",
-    "catch it if it's been blocked too long).",
+    "Skip rules (PRs that never reach the reviewer in this sweep):",
     "",
-    "If output is `NO_BLOCKED_ISSUES`, continue to Phase D.",
+    "- `isDraft: true` \u2192 `reason=draft` (the author has not yet asked for review)",
+    "- Carries the `review:human-required` label \u2192 `reason=human-required`",
+    "  (operator override \u2014 the reviewer's auto-merge path is forbidden)",
+    "- Carries the `review:awaiting-human` label \u2192 `reason=awaiting-human`",
+    "  (the reviewer already handed off; a human is the next actor)",
     "",
-    "## Phase D: Maintenance",
+    "If the script emits `NO_OPEN_PRS`, log the empty result and skip",
+    "directly to Phase C.",
     "",
-    "### D1: Stale Detection",
+    "### Step 2 \u2014 dispatch the reviewer per eligible PR",
     "",
-    "```bash",
-    ".claude/procedures/check-blocked.sh stale",
-    "```",
+    "For each `PR_ELIGIBLE #<n>` line in the order the procedure",
+    "emitted them, invoke the `pr-reviewer` sub-agent **in scheduled",
+    "mode** with the brief below. Substitute `<n>` with the PR number",
+    "from the line.",
+    "",
+    "> `scheduled mode`: review PR #<n>. Run the full review pipeline",
+    "> (eligibility, AC checklist, CI status, policy decision, sticky",
+    "> reviewer-notes update) and either enable squash auto-merge or",
+    "> apply `review:awaiting-human`. Do not pause for approval.",
+    "> Return a one-line summary as the final line of your response in",
+    "> the form `REVIEWER_DONE pr:#<n> outcome:<merged|awaiting-human|commented>`",
+    "> on success or `REVIEWER_FAILED pr:#<n> reason:<short>` on failure.",
+    "",
+    "The orchestrator does **not** call `gh pr merge`, apply review",
+    "labels, or post review comments directly \u2014 the reviewer's existing",
+    "logic owns merge dispatch, AC verification, and the sticky",
+    "`## Reviewer notes` comment. Phase B is a thin invoker, not an",
+    "absorber.",
+    "",
+    "### Step 3 \u2014 failure semantics",
+    "",
+    "A single PR's reviewer failure (missing or malformed",
+    "`REVIEWER_*` final line, sub-agent error, CI flake) **never stops",
+    "the sweep**. Log the failure as",
+    "`REVIEWER_FAILED pr:#<n> reason:<observed>` and continue to the",
+    "next eligible PR. The next orchestrator invocation re-scans the",
+    "PR list and re-dispatches the reviewer if the PR is still",
+    "eligible.",
+    "",
+    "After every eligible PR has been processed (or zero eligible PRs",
+    "were emitted), continue to Phase C regardless of outcomes.",
+    "",
+    "## Phase C: Triage \u2014 Unblock",
+    "",
+    "Run the bundled `check-blocked.sh unblock` procedure and read",
+    "**only** the final `TRIAGE_DONE` summary line it emits. The",
+    "procedure applies the label flips (`status:blocked` \u2192",
+    "`status:ready`) and posts the canned",
+    "`Dependencies resolved \u2014 unblocking.` comment itself, mirroring",
+    "the discipline of Phase B (`pr-sweep.sh`) and Phase E",
+    "(`check-blocked.sh eligible`) \u2014 the orchestrator never iterates",
+    "raw `gh` responses, only the procedure's summary lines.",
     "",
-    "For each `STALE #N` line (in-progress >72h without activity):",
     "```bash",
-    'gh issue edit N --add-label "status:needs-attention"',
-    'gh issue comment N --body "Flagged: in-progress for >3 days with no activity."',
+    ".claude/procedures/check-blocked.sh unblock",
     "```",
     "",
-    "For each `STALE_BLOCKED #N` line (blocked >168h):",
-    "```bash",
-    'gh issue edit N --add-label "status:needs-attention"',
-    'gh issue comment N --body "Flagged: blocked for >7 days \u2014 may need human intervention."',
+    "The script emits one summary line in this shape:",
+    "",
+    "```",
+    "TRIAGE_DONE unblocked=<N> still_blocked=<M>",
     "```",
     "",
-    "**Important:** Do NOT auto-reset stale issues to `status:ready` \u2014 partial",
-    "implementation work may exist on a branch.",
+    "Per-issue informational lines (`UNBLOCKED #N`, `UNBLOCK_FAILED #N`,",
+    "`STILL_BLOCKED #N`, `BLOCKED #N \u2014 no Depends on field found`) are",
+    "emitted for log visibility but are **not** load-bearing for the",
+    "orchestrator \u2014 partial failures (one bad `gh` call) do not abort",
+    "the sweep, they are simply counted toward `still_blocked`.",
+    "",
+    "This phase is the **fallback safety net** for agent-driven",
+    "unblocking. Every agent that applies `status:done` already runs",
+    "`.claude/procedures/unblock-dependents.sh <n>` as part of that",
+    "transition, so in steady state Phase C should usually report",
+    "`TRIAGE_DONE unblocked=0 still_blocked=0` or leave dependents",
+    "untouched. Phase C still runs on every cycle so issues that",
+    "slipped through \u2014 human closures, manual `status:done` edits, or",
+    "crashes mid-sweep \u2014 get picked up within one cycle. See the",
+    "**Agent-driven unblocking** section in `CLAUDE.md` for the",
+    "per-agent contract.",
+    "",
+    "Log the summary line and continue to Phase D regardless of",
+    "outcomes \u2014 a non-zero `still_blocked` count is normal (issues",
+    "with open dependencies stay blocked) and Phase D will surface",
+    "any that have been blocked too long.",
     "",
-    "### D2: Orphaned Detection",
+    "## Phase D: Maintenance",
+    "",
+    "Run the bundled `check-blocked.sh maintenance` procedure and read",
+    "**only** the final `MAINTENANCE_DONE` summary line it emits. The",
+    "procedure folds the stale-detection, orphan-detection, and",
+    "needs-attention summary that earlier revisions split across D1,",
+    "D2, and D3 into a single sweep \u2014 applying the",
+    "`status:needs-attention` label and posting the canned flag comment",
+    "for each stale / stale-blocked issue itself, mirroring the",
+    "discipline of Phase B (`pr-sweep.sh`) and Phase C",
+    "(`check-blocked.sh unblock`).",
     "",
     "```bash",
-    ".claude/procedures/check-blocked.sh orphaned",
+    ".claude/procedures/check-blocked.sh maintenance",
     "```",
     "",
-    "Report any `ORPHAN_BRANCH` or `ORPHAN_PR` lines. These indicate branches",
-    "or PRs whose linked issues are closed or missing. Log them for visibility",
-    "but do not delete branches automatically.",
-    "",
-    "### D3: Needs-Attention Summary",
+    "The script emits one summary line in this shape:",
     "",
-    "List all issues currently flagged:",
-    "```bash",
-    'gh issue list --label "status:needs-attention" --state open --json number,title',
+    "```",
+    "MAINTENANCE_DONE flagged_stale=<N> flagged_blocked=<M> orphan_branches=<A> orphan_prs=<B> needs_attention_total=<T>",
     "```",
     "",
-    "Log the count and titles for operator visibility.",
+    "Per-issue / per-orphan informational lines (`FLAGGED_STALE #N`,",
+    "`FLAGGED_BLOCKED #N`, `STALE #N \u2014 \u2026`, `STALE_BLOCKED #N \u2014 \u2026`,",
+    "`ORPHAN_BRANCH \u2026`, `ORPHAN_PR #N \u2014 \u2026`, `FLAG_FAILED #N \u2014 \u2026`) are",
+    "emitted for log visibility but are **not** load-bearing for the",
+    "orchestrator \u2014 partial failures (one bad `gh` call) do not abort",
+    "the sweep, they are simply omitted from the `flagged_*` counters.",
+    "",
+    "**Important:** the script never auto-resets stale issues to",
+    "`status:ready`. It only adds `status:needs-attention`; the",
+    "existing `status:in-progress` or `status:blocked` label stays in",
+    "place so partial implementation work on a branch remains visible",
+    "to humans. Orphan branches and PRs are surfaced in the counters",
+    "but are never deleted by the orchestrator \u2014 a human reviews the",
+    "log lines and prunes orphans manually.",
+    "",
+    "Log the summary line and continue to Phase E regardless of",
+    "outcomes \u2014 a non-zero `flagged_*` or `orphan_*` count is",
+    "informational, not a failure.",
     "",
     "## Phase E: Queue Scan",
     "",
@@ -13968,27 +14274,30 @@ var orchestratorSubAgent = {
     "",
     "1. **Never implement code.** You triage, scan, and delegate \u2014 you do not code.",
     "2. **Never claim issues.** Do not add `status:in-progress` or create branches for issues. Phase G's `issue-worker` delegation is the only path that flips an issue's claim labels.",
-    "3. **Never merge PRs.** Approved-PR merging is owned by the `pr-reviewer` sub-agent (invoked via `/review-pr` / `/review-prs`). The orchestrator does not run a merge sweep, does not call `gh pr merge`, and does not enable auto-merge.",
-    "4. **Always use check-blocked.sh.** All triage queries go through the shell script for token efficiency.",
-    "5. **Follow CLAUDE.md conventions** for all git and gh operations.",
-    "6. **Priority order:** critical > high > medium > low > trivial, then **funnel tier asc** (lower tier wins ties), then FIFO by issue number.",
-    "7. **Never dispatch a `large` issue.** Always run the scope check",
+    "3. **Always use procedure scripts.** Issue triage queries go through `.claude/procedures/check-blocked.sh`; PR-eligibility filtering goes through `.claude/procedures/pr-sweep.sh`. Never iterate raw `gh issue list` / `gh pr list` JSON in-context.",
+    "4. **Follow CLAUDE.md conventions** for all git and gh operations.",
+    "5. **Priority order:** critical > high > medium > low > trivial, then **funnel tier asc** (lower tier wins ties), then FIFO by issue number.",
+    "6. **Never dispatch a `large` issue.** Always run the scope check",
     "   on the top `PICK` line before reporting `NEXT_WORK_ITEM`. A",
     "   `large` issue must be flagged with `status:needs-attention` and",
     "   handed a decomposition proposal \u2014 never claimed, never branched,",
     "   never delegated to the `issue-worker`.",
-    "8. **Sweep dependents whenever you apply `status:done`.** Every",
+    "7. **Sweep dependents whenever you apply `status:done`.** Every",
     "   `status:done` transition must be immediately followed by",
     "   `.claude/procedures/unblock-dependents.sh <n>` so downstream",
     "   `Depends on: #<n>` issues flip to `status:ready` without",
     "   waiting for the next cycle. See the **Agent-driven unblocking**",
     "   section in `CLAUDE.md` for the contract.",
-    "9. **Always invoke `issue-worker` in scheduled mode.** Phase G's",
-    "   delegation prompt must contain the literal phrase",
-    "   `scheduled mode` so the worker skips its interactive approval",
-    "   pause and runs the implementation cycle autonomously. Without",
-    "   the phrase the worker pauses for human approval and the",
-    "   delegation stalls."
+    "8. **Always invoke child sub-agents in scheduled mode.** Phase B's",
+    "   `pr-reviewer` dispatch and Phase G's `issue-worker` delegation",
+    "   prompts must each contain the literal phrase `scheduled mode`",
+    "   so the child sub-agent skips its interactive approval pause and",
+    "   runs autonomously. Without the phrase the child pauses for",
+    "   human approval and the delegation stalls.",
+    "9. **A failed reviewer never stops the sweep.** Phase B continues",
+    "   to the next eligible PR after a `REVIEWER_FAILED` line and",
+    "   proceeds to Phase C regardless of how many PRs failed. Do not",
+    "   abort the cycle on a single PR's reviewer failure."
   ].join("\n")
 };
 var issueWorkerSubAgent = {
@@ -14463,9 +14772,9 @@ var ORCHESTRATOR_CONVENTIONS_PREAMBLE = [
   "",
   "When running the orchestrator agent (`.claude/agents/orchestrator.md`):",
   "",
-  "- The orchestrator runs **one full end-to-end cycle every invocation**: triage / unblock \u2192 maintenance \u2192 queue scan \u2192 delegate to `issue-worker` \u2192 cleanup",
-  "- The orchestrator **never** implements code, creates branches, pushes commits, **or merges PRs** \u2014 it triages issues, picks the next work item, and delegates implementation to other sub-agents. Approved-PR merging is owned by the `pr-reviewer` sub-agent (invoked via `/review-pr` / `/review-prs`).",
-  "- All triage queries use `.claude/procedures/check-blocked.sh` for token efficiency",
+  "- The orchestrator runs **one full end-to-end cycle every invocation**: startup \u2192 PR review sweep \u2192 triage / unblock \u2192 maintenance \u2192 queue scan \u2192 delegate to `issue-worker` \u2192 cleanup",
+  "- The orchestrator **never** implements code, creates branches, or pushes commits \u2014 it routes work to other sub-agents. The merge decision is still owned by the `pr-reviewer` sub-agent; Phase B only chooses which open PRs the reviewer should look at and dispatches one reviewer session per eligible PR (skipping drafts and any PR carrying `review:human-required` or `review:awaiting-human`).",
+  "- All triage queries use `.claude/procedures/check-blocked.sh` for token efficiency. PR-eligibility filtering for Phase B uses `.claude/procedures/pr-sweep.sh`, which emits `PR_ELIGIBLE` / `PR_SKIP` lines so the orchestrator never iterates raw `gh pr list` JSON.",
   "- The queue scan reads only `priority:*` and `status:*` labels \u2014 type-routing (which typed agent handles a given `type:*` label) is the `issue-worker`'s concern, not the orchestrator's. The orchestrator's funnel-tier sort is a tie-breaker on `priority:*`, not a routing decision.",
   "- Priority order: critical > high > medium > low > trivial, then **funnel tier asc** (lower tier wins ties), then FIFO by issue number. Phase E's queue scan walks each priority bucket in turn (one `gh issue list` call per bucket, **capped at 50 issues per bucket**) and short-circuits on the first bucket whose survivors clear the `Depends on:` filter, so every higher-priority issue is visible even when the global ready backlog is much larger than 50.",
   "- Stale thresholds: 72h for in-progress, 168h for blocked",
@@ -14473,11 +14782,11 @@ var ORCHESTRATOR_CONVENTIONS_PREAMBLE = [
   "",
   "## Depth-0 invocation requirement",
   "",
-  'The orchestrator agent **must run as the top-level (depth-0) session** when its Phase G needs to delegate work to the `issue-worker` sub-agent. The Claude Code harness forbids nested sub-agent spawning \u2014 *"Subagents cannot spawn other subagents. If your workflow requires nested delegation, use Skills or chain subagents from the main conversation."* (see <https://code.claude.com/docs/en/sub-agents>). If the orchestrator itself were spawned as a depth-1 sub-agent (e.g. via `Agent(subagent_type: "orchestrator")` from another session), the `Agent` tool needed to reach the `issue-worker` at depth-2 would not be available and Phase G would silently abort.',
+  'The orchestrator agent **must run as the top-level (depth-0) session** because both Phase B (PR review sweep) and Phase G (issue delegation) need to spawn child sub-agents. Phase B dispatches the `pr-reviewer` sub-agent once per eligible open PR; Phase G dispatches the `issue-worker` sub-agent against the picked issue. The Claude Code harness forbids nested sub-agent spawning \u2014 *"Subagents cannot spawn other subagents. If your workflow requires nested delegation, use Skills or chain subagents from the main conversation."* (see <https://code.claude.com/docs/en/sub-agents>). If the orchestrator itself were spawned as a depth-1 sub-agent (e.g. via `Agent(subagent_type: "orchestrator")` from another session), the `Agent` tool needed to reach `pr-reviewer` and `issue-worker` at depth-2 would not be available and both Phase B and Phase G would silently abort.',
   "",
-  'Practical implication for scheduled-task wiring: the `worker-orchestrator` scheduled task\'s `SKILL.md` instructs the **scheduled-task session itself** to read `.claude/agents/orchestrator.md` and execute its phase pipeline in-session, then use the `Agent` tool to delegate the picked work item to `issue-worker` (depth-1). The scheduled task does **not** call `Agent(subagent_type: "orchestrator")` \u2014 that would put the orchestrator at depth-1 and break the chain.'
+  'Practical implication for scheduled-task wiring: the `worker-orchestrator` scheduled task\'s `SKILL.md` instructs the **scheduled-task session itself** to read `.claude/agents/orchestrator.md` and execute its phase pipeline in-session, then use the `Agent` tool to delegate to `pr-reviewer` (Phase B) and `issue-worker` (Phase G) at depth-1. The scheduled task does **not** call `Agent(subagent_type: "orchestrator")` \u2014 that would put the orchestrator at depth-1 and break both delegation chains.'
 ].join("\n");
-function buildOrchestratorConventionsContent(tiers, scopeGate = resolveScopeGate(), runRatio = resolveRunRatio(), scheduledTasks = resolveScheduledTasks(), unblockDependents = resolveUnblockDependents(), excludeBundles = []) {
+function buildOrchestratorConventionsContent(tiers, scopeGate = resolveScopeGate(), _runRatio = resolveRunRatio(), scheduledTasks = resolveScheduledTasks(), unblockDependents = resolveUnblockDependents(), excludeBundles = []) {
   return [
     ORCHESTRATOR_CONVENTIONS_PREAMBLE,
     "",
@@ -14485,8 +14794,6 @@ function buildOrchestratorConventionsContent(tiers, scopeGate = resolveScopeGate
     "",
     renderScopeGateSection(scopeGate, excludeBundles),
     "",
-    renderRunRatioSection(runRatio),
-    "",
     renderScheduledTasksSection(scheduledTasks),
     "",
     renderUnblockDependentsSection(unblockDependents)
@@ -14523,6 +14830,74 @@ function resolveOrchestratorAssets(tierConfig, scopeGateConfig, runRatioConfig,
     )
   };
 }
+var orchestrateCommand = {
+  name: "orchestrate",
+  description: "Run one full orchestrator cycle: triage, queue scan, delegate to issue-worker.",
+  content: [
+    "# Orchestrate",
+    "",
+    "Invoke the `orchestrator` sub-agent and run **one full end-to-end",
+    "cycle**: triage / unblock \u2192 maintenance \u2192 queue scan \u2192 delegate the",
+    "picked issue to the `issue-worker` sub-agent \u2192 cleanup.",
+    "",
+    "Follow the contract in `.claude/agents/orchestrator.md`. Do **not**",
+    "implement code, create branches, push commits, or merge PRs \u2014 those",
+    "are the worker's and `pr-reviewer`'s jobs respectively.",
+    "",
+    "Run as a depth-0 (top-level) session so the orchestrator can spawn",
+    "the `issue-worker` sub-agent at depth-1 \u2014 Claude Code forbids nested",
+    "sub-agent dispatch.",
+    ""
+  ].join("\n")
+};
+var checkBlockedCommand = {
+  name: "check-blocked",
+  description: "Run .claude/procedures/check-blocked.sh and summarise the unblock candidates.",
+  content: [
+    "# Check Blocked",
+    "",
+    "Run the bundled triage helper and report what it found:",
+    "",
+    "```bash",
+    'bash .claude/procedures/check-blocked.sh "$@"',
+    "```",
+    "",
+    "Pass any extra arguments through verbatim. The `unblock` subcommand",
+    "walks every `status:blocked` issue, re-checks each `Depends on:`",
+    "reference, applies the `status:blocked` \u2192 `status:ready` label flip",
+    "itself, posts the canned `Dependencies resolved \u2014 unblocking.`",
+    "comment, and emits a single",
+    "`TRIAGE_DONE unblocked=<N> still_blocked=<M>` summary line. Per-issue",
+    "informational lines (`UNBLOCKED`, `UNBLOCK_FAILED`, `STILL_BLOCKED`)",
+    "are also emitted for log visibility.",
+    "",
+    "Summarise the output (the `TRIAGE_DONE` counts and the first few",
+    "per-issue lines) \u2014 do **not** apply additional label flips yourself;",
+    "the script already transitioned every eligible issue.",
+    ""
+  ].join("\n")
+};
+var scanCommand = {
+  name: "scan",
+  description: "Run the orchestrator queue scan only and report the next ready issue without dispatching.",
+  content: [
+    "# Scan",
+    "",
+    "Run the orchestrator's **queue scan only** (Phase E of the contract",
+    "in `.claude/agents/orchestrator.md`) and print the next ready issue,",
+    "the funnel-tier sort that put it on top, and the scope-gate result.",
+    "",
+    "Do **not** claim the issue, create a branch, or delegate to",
+    "`issue-worker`. This command exists for proactive review of what",
+    "the next `/orchestrate` invocation would pick up.",
+    "",
+    "Walk each `priority:*` bucket in turn (capped at 50 per bucket),",
+    "filter `Depends on:` references, and short-circuit on the first",
+    "bucket whose survivors clear the filter. Report the top candidate",
+    "and the number of survivors per bucket.",
+    ""
+  ].join("\n")
+};
 var orchestratorBundle = {
   name: "orchestrator",
   description: "Pipeline orchestrator agent for issue triage, PR review, and queue management",
@@ -14548,7 +14923,12 @@ var orchestratorBundle = {
     }
   ],
   subAgents: [orchestratorSubAgent, issueWorkerSubAgent],
-  procedures: [checkBlockedProcedure, unblockDependentsProcedure],
+  procedures: [
+    checkBlockedProcedure,
+    unblockDependentsProcedure,
+    prSweepProcedure
+  ],
+  commands: [orchestrateCommand, checkBlockedCommand, scanCommand],
   claudePermissions: {
     allow: [
       // Allow executing the check-blocked.sh procedure
@@ -14558,11 +14938,11 @@ var orchestratorBundle = {
 };
 
 // src/agent/bundles/people-profile.ts
-function buildPeopleProfileAnalystSubAgent(paths, issueDefaults) {
+function buildPeopleProfileAnalystSubAgent(paths, issueDefaults, tier) {
   return {
     name: "people-profile-analyst",
     description: "Researches an individual person (colleague, customer contact, vendor contact, partner contact, industry expert, or connector) from public sources and produces a structured markdown profile cross-linked to companies, software, and meeting notes, then enqueues downstream `company:research` and `software:research` issues for unprofiled companies and software products surfaced during profiling. Also handles maintenance refreshes on a configurable staleness cadence (`people:refresh`). One person per session, tracked by people:* GitHub issue labels.",
-    model: AGENT_MODEL.POWERFUL,
+    model: tier,
     maxTurns: 80,
     platforms: { cursor: { exclude: true } },
     prompt: [
@@ -15392,7 +15772,7 @@ function buildRefreshPersonSkill(paths, issueDefaults) {
     ].join("\n")
   };
 }
-function buildPeopleProfileBundle(paths = DEFAULT_AGENT_PATHS, issueDefaults = DEFAULT_RESOLVED_ISSUE_DEFAULTS) {
+function buildPeopleProfileBundle(paths = DEFAULT_AGENT_PATHS, issueDefaults = DEFAULT_RESOLVED_ISSUE_DEFAULTS, tier = AGENT_MODEL.BALANCED) {
   return {
     name: "people-profile",
     description: "People research and profiling pipeline: research, draft profile, followup, refresh. Enabled by default; domain-neutral; filesystem-durable between phases. Cross-references existing companies, software, and meeting notes, and Phase 3 (Followup) hands unprofiled, genuinely-relevant companies and software products off to the `company-profile` and `software-profile` bundles via `company:research` and `software:research` issues. Phase 4 (Refresh) re-verifies profiles on a configurable staleness cadence.",
@@ -15440,7 +15820,7 @@ function buildPeopleProfileBundle(paths = DEFAULT_AGENT_PATHS, issueDefaults = D
       buildProfilePersonSkill(paths, issueDefaults),
       buildRefreshPersonSkill(paths, issueDefaults)
     ],
-    subAgents: [buildPeopleProfileAnalystSubAgent(paths, issueDefaults)],
+    subAgents: [buildPeopleProfileAnalystSubAgent(paths, issueDefaults, tier)],
     labels: [
       {
         name: "type:people-profile",
@@ -17015,7 +17395,19 @@ var prReviewBundle = {
         "to a PR's branch \u2014 it only reviews, decides, and orchestrates merge",
         "or comment. In loop mode, a failed review for one PR never stops",
         "the loop; the reviewer comments and moves on. See the `pr-reviewer`",
-        "agent definition for the full phase-by-phase contract.",
+        "agent definition for the full phase-by-phase contract."
+      ].join("\n"),
+      platforms: {
+        cursor: { exclude: true }
+      },
+      tags: ["workflow"]
+    },
+    {
+      name: "pr-review-feedback-protocol",
+      description: "Documents the human-in-the-loop feedback loop on PR review: reaction state machine, pushback resolution, fix-list comment format, sticky reviewer-notes comment, label glossary, and human-author opt-in flag.",
+      scope: AGENT_RULE_SCOPE.ALWAYS,
+      content: [
+        "# PR Review Feedback Protocol",
         "",
         "## Human-in-the-Loop Feedback Protocol",
         "",
@@ -23799,11 +24191,11 @@ var slackBundle = {
 };
 
 // src/agent/bundles/software-profile.ts
-function buildSoftwareProfileAnalystSubAgent(paths, issueDefaults) {
+function buildSoftwareProfileAnalystSubAgent(paths, issueDefaults, tier) {
   return {
     name: "software-profile-analyst",
     description: "Researches a software product (competitor, adjacent, incumbent, enabler, infrastructure, or ecosystem-tool) from public sources, produces a structured markdown profile, contributes rows to a shared feature matrix ranked against configurable segment-importance weights, maps features back to the BCM capability model and flags unmapped features, then enqueues downstream `bcm:outline`, `company:research`, and `people:research` issues for new sub-capabilities, the vendor company, and primary-attribution founders/leaders surfaced during profiling. One product per session, tracked by software:* GitHub issue labels.",
-    model: AGENT_MODEL.POWERFUL,
+    model: tier,
     maxTurns: 80,
     platforms: { cursor: { exclude: true } },
     prompt: [
@@ -24738,7 +25130,7 @@ function buildMapSoftwareSkill(paths, issueDefaults) {
     ].join("\n")
   };
 }
-function buildSoftwareProfileBundle(paths = DEFAULT_AGENT_PATHS, issueDefaults = DEFAULT_RESOLVED_ISSUE_DEFAULTS) {
+function buildSoftwareProfileBundle(paths = DEFAULT_AGENT_PATHS, issueDefaults = DEFAULT_RESOLVED_ISSUE_DEFAULTS, tier = AGENT_MODEL.BALANCED) {
   return {
     name: "software-profile",
     description: "Software research, profiling, feature-matrix, and capability-mapping pipeline: research, profile, matrix, map, followup. Enabled by default; domain-neutral; filesystem-durable between phases; ranks features against configurable segment-importance weights and maps features back to the BCM capability model. Phase 4 (Map) hands unmapped features off to the `bcm-writer` bundle via `bcm:outline` issues. Phase 5 (Followup) hands the vendor company and primary-attribution founders/leaders off to the `company-profile` and `people-profile` bundles via `company:research` and `people:research` issues.",
@@ -24795,7 +25187,9 @@ function buildSoftwareProfileBundle(paths = DEFAULT_AGENT_PATHS, issueDefaults =
       buildProfileSoftwareSkill(paths, issueDefaults),
       buildMapSoftwareSkill(paths, issueDefaults)
     ],
-    subAgents: [buildSoftwareProfileAnalystSubAgent(paths, issueDefaults)],
+    subAgents: [
+      buildSoftwareProfileAnalystSubAgent(paths, issueDefaults, tier)
+    ],
     labels: [
       {
         name: "type:software-profile",
@@ -27029,6 +27423,211 @@ var vitestBundle = {
   }
 };
 
+// src/agent/bundles/agent-registry.ts
+var AGENT_REGISTRY_ENTRIES = [
+  {
+    bundle: "agenda",
+    skill: "/draft-agenda",
+    agent: "agenda-analyst",
+    resolveOutputPath: (p) => `${p.meetingsRoot}/`,
+    purpose: "Pre-meeting agenda authoring (2-phase: draft, finalize). Reuses the project's meeting-type taxonomy.",
+    workflowRuleName: "meeting-agenda-workflow"
+  },
+  {
+    bundle: "bcm-writer",
+    skill: "/write-bcm",
+    agent: "bcm-writer",
+    resolveOutputPath: (p) => `${p.bcmRoot}/`,
+    purpose: "BCM capability-model documents (4-phase: outline, scaffold, context, connect). BIZBOK-aligned.",
+    workflowRuleName: "bcm-writer-workflow"
+  },
+  {
+    bundle: "business-models",
+    skill: "/scan-business-models",
+    agent: "business-models-analyst",
+    resolveOutputPath: (p) => `${p.docsRoot}/industry-research/`,
+    purpose: "Osterwalder business-model canvases per industry segment (3-phase: scan, canvas, complete).",
+    workflowRuleName: "business-models-workflow"
+  },
+  {
+    bundle: "company-profile",
+    skill: "/profile-company",
+    agent: "company-profile-analyst",
+    resolveOutputPath: (p) => `${p.companiesRoot}/`,
+    purpose: "Company profiles, notes, and segment competitive analyses (up to 6 phases incl. refresh).",
+    workflowRuleName: "company-profile-workflow"
+  },
+  {
+    bundle: "customer-profile",
+    skill: "/discover-customers",
+    agent: "customer-profile-analyst",
+    resolveOutputPath: (p) => `${p.profilesRoot}/customers/`,
+    purpose: "Customer-archetype discovery, profiles, and competitor feature-mapping (3-phase).",
+    workflowRuleName: "customer-profile-workflow"
+  },
+  {
+    bundle: "docs-sync",
+    skill: "/docs-sync-pr",
+    agent: "docs-sync",
+    resolveOutputPath: (p) => `${p.docsRoot}/`,
+    purpose: "Pre-PR drift detection and mechanical doc fixes (2-phase: scan, fix). Skeleton release.",
+    workflowRuleName: "docs-sync-workflow"
+  },
+  {
+    bundle: "industry-discovery",
+    skill: "/discover-industries",
+    agent: "industry-discovery-analyst",
+    resolveOutputPath: (p) => `${p.industriesRoot}/`,
+    purpose: "Industry-vertical discovery, fit-evaluation, and research planning (3-phase).",
+    workflowRuleName: "industry-discovery-workflow"
+  },
+  {
+    bundle: "maintenance-audit",
+    skill: "/audit-docs",
+    agent: "maintenance-audit",
+    resolveOutputPath: (p) => `${p.docsRoot}/`,
+    purpose: "Doc-registry audits with idempotent fixes (3-phase: scan, fix, verify). No new content.",
+    workflowRuleName: "maintenance-audit-workflow"
+  },
+  {
+    bundle: "meeting-analysis",
+    skill: "/process-meeting",
+    agent: "meeting-analyst",
+    resolveOutputPath: (p) => `${p.meetingsRoot}/`,
+    purpose: "Post-meeting transcript processing (4-phase: extract, notes, draft, link).",
+    workflowRuleName: "meeting-processing-workflow"
+  },
+  {
+    bundle: "people-profile",
+    skill: "/profile-person",
+    agent: "people-profile-analyst",
+    resolveOutputPath: (p) => `${p.peopleRoot}/`,
+    purpose: "Person profiles only (up to 4 phases incl. refresh). Hands off to company/software bundles.",
+    workflowRuleName: "people-profile-workflow"
+  },
+  {
+    bundle: "pr-review",
+    skill: "/review-pr",
+    agent: "pr-reviewer",
+    resolveOutputPath: () => "",
+    purpose: "PR review, auto-merge gating, and human-in-the-loop feedback orchestration.",
+    workflowRuleName: "pr-review-workflow"
+  },
+  {
+    bundle: "regulatory-research",
+    skill: "/scan-regulatory-landscape",
+    agent: "regulatory-research-analyst",
+    resolveOutputPath: (p) => `${p.docsRoot}/regulations/`,
+    purpose: "Regulation research, version pages, and impact analysis (3-phase). Documents, never interprets.",
+    workflowRuleName: "regulatory-research-workflow"
+  },
+  {
+    bundle: "requirements-analyst",
+    skill: "/scan-requirements",
+    agent: "requirements-analyst",
+    resolveOutputPath: (p) => `${p.researchRequirementsRoot}/`,
+    purpose: "Requirements gap discovery + draft proposals (2-phase: scan, draft-trace). Hands off to writer.",
+    workflowRuleName: "requirements-analyst-workflow"
+  },
+  {
+    bundle: "requirements-reviewer",
+    skill: "/review-requirements",
+    agent: "requirements-reviewer",
+    resolveOutputPath: (p) => `${p.requirementsRoot}/`,
+    purpose: "Requirements audit (12 checks) and narrow-edit deprecation. Never authors new requirement docs.",
+    workflowRuleName: "requirements-reviewer-workflow"
+  },
+  {
+    bundle: "requirements-writer",
+    skill: "/write-requirement",
+    agent: "requirements-writer",
+    resolveOutputPath: (p) => `${p.requirementsRoot}/`,
+    purpose: "Formal requirement document authoring across the 11-category taxonomy + four-tier classification.",
+    workflowRuleName: "requirements-writer-workflow"
+  },
+  {
+    bundle: "research-pipeline",
+    skill: "/research",
+    agent: "research-analyst",
+    resolveOutputPath: (p) => `${p.researchRoot}/`,
+    purpose: "Generic research micro-tasks (3-phase: scope, slice, verify). Notes-only output.",
+    workflowRuleName: "research-pipeline-workflow"
+  },
+  {
+    bundle: "software-profile",
+    skill: "/profile-software",
+    agent: "software-profile-analyst",
+    resolveOutputPath: (p) => `${p.softwareRoot}/`,
+    purpose: "Software profiles, shared feature matrix, and BCM-tree capability mapping (up to 5 phases).",
+    workflowRuleName: "software-profile-workflow"
+  },
+  {
+    bundle: "standards-research",
+    skill: "/scope-standards-research",
+    agent: "standards-research-analyst",
+    resolveOutputPath: (p) => `${p.docsRoot}/standards/`,
+    purpose: "Interoperability standards research (5-phase: scope, research, compare, extension, organizations).",
+    workflowRuleName: "standards-research-workflow"
+  }
+];
+var SUPPRESSED_WORKFLOW_RULE_NAMES = AGENT_REGISTRY_ENTRIES.map((e) => e.workflowRuleName);
+function isSuppressedWorkflowRule(name) {
+  return SUPPRESSED_WORKFLOW_RULE_NAMES.includes(name);
+}
+function bundleNameForWorkflowRule(ruleName) {
+  const entry = AGENT_REGISTRY_ENTRIES.find(
+    (e) => e.workflowRuleName === ruleName
+  );
+  return entry?.bundle;
+}
+function buildAgentRegistryRule(bundles, paths) {
+  const activeNames = new Set(bundles.map((b) => b.name));
+  const rows = AGENT_REGISTRY_ENTRIES.filter(
+    (e) => activeNames.has(e.bundle)
+  ).slice();
+  if (rows.length === 0) {
+    return void 0;
+  }
+  rows.sort((a, b) => a.bundle.localeCompare(b.bundle));
+  const lines = [
+    "# Agent Registry",
+    "",
+    "Each row below is the routing summary for one phased-agent",
+    "bundle: the user-invocable skill, the sub-agent that handles",
+    "the work, the output path the agent writes to, and a one-line",
+    "purpose. Use the table to answer *which agent handles X* \u2014",
+    "full agent prompts live in `.claude/agents/<name>.md` and only",
+    "load on delegation, so the table is the always-on routing",
+    "signal.",
+    "",
+    "Cross-cutting policies that apply to every agent below \u2014",
+    "Progress File Convention, Shared-Editing Safety, Issue",
+    "Templates, Skill Evals \u2014 are documented as their own top-level",
+    "sections elsewhere in this file. The registry only captures",
+    "routing; it does not duplicate convention prose.",
+    "",
+    "| Skill | Agent | Bundle | Output path | Purpose |",
+    "| --- | --- | --- | --- | --- |"
+  ];
+  for (const row of rows) {
+    const outputPath = row.resolveOutputPath(paths);
+    const pathCell = outputPath.length > 0 ? `\`${outputPath}\`` : "\u2014";
+    lines.push(
+      `| \`${row.skill}\` | \`${row.agent}\` | \`${row.bundle}\` | ${pathCell} | ${row.purpose} |`
+    );
+  }
+  return {
+    name: "agent-registry",
+    description: "Routing table mapping each phased-agent bundle to its primary skill, sub-agent, output path, and one-line purpose. Replaces the per-bundle workflow rules whose prose summaries duplicated the routing signal.",
+    scope: AGENT_RULE_SCOPE.ALWAYS,
+    content: lines.join("\n"),
+    platforms: {
+      cursor: { exclude: true }
+    },
+    tags: ["workflow"]
+  };
+}
+
 // src/agent/bundles/features.ts
 var SOURCE_TIER_HEADINGS = [
   { key: "t1", heading: "### T1 \u2014 Primary Living" },
@@ -27396,7 +27995,8 @@ function renderPriorityRulesSection(rules) {
 }
 
 // src/agent/bundles/index.ts
-function buildBuiltInBundles(paths = DEFAULT_AGENT_PATHS, issueDefaults = DEFAULT_RESOLVED_ISSUE_DEFAULTS) {
+function buildBuiltInBundles(paths = DEFAULT_AGENT_PATHS, issueDefaults = DEFAULT_RESOLVED_ISSUE_DEFAULTS, defaultAgentTier = AGENT_MODEL.BALANCED, bundleAgentTiers = /* @__PURE__ */ new Map()) {
+  const tierFor = (bundle) => bundleAgentTiers.get(bundle) ?? defaultAgentTier;
   return [
     buildBaseBundle(paths),
     upstreamConfigulatorDocsBundle,
@@ -27409,7 +28009,7 @@ function buildBuiltInBundles(paths = DEFAULT_AGENT_PATHS, issueDefaults = DEFAUL
     projenBundle,
     githubWorkflowBundle,
     slackBundle,
-    meetingAnalysisBundle,
+    buildMeetingAnalysisBundle(tierFor("meeting-analysis")),
     agendaBundle,
     orchestratorBundle,
     prReviewBundle,
@@ -27417,16 +28017,28 @@ function buildBuiltInBundles(paths = DEFAULT_AGENT_PATHS, issueDefaults = DEFAUL
     buildRequirementsWriterBundle(paths, issueDefaults),
     buildRequirementsReviewerBundle(paths, issueDefaults),
     buildResearchPipelineBundle(paths, issueDefaults),
-    buildCompanyProfileBundle(paths, issueDefaults),
-    buildCustomerProfileBundle(paths, issueDefaults),
-    buildPeopleProfileBundle(paths, issueDefaults),
-    buildSoftwareProfileBundle(paths, issueDefaults),
+    buildCompanyProfileBundle(paths, issueDefaults, tierFor("company-profile")),
+    buildCustomerProfileBundle(
+      paths,
+      issueDefaults,
+      tierFor("customer-profile")
+    ),
+    buildPeopleProfileBundle(paths, issueDefaults, tierFor("people-profile")),
+    buildSoftwareProfileBundle(
+      paths,
+      issueDefaults,
+      tierFor("software-profile")
+    ),
     buildIndustryDiscoveryBundle(paths, issueDefaults),
     buildBusinessModelsBundle(paths, issueDefaults),
     buildBcmWriterBundle(paths, issueDefaults),
     buildStandardsResearchBundle(paths, issueDefaults),
     buildRegulatoryResearchBundle(paths, issueDefaults),
-    buildMaintenanceAuditBundle(paths, issueDefaults),
+    buildMaintenanceAuditBundle(
+      paths,
+      issueDefaults,
+      tierFor("maintenance-audit")
+    ),
     buildDocsSyncBundle(paths)
   ];
 }
@@ -27672,7 +28284,7 @@ var ClaudeRenderer = class _ClaudeRenderer {
   /**
    * Render all Claude Code configuration files.
    */
-  static render(component, rules, skills, subAgents, mcpServers, settings, procedures) {
+  static render(component, rules, skills, subAgents, mcpServers, settings, procedures, commands) {
     _ClaudeRenderer.renderClaudeMd(component, rules);
     _ClaudeRenderer.renderScopedRules(component, rules);
     _ClaudeRenderer.renderSettings(component, mcpServers, settings);
@@ -27681,6 +28293,9 @@ var ClaudeRenderer = class _ClaudeRenderer {
     if (procedures && procedures.length > 0) {
       _ClaudeRenderer.renderProcedures(component, procedures);
     }
+    if (commands && commands.length > 0) {
+      _ClaudeRenderer.renderCommands(component, commands);
+    }
   }
   static renderClaudeMd(component, rules) {
     const claudeMdRules = rules.filter((r) => {
@@ -28012,6 +28627,30 @@ var ClaudeRenderer = class _ClaudeRenderer {
       });
     }
   }
+  /**
+   * Renders user-invokable slash commands to `.claude/commands/<name>.md`.
+   *
+   * Each command file carries a YAML frontmatter block with the
+   * `description` (always present) and an optional `model` alias. The
+   * body is the {@link AgentCommand.content} written verbatim.
+   *
+   * @see https://docs.claude.com/en/docs/claude-code/slash-commands
+   */
+  static renderCommands(component, commands) {
+    for (const command of commands) {
+      const lines = [];
+      lines.push("---");
+      lines.push(`description: ${command.description}`);
+      const resolvedModel = resolveModelAlias(command.model);
+      if (resolvedModel) {
+        lines.push(`model: ${resolvedModel}`);
+      }
+      lines.push("---");
+      lines.push("");
+      lines.push(...command.content.split("\n"));
+      new TextFile3(component, `.claude/commands/${command.name}.md`, { lines });
+    }
+  }
   /**
    * Determine the default Claude rule target based on rule scope.
    * ALWAYS-scoped rules default to CLAUDE_MD; FILE_PATTERN rules default to SCOPED_FILE.
@@ -28034,6 +28673,45 @@ var CopilotRenderer = class {
 };
 
 // src/agent/agent-config.ts
+function mapAgentTier(value) {
+  switch (value) {
+    case "powerful":
+      return AGENT_MODEL.POWERFUL;
+    case "fast":
+      return AGENT_MODEL.FAST;
+    case "balanced":
+    default:
+      return AGENT_MODEL.BALANCED;
+  }
+}
+function resolveDefaultAgentTier(options) {
+  return mapAgentTier(options?.defaultAgentTier);
+}
+var TIER_AWARE_BUNDLE_NAMES = [
+  "company-profile",
+  "customer-profile",
+  "maintenance-audit",
+  "meeting-analysis",
+  "people-profile",
+  "software-profile"
+];
+function resolveBundleAgentTiers(options) {
+  const overrides = options?.bundleAgentTiers;
+  if (!overrides) {
+    return /* @__PURE__ */ new Map();
+  }
+  const validNames = new Set(TIER_AWARE_BUNDLE_NAMES);
+  const out = /* @__PURE__ */ new Map();
+  for (const [name, value] of Object.entries(overrides)) {
+    if (!validNames.has(name)) {
+      throw new Error(
+        `bundleAgentTiers contains unknown bundle name "${name}". Valid names are: ${TIER_AWARE_BUNDLE_NAMES.join(", ")}.`
+      );
+    }
+    out.set(name, mapAgentTier(value));
+  }
+  return out;
+}
 var DEFAULT_CLAUDE_ALLOW = [
   // ── Git ──────────────────────────────────────────────────────────────
   "Bash(git add *)",
@@ -28138,6 +28816,45 @@ var DEFAULT_CLAUDE_DENY = [
   "Bash(export *)",
   "Bash(env *)"
 ];
+var DEFAULT_CLAUDE_PATH_DENY = [
+  "Read(./node_modules/**)",
+  "Read(./dist/**)",
+  "Read(./lib/**)",
+  "Read(./.astro/**)",
+  "Read(./.env)",
+  "Read(./.env.*)",
+  "Read(./*.lock)",
+  "Read(./pnpm-lock.yaml)",
+  "Read(./package-lock.json)"
+];
+var DEFAULT_USAGE_LOG_PATH = ".claude/usage.log";
+var DEFAULT_CLAUDE_ENV = {
+  ENABLE_TOOL_SEARCH: "1"
+};
+var DEFAULT_CLAUDE_HOOKS = {
+  Stop: [
+    {
+      matcher: "*",
+      hooks: [
+        {
+          type: "command",
+          command: `echo "$(date -u +%FT%TZ),\${CLAUDE_SESSION_ID:-unknown},\${CLAUDE_INPUT_TOKENS:-0},\${CLAUDE_OUTPUT_TOKENS:-0}" >> ${DEFAULT_USAGE_LOG_PATH}`
+        }
+      ]
+    }
+  ],
+  PostToolUse: [
+    {
+      matcher: "Edit|Write",
+      hooks: [
+        {
+          type: "command",
+          command: 'case "${CLAUDE_TOOL_INPUT_path:-}" in *docs/src/content/docs/*) if [ -x .claude/procedures/check-links.sh ]; then bash .claude/procedures/check-links.sh "$CLAUDE_TOOL_INPUT_path" 2>&1 | head -20; fi ;; esac'
+        }
+      ]
+    }
+  ]
+};
 var PROGRESS_FILE_BUNDLE_HOOKS = [
   ["bcm-writer-workflow", "bcm-writer"],
   ["business-models-workflow", "business-models"],
@@ -28212,10 +28929,30 @@ var AgentConfig = class _AgentConfig extends Component8 {
     return (examples.t1?.length ?? 0) > 0 || (examples.t2?.length ?? 0) > 0 || (examples.t3?.length ?? 0) > 0 || (examples.t4?.length ?? 0) > 0;
   }
   /**
-   * Merges default Claude permissions with bundle and user-supplied settings.
+   * Merges default Claude permissions and hooks with bundle and
+   * user-supplied settings.
    *
-   * Merge order: defaults → bundle permissions → user-supplied entries.
-   * `defaultMode` defaults to `"dontAsk"` unless overridden.
+   * Permission merge order: defaults → bundle permissions → user-supplied
+   * entries. Both `allow` and `deny` are deduped via
+   * `Array.from(new Set(...))`; V8 `Set` iteration preserves insertion
+   * order, so the final ordering is defaults first, then bundle, then
+   * user, with duplicates removed (first-occurrence wins). `defaultMode`
+   * defaults to `"dontAsk"` unless overridden — see the inline comment
+   * on the literal below for the autonomous-worker rationale.
+   *
+   * Hooks merge: consumer-supplied entries first, then default entries
+   * (Stop, PostToolUse), deduped by `(matcher, JSON-serialized hooks)`.
+   * Defaults are skipped entirely when `disableAllHooks: true` is set —
+   * the `disableAllHooks` flag passes through to the rendered file so
+   * Claude Code suppresses every project-level hook at runtime, and the
+   * defaults are dropped at synth time so the rendered file does not
+   * carry orphan entries that would re-fire if the operator later flipped
+   * the flag back off.
+   *
+   * Env merge: defaults from `DEFAULT_CLAUDE_ENV` (e.g.
+   * `ENABLE_TOOL_SEARCH=1`) layer first, then consumer-supplied
+   * `claudeSettings.env` entries override on key collision. Sibling keys
+   * from both sources land in the rendered file.
    */
   static mergeClaudeDefaults(userSettings, bundlePermissions) {
     const bundleAllow = bundlePermissions?.allow ?? [];
@@ -28224,14 +28961,80 @@ var AgentConfig = class _AgentConfig extends Component8 {
     const userDeny = userSettings?.permissions?.deny ?? [];
     return {
       ...userSettings,
+      // `defaultMode: "dontAsk"` is configulator's hardcoded default
+      // because scheduled-task workers (issue-worker, orchestrator,
+      // pr-reviewer, and the analyst/writer family) run autonomously
+      // and would deadlock on confirmation prompts. Any other value
+      // breaks the autonomous-worker contract — override only after
+      // revisiting that contract end-to-end. The override path for
+      // consumers is `claudeSettings.defaultMode` on
+      // `AgentConfigOptions`.
       defaultMode: userSettings?.defaultMode ?? "dontAsk",
       permissions: {
         ...userSettings?.permissions,
-        allow: [...DEFAULT_CLAUDE_ALLOW, ...bundleAllow, ...userAllow],
-        deny: [...DEFAULT_CLAUDE_DENY, ...bundleDeny, ...userDeny]
-      }
+        allow: Array.from(
+          /* @__PURE__ */ new Set([...DEFAULT_CLAUDE_ALLOW, ...bundleAllow, ...userAllow])
+        ),
+        deny: Array.from(
+          /* @__PURE__ */ new Set([
+            ...DEFAULT_CLAUDE_DENY,
+            ...DEFAULT_CLAUDE_PATH_DENY,
+            ...bundleDeny,
+            ...userDeny
+          ])
+        )
+      },
+      hooks: _AgentConfig.mergeClaudeHooks(userSettings),
+      env: { ...DEFAULT_CLAUDE_ENV, ...userSettings?.env ?? {} }
     };
   }
+  /**
+   * Merge default lifecycle hooks (Stop, PostToolUse) with consumer-
+   * supplied entries on `claudeSettings.hooks`. Consumer entries appear
+   * first so a downstream override that wires a faster lint/format hook
+   * runs ahead of the defaults; defaults are appended after.
+   *
+   * Returns `undefined` when neither defaults nor consumer entries
+   * remain — the renderer skips the `hooks` key entirely in that case
+   * so opt-out repos do not ship an empty `"hooks": {}` object.
+   *
+   * Defaults are gated on `disableAllHooks !== true`. When the flag is
+   * set we still pass through any consumer-supplied entries (the
+   * runtime-level `disableAllHooks: true` is what suppresses execution),
+   * but we never inject the bundle defaults. That keeps the disable-all
+   * escape hatch idempotent: flipping the flag drops the bundle's
+   * default surface area instead of leaving the entries on disk for a
+   * future re-enable.
+   */
+  static mergeClaudeHooks(userSettings) {
+    const userHooks = userSettings?.hooks;
+    const includeDefaults = userSettings?.disableAllHooks !== true;
+    const defaults = includeDefaults ? DEFAULT_CLAUDE_HOOKS : {};
+    const allEvents = /* @__PURE__ */ new Set([
+      ...Object.keys(userHooks ?? {}),
+      ...Object.keys(defaults)
+    ]);
+    const merged = {};
+    for (const event of allEvents) {
+      const userEntries = (userHooks ?? {})[event] ?? [];
+      const defaultEntries = defaults[event] ?? [];
+      const seen = /* @__PURE__ */ new Set();
+      const combined = [];
+      for (const entry of [...userEntries, ...defaultEntries]) {
+        const key = JSON.stringify({
+          matcher: entry.matcher,
+          hooks: entry.hooks
+        });
+        if (seen.has(key)) continue;
+        seen.add(key);
+        combined.push(entry);
+      }
+      if (combined.length > 0) {
+        merged[event] = combined;
+      }
+    }
+    return Object.keys(merged).length > 0 ? merged : void 0;
+  }
   constructor(project, options = {}) {
     super(project);
     this.options = options;
@@ -28260,7 +29063,9 @@ var AgentConfig = class _AgentConfig extends Component8 {
     if (!this.cachedBundles) {
       this.cachedBundles = buildBuiltInBundles(
         this.resolvedPaths,
-        resolveIssueDefaults(this.options.issueDefaults)
+        resolveIssueDefaults(this.options.issueDefaults),
+        resolveDefaultAgentTier(this.options),
+        resolveBundleAgentTiers(this.options)
       );
     }
     return this.cachedBundles;
@@ -28306,6 +29111,9 @@ var AgentConfig = class _AgentConfig extends Component8 {
     if (resolvedRunRatio.enabled) {
       this.project.gitignore.addPatterns(`/${resolvedRunRatio.stateFilePath}`);
     }
+    if (this.options.claudeSettings?.disableAllHooks !== true) {
+      this.project.gitignore.addPatterns(`/${DEFAULT_USAGE_LOG_PATH}`);
+    }
     validateUnblockDependentsConfig(this.options.unblockDependents);
     validateIssueDefaultsConfig(this.options.issueDefaults);
     const resolvedProgressFiles = validateProgressFilesConfig(
@@ -28370,6 +29178,7 @@ var AgentConfig = class _AgentConfig extends Component8 {
     const skills = this.resolveSkills();
     const subAgents = this.resolveSubAgents();
     const procedures = this.resolveProcedures();
+    const commands = this.resolveCommands();
     const mcpServers = this.options.mcpServers ?? {};
     const projectMetadata = ProjectMetadata.of(this.project);
     const metadata = projectMetadata?.metadata;
@@ -28405,7 +29214,8 @@ var AgentConfig = class _AgentConfig extends Component8 {
           this.options.claudeSettings,
           bundlePermissions
         ),
-        resolvedProcedures
+        resolvedProcedures,
+        commands
       );
     }
     if (platforms.includes(AGENT_PLATFORM.CODEX)) {
@@ -28544,6 +29354,7 @@ ${section}`
         }
       }
     }
+    const injectBundleHooks = this.options.claudeMd?.injectBundleHooks ?? true;
     const resolvedProgressFiles = resolveProgressFiles(
       this.options.progressFiles
     );
@@ -28561,7 +29372,7 @@ ${section}`
         }
       }
     }
-    if (resolvedProgressFiles.enabled) {
+    if (injectBundleHooks && resolvedProgressFiles.enabled) {
       for (const [ruleName, label] of PROGRESS_FILE_BUNDLE_HOOKS) {
         const existing = ruleMap.get(ruleName);
         if (!existing) {
@@ -28601,7 +29412,7 @@ ${hook}`
         }
       }
     }
-    if (resolvedSharedEditingForRules.enabled) {
+    if (injectBundleHooks && resolvedSharedEditingForRules.enabled) {
       for (const [ruleName, label] of SHARED_EDITING_BUNDLE_HOOKS) {
         const existing = ruleMap.get(ruleName);
         if (!existing) {
@@ -28641,7 +29452,7 @@ ${hook}`
         }
       }
     }
-    if (resolvedSkillEvalsForRules.enabled) {
+    if (injectBundleHooks && resolvedSkillEvalsForRules.enabled) {
       for (const [ruleName, label] of SKILL_EVALS_BUNDLE_HOOKS) {
         const existing = ruleMap.get(ruleName);
         if (!existing) {
@@ -28686,7 +29497,7 @@ ${hook}`
     if (!hasAnyDocsEmittingBundle(excludedBundleNames)) {
       ruleMap.delete("stub-index-convention");
     }
-    if (resolvedIssueTemplatesForRules.enabled && hasDownstreamBundles) {
+    if (injectBundleHooks && resolvedIssueTemplatesForRules.enabled && hasDownstreamBundles) {
       for (const [ruleName, label] of ISSUE_TEMPLATES_BUNDLE_HOOKS) {
         const existing = ruleMap.get(ruleName);
         if (!existing) {
@@ -28734,6 +29545,57 @@ ${hook}`
         }
       }
     }
+    const registryRule = buildAgentRegistryRule(
+      this.activeBundles,
+      this.resolvedPaths
+    );
+    if (registryRule) {
+      let registryContent = registryRule.content;
+      const meetingAnalysisActive = this.activeBundles.some(
+        (b) => b.name === "meeting-analysis"
+      );
+      if (this.options.meetings && meetingAnalysisActive) {
+        const meetingsSection = renderMeetingTypesSection(
+          this.options.meetings
+        );
+        if (meetingsSection.length > 0) {
+          registryContent = `${registryContent}
+
+---
+
+${meetingsSection}`;
+        }
+      }
+      ruleMap.set(registryRule.name, {
+        ...registryRule,
+        content: registryContent
+      });
+      const customSectionBundles = new Set(
+        (this.options.features?.customDocSections ?? []).map(
+          (s) => s.bundleName
+        )
+      );
+      for (const [ruleName, rule] of ruleMap) {
+        if (!isSuppressedWorkflowRule(ruleName)) {
+          continue;
+        }
+        const owningBundleName = bundleNameForWorkflowRule(ruleName);
+        if (owningBundleName !== void 0 && customSectionBundles.has(owningBundleName)) {
+          continue;
+        }
+        const existingClaude = rule.platforms?.claude ?? {};
+        if (existingClaude.exclude === true) {
+          continue;
+        }
+        ruleMap.set(ruleName, {
+          ...rule,
+          platforms: {
+            ...rule.platforms,
+            claude: { ...existingClaude, exclude: true }
+          }
+        });
+      }
+    }
     return [...ruleMap.values()].sort((a, b) => {
       if (a.name === "project-overview") return -1;
       if (b.name === "project-overview") return 1;
@@ -28882,6 +29744,49 @@ ${hook}`
     }
     return [...procMap.values()];
   }
+  /**
+   * Resolves the final list of slash commands by merging bundle-shipped
+   * defaults with consumer-supplied entries. Mirrors {@link resolveSkills}
+   * and {@link resolveSubAgents}: auto-detected bundles contribute first,
+   * force-included bundles overlay, and consumer commands override on
+   * name collision. Names listed in `excludeCommands` are dropped after
+   * the merge so consumers can opt out of a single default without
+   * disabling the whole bundle.
+   */
+  resolveCommands() {
+    const commandMap = /* @__PURE__ */ new Map();
+    if (this.options.autoDetectBundles !== false) {
+      for (const bundle of this.pathAwareBundles) {
+        if (this.options.excludeBundles?.includes(bundle.name)) continue;
+        if (bundle.appliesWhen(this.project) && bundle.commands) {
+          for (const command of bundle.commands) {
+            commandMap.set(command.name, command);
+          }
+        }
+      }
+    }
+    if (this.options.includeBundles) {
+      for (const bundleName of this.options.includeBundles) {
+        const bundle = this.pathAwareBundles.find((b) => b.name === bundleName);
+        if (bundle?.commands) {
+          for (const command of bundle.commands) {
+            commandMap.set(command.name, command);
+          }
+        }
+      }
+    }
+    if (this.options.commands) {
+      for (const command of this.options.commands) {
+        commandMap.set(command.name, command);
+      }
+    }
+    if (this.options.excludeCommands) {
+      for (const name of this.options.excludeCommands) {
+        commandMap.delete(name);
+      }
+    }
+    return [...commandMap.values()];
+  }
   /**
    * Resolves template variables in rule content using project metadata.
    * Emits synthesis warnings for rules with unresolved variables.
@@ -33326,6 +34231,7 @@ var TypeScriptConfig = class extends Component20 {
 export {
   AGENT_MODEL,
   AGENT_PLATFORM,
+  AGENT_REGISTRY_ENTRIES,
   AGENT_RULE_SCOPE,
   AGENT_TIER_ROLES,
   AGENT_TIER_VALUES,
@@ -33422,8 +34328,10 @@ export {
   SCOPE_CLASS_VALUES,
   SHARED_EDITING_CONFLICT_STRATEGY_VALUES,
   STARLIGHT_ROLE,
+  SUPPRESSED_WORKFLOW_RULE_NAMES,
   SampleLang,
   StarlightProject,
+  TIER_AWARE_BUNDLE_NAMES,
   TestRunner,
   TsDocCoverageKind,
   TurboRepo,
@@ -33447,6 +34355,7 @@ export {
   awsCdkBundle,
   baseBundle,
   bcmWriterBundle,
+  buildAgentRegistryRule,
   buildBaseBundle,
   buildBcmWriterBundle,
   buildBuiltInBundles,
@@ -33457,6 +34366,7 @@ export {
   buildDocsSyncBundle,
   buildIndustryDiscoveryBundle,
   buildMaintenanceAuditBundle,
+  buildMeetingAnalysisBundle,
   buildOrchestratorConventionsContent,
   buildPeopleProfileBundle,
   buildRegulatoryResearchBundle,
@@ -33468,6 +34378,7 @@ export {
   buildSoftwareProfileBundle,
   buildStandardsResearchBundle,
   buildUnblockDependentsProcedure,
+  bundleNameForWorkflowRule,
   businessModelsBundle,
   checkDocSamplesProcedure,
   checkLinksProcedure,
@@ -33494,6 +34405,7 @@ export {
   industryDiscoveryBundle,
   isPhaseLabelOwnedByExcluded,
   isScheduledTaskOwnedByExcluded,
+  isSuppressedWorkflowRule,
   isTypeLabelOwnedByExcluded,
   jestBundle,
   labelsForPhase,
@@ -33552,6 +34464,8 @@ export {
   resolveAgentTiers,
   resolveAstroProjectOutdir,
   resolveAwsCdkProjectOutdir,
+  resolveBundleAgentTiers,
+  resolveDefaultAgentTier,
   resolveIssueDefaults,
   resolveIssueTemplates,
   resolveModelAlias,