@codedrifters/configulator 0.0.200 → 0.0.201

package/lib/index.d.mts

@@ -1039,6 +1039,17 @@ declare const prReviewBundle: AgentRuleBundle;
  */
 declare const projenBundle: AgentRuleBundle;
 
+/**
+ * Requirements-analyst bundle — opt-in via `includeBundles: [\"requirements-analyst\"]`.
+ *
+ * Provides a 3-phase requirements gap-discovery pipeline (scan → draft → trace)
+ * designed for projects using the BCM (Business Capability Model) framework.
+ * Ships a sub-agent, a user-invocable skill, and `req:*` phase labels via the
+ * bundle `labels` mechanism so consuming projects automatically pick up the
+ * label taxonomy through the sync-labels workflow.
+ */
+declare const requirementsAnalystBundle: AgentRuleBundle;
+
 /**
  * Slack bundle — opt-in via `includeBundles: ["slack"]`.
  * Never auto-detected (no Slack dependency to introspect).
@@ -3405,4 +3416,4 @@ declare const COMPLETE_JOB_ID = "complete";
  */
 declare function addBuildCompleteJob(buildWorkflow: BuildWorkflow): void;
 
-export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, type AgentConfigOptions, type AgentModel, type AgentPlatform, type AgentPlatformOverrides, type AgentProcedure, type AgentRule, type AgentRuleBundle, type AgentRuleScope, type AgentSkill, type AgentSubAgent, type AgentSubAgentPlatformOverrides, type ApproveMergeUpgradeOptions, AstroConfig, type AstroConfigOptions, type AstroIntegrationSpec, AstroOutput, AstroProject, type AstroProjectOptions, type AwsAccount, AwsCdkProject, type AwsCdkProjectOptions, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, type AwsDeploymentTargetOptions, type AwsLocalDeploymentConfig, type AwsOrganization, type AwsRegion, AwsTeardownWorkflow, type AwsTeardownWorkflowOptions, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, type CiDeploymentConfig, type ClassTypeOptions, type ClaudeAutoModeConfig, type ClaudeHookAction, type ClaudeHookEntry, type ClaudeHooksConfig, type ClaudePermissionsConfig, type ClaudeRuleTarget, type ClaudeSandboxConfig, type ClaudeSettingsConfig, type CopilotHandoff, type CursorHookAction, type CursorHooksConfig, type CursorSettingsConfig, DEFAULT_PRIORITY_LABELS, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, DEFAULT_TYPE_LABELS, type DeployWorkflowOptions, type DeploymentMetadata, type GitBranch, type GitHubBoardMetadata, type GitHubProjectMetadata, type GitHubSprintMetadata, type IDependencyResolver, JsiiFaker, type LabelDefinition, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, type McpServerConfig, type McpTransport, type MergeMethod, MonorepoProject, type MonorepoProjectOptions, type OrganizationMetadata, PROD_DEPLOY_NAME, PnpmWorkspace, type PnpmWorkspaceOptions, ProjectMetadata, type ProjectMetadataOptions, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, type RemoteCacheOptions, type RepositoryMetadata, ResetTask, type ResetTaskOptions, type ResolvedProjectMetadata, type SlackMetadata, type StarlightEditLink, type StarlightLogo, StarlightProject, type StarlightProjectOptions, type StarlightSidebarItem, type StarlightSocialLink, type SyncLabelsOptions, type TemplateResolveResult, TestRunner, TurboRepo, type TurboRepoOptions, TurboRepoTask, type TurboRepoTaskOptions, TypeScriptConfig, TypeScriptProject, type TypeScriptProjectOptions, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, type VersionKey, Vitest, type VitestConfigOptions, type VitestOptions, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, awsCdkBundle, baseBundle, getLatestEligibleVersion, githubWorkflowBundle, jestBundle, meetingAnalysisBundle, orchestratorBundle, pnpmBundle, prReviewBundle, projenBundle, resolveModelAlias, resolveTemplateVariables, slackBundle, turborepoBundle, typescriptBundle, vitestBundle };
+export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, type AgentConfigOptions, type AgentModel, type AgentPlatform, type AgentPlatformOverrides, type AgentProcedure, type AgentRule, type AgentRuleBundle, type AgentRuleScope, type AgentSkill, type AgentSubAgent, type AgentSubAgentPlatformOverrides, type ApproveMergeUpgradeOptions, AstroConfig, type AstroConfigOptions, type AstroIntegrationSpec, AstroOutput, AstroProject, type AstroProjectOptions, type AwsAccount, AwsCdkProject, type AwsCdkProjectOptions, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, type AwsDeploymentTargetOptions, type AwsLocalDeploymentConfig, type AwsOrganization, type AwsRegion, AwsTeardownWorkflow, type AwsTeardownWorkflowOptions, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, type CiDeploymentConfig, type ClassTypeOptions, type ClaudeAutoModeConfig, type ClaudeHookAction, type ClaudeHookEntry, type ClaudeHooksConfig, type ClaudePermissionsConfig, type ClaudeRuleTarget, type ClaudeSandboxConfig, type ClaudeSettingsConfig, type CopilotHandoff, type CursorHookAction, type CursorHooksConfig, type CursorSettingsConfig, DEFAULT_PRIORITY_LABELS, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, DEFAULT_TYPE_LABELS, type DeployWorkflowOptions, type DeploymentMetadata, type GitBranch, type GitHubBoardMetadata, type GitHubProjectMetadata, type GitHubSprintMetadata, type IDependencyResolver, JsiiFaker, type LabelDefinition, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, type McpServerConfig, type McpTransport, type MergeMethod, MonorepoProject, type MonorepoProjectOptions, type OrganizationMetadata, PROD_DEPLOY_NAME, PnpmWorkspace, type PnpmWorkspaceOptions, ProjectMetadata, type ProjectMetadataOptions, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, type RemoteCacheOptions, type RepositoryMetadata, ResetTask, type ResetTaskOptions, type ResolvedProjectMetadata, type SlackMetadata, type StarlightEditLink, type StarlightLogo, StarlightProject, type StarlightProjectOptions, type StarlightSidebarItem, type StarlightSocialLink, type SyncLabelsOptions, type TemplateResolveResult, TestRunner, TurboRepo, type TurboRepoOptions, TurboRepoTask, type TurboRepoTaskOptions, TypeScriptConfig, TypeScriptProject, type TypeScriptProjectOptions, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, type VersionKey, Vitest, type VitestConfigOptions, type VitestOptions, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, awsCdkBundle, baseBundle, getLatestEligibleVersion, githubWorkflowBundle, jestBundle, meetingAnalysisBundle, orchestratorBundle, pnpmBundle, prReviewBundle, projenBundle, requirementsAnalystBundle, resolveModelAlias, resolveTemplateVariables, slackBundle, turborepoBundle, typescriptBundle, vitestBundle };

package/lib/index.d.ts

@@ -1088,6 +1088,17 @@ declare const prReviewBundle: AgentRuleBundle;
  */
 declare const projenBundle: AgentRuleBundle;
 
+/**
+ * Requirements-analyst bundle — opt-in via `includeBundles: [\"requirements-analyst\"]`.
+ *
+ * Provides a 3-phase requirements gap-discovery pipeline (scan → draft → trace)
+ * designed for projects using the BCM (Business Capability Model) framework.
+ * Ships a sub-agent, a user-invocable skill, and `req:*` phase labels via the
+ * bundle `labels` mechanism so consuming projects automatically pick up the
+ * label taxonomy through the sync-labels workflow.
+ */
+declare const requirementsAnalystBundle: AgentRuleBundle;
+
 /**
  * Slack bundle — opt-in via `includeBundles: ["slack"]`.
  * Never auto-detected (no Slack dependency to introspect).
@@ -3454,5 +3465,5 @@ declare const COMPLETE_JOB_ID = "complete";
  */
 declare function addBuildCompleteJob(buildWorkflow: BuildWorkflow): void;
 
-export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, AstroConfig, AstroOutput, AstroProject, AwsCdkProject, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, AwsTeardownWorkflow, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, DEFAULT_PRIORITY_LABELS, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, DEFAULT_TYPE_LABELS, JsiiFaker, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MonorepoProject, PROD_DEPLOY_NAME, PnpmWorkspace, ProjectMetadata, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, ResetTask, StarlightProject, TestRunner, TurboRepo, TurboRepoTask, TypeScriptConfig, TypeScriptProject, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, Vitest, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, awsCdkBundle, baseBundle, getLatestEligibleVersion, githubWorkflowBundle, jestBundle, meetingAnalysisBundle, orchestratorBundle, pnpmBundle, prReviewBundle, projenBundle, resolveModelAlias, resolveTemplateVariables, slackBundle, turborepoBundle, typescriptBundle, vitestBundle };
+export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, AstroConfig, AstroOutput, AstroProject, AwsCdkProject, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, AwsTeardownWorkflow, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, DEFAULT_PRIORITY_LABELS, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, DEFAULT_TYPE_LABELS, JsiiFaker, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MonorepoProject, PROD_DEPLOY_NAME, PnpmWorkspace, ProjectMetadata, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, ResetTask, StarlightProject, TestRunner, TurboRepo, TurboRepoTask, TypeScriptConfig, TypeScriptProject, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, Vitest, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, awsCdkBundle, baseBundle, getLatestEligibleVersion, githubWorkflowBundle, jestBundle, meetingAnalysisBundle, orchestratorBundle, pnpmBundle, prReviewBundle, projenBundle, requirementsAnalystBundle, resolveModelAlias, resolveTemplateVariables, slackBundle, turborepoBundle, typescriptBundle, vitestBundle };
 export type { AgentConfigOptions, AgentModel, AgentPlatform, AgentPlatformOverrides, AgentProcedure, AgentRule, AgentRuleBundle, AgentRuleScope, AgentSkill, AgentSubAgent, AgentSubAgentPlatformOverrides, ApproveMergeUpgradeOptions, AstroConfigOptions, AstroIntegrationSpec, AstroProjectOptions, AwsAccount, AwsCdkProjectOptions, AwsDeploymentTargetOptions, AwsLocalDeploymentConfig, AwsOrganization, AwsRegion, AwsTeardownWorkflowOptions, CiDeploymentConfig, ClassTypeOptions, ClaudeAutoModeConfig, ClaudeHookAction, ClaudeHookEntry, ClaudeHooksConfig, ClaudePermissionsConfig, ClaudeRuleTarget, ClaudeSandboxConfig, ClaudeSettingsConfig, CopilotHandoff, CursorHookAction, CursorHooksConfig, CursorSettingsConfig, DeployWorkflowOptions, DeploymentMetadata, GitBranch, GitHubBoardMetadata, GitHubProjectMetadata, GitHubSprintMetadata, IDependencyResolver, LabelDefinition, McpServerConfig, McpTransport, MergeMethod, MonorepoProjectOptions, OrganizationMetadata, PnpmWorkspaceOptions, ProjectMetadataOptions, RemoteCacheOptions, RepositoryMetadata, ResetTaskOptions, ResolvedProjectMetadata, SlackMetadata, StarlightEditLink, StarlightLogo, StarlightProjectOptions, StarlightSidebarItem, StarlightSocialLink, SyncLabelsOptions, TemplateResolveResult, TurboRepoOptions, TurboRepoTaskOptions, TypeScriptProjectOptions, VersionKey, VitestConfigOptions, VitestOptions };

package/lib/index.js

@@ -230,6 +230,7 @@ __export(index_exports, {
   pnpmBundle: () => pnpmBundle,
   prReviewBundle: () => prReviewBundle,
   projenBundle: () => projenBundle,
+  requirementsAnalystBundle: () => requirementsAnalystBundle,
   resolveModelAlias: () => resolveModelAlias,
   resolveTemplateVariables: () => resolveTemplateVariables,
   slackBundle: () => slackBundle,
@@ -2933,6 +2934,474 @@ var projenBundle = {
   ]
 };
 
+// src/agent/bundles/requirements-analyst.ts
+var requirementsAnalystSubAgent = {
+  name: "requirements-analyst",
+  description: "Discovers requirement gaps from BCM model docs, competitive analysis, product docs, and meeting extracts. Produces scan reports and proposals for the downstream requirements-writer agent. Runs through a 3-phase pipeline (scan \u2192 draft \u2192 trace), one phase per session, tracked by req:* GitHub issue labels.",
+  model: AGENT_MODEL.POWERFUL,
+  maxTurns: 80,
+  platforms: { cursor: { exclude: true } },
+  prompt: [
+    "# Requirements Analyst Agent",
+    "",
+    "Dedicated agent loop for discovering requirement gaps from BCM (Business",
+    "Capability Model) documents, product docs, and competitive analysis \u2014 then",
+    "creating well-formed requirement issues for the downstream",
+    "requirements-writer (BCM writer) agent to draft. Designed for scheduled",
+    "execution downstream of the BCM writer and company research agents.",
+    "",
+    "Follow your project's shared agent conventions (`AGENTS.md`,",
+    "`CLAUDE.md`, or equivalent) for all commit, branch, and PR rules.",
+    "",
+    "## Design Principles",
+    "",
+    "1. **Discover, don't write.** This agent identifies *what requirements are",
+    "   missing*. The requirements-writer skill writes the actual documents. The",
+    "   boundary keeps this agent fast and the requirements-writer authoritative.",
+    "2. **Trace everything.** Every discovered gap links to the source that",
+    "   revealed it (a BCM model doc, competitive analysis, product doc, or",
+    "   meeting extract).",
+    "3. **Respect the taxonomy.** Route every discovered requirement to the",
+    "   correct BCM category (FR, BR, NFR, SEC, DR, INT, OPS, UX, MT, ADR, TR)",
+    "   using the disambiguation rules in the requirements-writer skill.",
+    "4. **Deduplicate.** Before creating an issue, check whether a requirement",
+    "   already exists or an issue is already open for it.",
+    "",
+    "---",
+    "",
+    "## State Machine Overview",
+    "",
+    "Requirements synthesis flows through **3 phases**:",
+    "",
+    "```",
+    "\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510     \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510     \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510",
+    "\u2502  1. SCAN     \u2502\u2500\u2500\u2500\u2500\u25B6\u2502  2. DRAFT    \u2502\u2500\u2500\u2500\u2500\u25B6\u2502  3. TRACE    \u2502",
+    "\u2502  Read docs,  \u2502     \u2502  Write gap   \u2502     \u2502  Create GH   \u2502",
+    "\u2502  identify    \u2502     \u2502  report with \u2502     \u2502  issues and  \u2502",
+    "\u2502  gaps, check \u2502     \u2502  requirement \u2502     \u2502  update src  \u2502",
+    "\u2502  for dupes   \u2502     \u2502  proposals   \u2502     \u2502  docs with   \u2502",
+    "\u2502              \u2502     \u2502              \u2502     \u2502  traceability\u2502",
+    "\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518     \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518     \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518",
+    "```",
+    "",
+    "**Issue labels encode the phase:**",
+    "",
+    "| Label | Phase | Session work |",
+    "|-------|-------|-------------|",
+    "| `req:scan` | 1. Scan | Read source docs, identify potential requirement gaps, check against existing requirements and open issues, write deduplicated scan report |",
+    "| `req:draft` | 2. Draft | Write gap report with proposed requirements |",
+    "| `req:trace` | 3. Trace | Create GitHub issues for each proposed requirement and update source documents with traceability notes |",
+    "",
+    "All issues also carry `type:requirement` and a `status:*` label.",
+    "",
+    "**Issue count per scan cycle:** 1 scan + 1 draft + 1 trace = **3 sessions**.",
+    "",
+    "**Shortened paths:**",
+    "- No gaps found after scan \u2192 skip draft and trace \u2192 **1 session**",
+    "- No source docs need traceability updates \u2192 still **3 sessions** (trace",
+    "  handles both issue creation and doc updates)",
+    "",
+    "---",
+    "",
+    "## Configurable Paths",
+    "",
+    "Projects adopting this bundle must define these paths in their agent",
+    "configuration (`agentConfig.rules` extension or project-level docs):",
+    "",
+    "| Placeholder | Meaning | Typical value |",
+    "|-------------|---------|---------------|",
+    "| `<BCM_DOCS_ROOT>` | Root of BCM model docs (capability models) | `src/content/docs/concepts/` |",
+    "| `<COMPETITIVE_ROOT>` | Competitive analysis docs | `src/content/docs/business-strategy/competitive/` |",
+    "| `<PRODUCT_ROOT>` | Product roadmap / entity taxonomy | `src/content/docs/product/` |",
+    "| `<MEETINGS_ROOT>` | Meeting extracts | `src/content/docs/research/meetings/` |",
+    "| `<RESEARCH_REQUIREMENTS_ROOT>` | Scan reports and proposals | `src/content/docs/research/requirements/` |",
+    "| `<REQUIREMENTS_ROOT>` | Final requirement documents (owned by requirements-writer) | `src/content/docs/requirements/` |",
+    "| `<PREFIX>` | Project-specific requirement ID prefix | e.g. `VRTX`, `ACME` |",
+    "",
+    "If your project stores these in different locations, substitute accordingly",
+    "wherever the phase instructions reference a path.",
+    "",
+    "---",
+    "",
+    "## Agent Loop",
+    "",
+    "Run this loop exactly once per session. Never start a second issue.",
+    "",
+    "1. Claim one open `type:requirement` issue using phase priority:",
+    "   `req:scan` > `req:draft` > `req:trace`.",
+    "2. Transition `status:ready` \u2192 `status:in-progress` and create the branch",
+    "   per your project's branch-naming convention.",
+    "3. Execute the phase handler that matches the issue's `req:*` label.",
+    "4. Commit, push, open a PR (if applicable), and close the issue per your",
+    "   project's PR workflow.",
+    "",
+    "---",
+    "",
+    "## Phase 1: Scan (`req:scan`)",
+    "",
+    "**Goal:** Read source documents, identify where requirements are missing,",
+    "incomplete, or contradictory, then check each potential gap against existing",
+    "requirements and open issues to eliminate duplicates. Produces a single",
+    "deduplicated scan report.",
+    "",
+    "**Budget:** Reading source docs + reading requirement registries + searching",
+    "issues. Write one deduplicated scan output file.",
+    "",
+    "### Scan Sources",
+    "",
+    "The issue specifies which source(s) to scan. Common scan scopes:",
+    "",
+    "| Scope | What to read | What to look for |",
+    "|-------|-------------|-----------------|",
+    "| **BCM model doc** | One `{PREFIX}-NNN` doc under `<BCM_DOCS_ROOT>` | `## Vortex Relevance` (or equivalent project-relevance) section \u2014 gaps where capabilities exist but no FR/BR/INT addresses them |",
+    "| **Competitive analysis** | One `comp-*.md` doc under `<COMPETITIVE_ROOT>` | Feature comparison gaps \u2014 competitor features the product lacks requirements for |",
+    "| **Product roadmap** | `<PRODUCT_ROOT>/prioritized-feature-roadmap.md` | Roadmap items without corresponding FRs |",
+    "| **Entity taxonomy** | `<PRODUCT_ROOT>/entity-taxonomy.md` | Entities without CRUD requirements (FR), data requirements (DR), or security requirements (SEC) |",
+    "| **Meeting extract** | `<MEETINGS_ROOT>/meeting-*.extract.md` | Requirements identified but not yet formalized |",
+    "",
+    "### Steps",
+    "",
+    "1. **Read the source documents** specified in the issue.",
+    "",
+    "2. **Identify potential gaps.** For each potential missing requirement:",
+    "   - Classify into the correct BCM category (FR, BR, NFR, SEC, DR, INT,",
+    "     OPS, UX, MT, ADR, TR)",
+    "   - Apply the disambiguation rules from the requirements-writer skill",
+    "   - Note the source that revealed the gap",
+    "   - Estimate priority based on the source context",
+    "",
+    "3. **Read the requirements registry.** Scan `_index.md` files in each",
+    "   `<REQUIREMENTS_ROOT>/<category>/` directory to know what already exists.",
+    "",
+    "4. **Search for existing issues.** For each potential gap, search open issues:",
+    "   ```bash",
+    '   gh issue list --label "type:requirement" --state open \\',
+    "     --json number,title --limit 100",
+    "   ```",
+    "",
+    "5. **Classify each gap:**",
+    "   - **New** \u2014 no existing requirement or open issue covers this",
+    "   - **Duplicate** \u2014 an existing requirement already addresses this",
+    "   - **In progress** \u2014 an open issue already targets this",
+    "   - **Partial** \u2014 existing requirement partially covers this; note the gap",
+    "",
+    "6. **Write the deduplicated scan report** to:",
+    "   ```",
+    "   <RESEARCH_REQUIREMENTS_ROOT>/req-scan-<scope>-<YYYY-MM-DD>.md",
+    "   ```",
+    "",
+    "   Format:",
+    "   ```markdown",
+    "   ---",
+    '   title: "Requirements Scan: <scope>"',
+    "   date: YYYY-MM-DD",
+    "   parent_issue: <N>",
+    "   status: complete",
+    "   ---",
+    "",
+    "   # Requirements Scan: <scope>",
+    "",
+    "   ## Source Documents Reviewed",
+    "   - <path> \u2014 <brief description>",
+    "",
+    "   ## Existing Requirements Checked",
+    "   - <category>: <count> existing docs, <count> open issues",
+    "",
+    "   ## Identified Gaps (New)",
+    "   ### Gap 1: <Title>",
+    "   - **Category:** FR / BR / NFR / SEC / DR / INT / OPS / UX / MT / ADR / TR",
+    "   - **Source:** <path to doc + section that revealed this gap>",
+    "   - **Priority:** High / Normal / Low",
+    "   - **Rationale:** <why this requirement is needed>",
+    "   - **Duplicate check:** No existing requirement or open issue found",
+    "   - **Proposed scope:** <1-2 sentences on what the requirement should cover>",
+    "",
+    "   ## Already Covered",
+    "   <list of potential gaps that turned out to already have requirements>",
+    "",
+    "   ## In Progress",
+    "   <gaps that already have open issues \u2014 include issue numbers>",
+    "",
+    "   ## Ambiguous / Needs Human Decision",
+    "   <gaps where the correct category or scope is unclear>",
+    "   ```",
+    "",
+    "7. **Create downstream issues based on findings:**",
+    "   - If any new gaps were identified \u2192 create `req:draft` issue",
+    "     (blocked on this issue via `Depends on: #N`).",
+    "   - If **no gaps** were found \u2192 stop (no further phases needed). Comment",
+    "     on the issue noting that no gaps were identified, and proceed directly",
+    "     to commit and push. The scan issue will be marked done with no",
+    "     downstream work needed.",
+    "",
+    "8. **Commit and push.**",
+    "",
+    "---",
+    "",
+    "## Phase 2: Draft (`req:draft`)",
+    "",
+    "**Goal:** Expand each identified gap into a requirement proposal with enough",
+    "detail for the requirements-writer to produce a full document.",
+    "",
+    "**Budget:** No web searches. Reading + writing.",
+    "",
+    "### Steps",
+    "",
+    "1. **Read the scan report** from Phase 1.",
+    "",
+    "2. **For each gap**, write a detailed proposal:",
+    "",
+    "   ```markdown",
+    "   ## Proposed: <PREFIX>-<NNN> \u2014 <Title>",
+    "",
+    "   **Category:** <FR/BR/NFR/SEC/DR/INT/OPS/UX/MT/ADR/TR>",
+    "   **Priority:** <High/Normal/Low>",
+    "   **Source:** <document path and section>",
+    "",
+    "   ### Summary",
+    "   <2-3 sentences describing what the requirement should capture>",
+    "",
+    "   ### Draft Acceptance Criteria",
+    "   - [ ] <testable criterion 1>",
+    "   - [ ] <testable criterion 2>",
+    "   - [ ] <testable criterion 3>",
+    "",
+    "   ### Traceability",
+    "   - **Implements:** <BR or parent requirement if applicable>",
+    "   - **Related:** <existing requirements that interact with this one>",
+    "   - **Source:** <BCM doc, competitive analysis, or meeting that revealed",
+    "     the gap \u2014 use a markdown link. If the source is a meeting note, the",
+    "     downstream requirement doc must include the same meeting as a link in",
+    "     its Traceability `Related:` list.>",
+    "",
+    "   ### Decision Authority",
+    '   <"Direct write" for BR/FR/NFR/SEC/UX, or "Proposed \u2014 needs human',
+    '   decision" for ADR/TR, or "Mixed \u2014 defer technology choices" for',
+    "   DR/MT/INT/OPS>",
+    "",
+    "   ### Notes for Requirements Writer",
+    "   <any context the writer should know \u2014 related ADRs, existing partial",
+    "   coverage, relevant competitive features>",
+    "   ```",
+    "",
+    "3. **Write the proposals** to:",
+    "   ```",
+    "   <RESEARCH_REQUIREMENTS_ROOT>/req-proposals-<scope>-<YYYY-MM-DD>.md",
+    "   ```",
+    "",
+    "4. **Determine next sequence numbers.** Check each target category",
+    "   directory under `<REQUIREMENTS_ROOT>/<category>/` to find the next",
+    "   available `NNN` for each proposed requirement.",
+    "",
+    "5. **Create the `req:trace` issue** blocked on this draft issue.",
+    "",
+    "6. **Commit and push.**",
+    "",
+    "---",
+    "",
+    "## Phase 3: Trace (`req:trace`)",
+    "",
+    "**Goal:** Create GitHub issues for each proposed requirement and update",
+    "source documents with traceability notes indicating that requirement issues",
+    "were created.",
+    "",
+    "**Budget:** No web searches. Issue creation + minor edits to source",
+    "documents.",
+    "",
+    "### Steps",
+    "",
+    "1. **Read the proposals** from Phase 2.",
+    "",
+    "2. **Create requirement issues.** For each proposal:",
+    "",
+    "   All `type:requirement` issues default to `priority:medium` (override",
+    "   only if the proposal's priority was explicitly High or Low).",
+    "",
+    "   ```bash",
+    "   gh issue create \\",
+    '     --title "docs(<category>): <PREFIX>-<NNN> \u2014 <title>" \\',
+    '     --label "type:requirement" --label "status:ready" --label "priority:medium" \\',
+    '     --body "## Objective',
+    "   Write <PREFIX>-<NNN> \u2014 <title>.",
+    "",
+    "   ## Context",
+    "   - **Gap identified by:** requirements scan of <source>",
+    "   - **Proposals file:** <RESEARCH_REQUIREMENTS_ROOT>/req-proposals-<scope>-<date>.md",
+    "",
+    "   ## Inputs",
+    "   - **Depends on:** (none)",
+    "   - **Read:** <RESEARCH_REQUIREMENTS_ROOT>/req-proposals-<scope>-<date>.md, <source docs>",
+    "",
+    "   ## Acceptance Criteria",
+    "   - [ ] Requirement document follows <category> template",
+    "   - [ ] Traceability links to source BCM/competitive/product doc",
+    "   - [ ] Registry index updated",
+    "   - [ ] Decision authority rules followed (direct write vs. proposed)",
+    "",
+    "   ## Scope Size",
+    "   small",
+    "",
+    "   ## Output Path",
+    '   <REQUIREMENTS_ROOT>/<category>/<PREFIX>-<NNN>-<slug>.md"',
+    "   ```",
+    "",
+    "3. **Update source documents.** In each BCM model doc or competitive",
+    "   analysis that was scanned, add a note in the `## Vortex Relevance` or",
+    "   `## Strategic Implications` section indicating that a requirement issue",
+    "   was created:",
+    "",
+    "   ```markdown",
+    "   - Gap addressed: see [<PREFIX>-<NNN>](<relative path to requirement doc>)",
+    "     (issue #<N>)",
+    "   ```",
+    "",
+    "4. **Comment on the scan issue** with a summary of all issues created and",
+    "   all docs updated.",
+    "",
+    "5. **Commit and push.**",
+    "",
+    "---",
+    "",
+    "## Coordination with Other Agents",
+    "",
+    "| Direction | Agent | What |",
+    "|-----------|-------|------|",
+    "| Upstream | BCM Writer | Scans `## Vortex Relevance` sections for capability gaps |",
+    "| Upstream | Company Research | Scans competitive analysis for feature comparison gaps |",
+    "| Upstream | Meeting Analyst | Scans meeting extracts for requirement proposals |",
+    "| Downstream | Requirements Writer (BCM Writer) | Creates `type:requirement` issues for the skill to draft |",
+    "",
+    "**File boundaries:** Writes to `<RESEARCH_REQUIREMENTS_ROOT>/req-*.md` and",
+    "minor traceability edits to `<BCM_DOCS_ROOT>` and `<COMPETITIVE_ROOT>`.",
+    "Never writes to `<REQUIREMENTS_ROOT>/` \u2014 that is owned by the",
+    "requirements-writer agent.",
+    "",
+    "---",
+    "",
+    "## Blocked Issues",
+    "",
+    "Additional block reasons specific to requirements synthesis:",
+    "- Source document has unresolved contradictions",
+    "- Category classification is ambiguous (needs human disambiguation)",
+    "- Dependent BCM documents are still in draft with placeholder content",
+    "",
+    "---",
+    "",
+    "## Rules",
+    "",
+    "- **Discover, don't write requirements.** Create issues for the",
+    "  requirements-writer \u2014 don't write requirement documents directly.",
+    "- **Deduplicate rigorously.** Check both existing docs and open issues",
+    "  before flagging a gap.",
+    "- **Respect decision authority.** Mark ADR/TR proposals as needing human",
+    "  decision. Don't create direct-write issues for technology choices.",
+    "- **Bidirectional traceability.** Every `req-scan-*.md` and",
+    "  `req-proposals-*.md` must include a `## Produced` section listing the",
+    "  downstream requirement issues (and eventual requirement documents) it",
+    "  spawned, as markdown links; each formal requirement document under",
+    "  `<REQUIREMENTS_ROOT>/` must include a forward link back to the scan or",
+    "  proposal that produced it."
+  ].join("\n")
+};
+var scanRequirementsSkill = {
+  name: "scan-requirements",
+  description: "Kick off a requirements-analyst scan across BCM model docs, competitive analysis, product docs, or meeting extracts. Creates a req:scan issue and dispatches Phase 1.",
+  disableModelInvocation: true,
+  userInvocable: true,
+  context: "fork",
+  agent: "requirements-analyst",
+  platforms: { cursor: { exclude: true } },
+  instructions: [
+    "# Scan Requirements",
+    "",
+    "Kick off a requirements-analyst scan cycle. Creates a `req:scan` issue",
+    "targeted at the requested scope and dispatches Phase 1 (Scan) in the",
+    "requirements-analyst agent.",
+    "",
+    "## Usage",
+    "",
+    "/scan-requirements <scope>",
+    "",
+    "Where `<scope>` is one of:",
+    "- `bcm:<PREFIX-NNN>` \u2014 a single BCM model doc",
+    "- `competitive:<slug>` \u2014 a single competitive analysis doc",
+    "- `product-roadmap` \u2014 the prioritized feature roadmap",
+    "- `entity-taxonomy` \u2014 the entity taxonomy doc",
+    "- `meeting:<slug>` \u2014 a meeting extract",
+    "- `all-bcm` / `all-competitive` \u2014 full sweep (long-running)",
+    "",
+    "## Steps",
+    "",
+    "1. Create a `req:scan` issue with `type:requirement`, `priority:medium`,",
+    "   and `status:ready`. Body must list the files to read and the scan scope.",
+    "2. Execute Phase 1 (Scan) of the requirements-analyst agent.",
+    "3. If gaps are found, a `req:draft` issue is created automatically.",
+    "",
+    "## Output",
+    "",
+    "- A `req-scan-<scope>-<YYYY-MM-DD>.md` file under the project's research",
+    "  requirements directory.",
+    "- A `req:draft` issue if any gaps were identified."
+  ].join("\n")
+};
+var requirementsAnalystBundle = {
+  name: "requirements-analyst",
+  description: "Requirements gap-discovery agent bundle for BCM-driven projects. 3-phase pipeline (scan, draft, trace) with req:* phase labels.",
+  appliesWhen: () => true,
+  rules: [
+    {
+      name: "requirements-analyst-workflow",
+      description: "Describes the 3-phase requirements gap-discovery pipeline, the req:* label taxonomy, and the boundary with the downstream requirements-writer agent.",
+      scope: AGENT_RULE_SCOPE.ALWAYS,
+      content: [
+        "# Requirements Analyst Workflow",
+        "",
+        "Use `/scan-requirements <scope>` to kick off a requirements gap",
+        "discovery cycle. The pipeline runs in 3 phases \u2014 scan, draft, trace \u2014",
+        "each tracked by its own GitHub issue labeled `req:scan`, `req:draft`,",
+        "or `req:trace`. All issues carry `type:requirement`.",
+        "",
+        "The requirements-analyst *discovers gaps and drafts proposals*; it",
+        "does **not** write final requirement documents. Writing is the job of",
+        "the downstream requirements-writer (BCM writer) agent. Keep that",
+        "boundary clean: proposals land under the research requirements",
+        "directory, not under the authoritative requirements tree.",
+        "",
+        "See the `requirements-analyst` agent definition for full workflow",
+        "details and phase-by-phase instructions."
+      ].join("\n"),
+      platforms: {
+        cursor: { exclude: true }
+      },
+      tags: ["workflow"]
+    }
+  ],
+  skills: [scanRequirementsSkill],
+  subAgents: [requirementsAnalystSubAgent],
+  labels: [
+    {
+      name: "type:requirement",
+      color: "1D76DB",
+      description: "Work that produces or discovers a requirement document (FR, BR, NFR, etc.)"
+    },
+    {
+      name: "req:scan",
+      color: "C5DEF5",
+      description: "Phase 1: scan source docs for requirement gaps and deduplicate"
+    },
+    {
+      name: "req:draft",
+      color: "BFDADC",
+      description: "Phase 2: draft requirement proposals for the requirements-writer"
+    },
+    {
+      name: "req:trace",
+      color: "D4C5F9",
+      description: "Phase 3: create requirement issues and backfill traceability on source docs"
+    }
+  ]
+};
+
 // src/agent/bundles/slack.ts
 var slackBundle = {
   name: "slack",
@@ -3582,7 +4051,8 @@ var BUILT_IN_BUNDLES = [
   slackBundle,
   meetingAnalysisBundle,
   orchestratorBundle,
-  prReviewBundle
+  prReviewBundle,
+  requirementsAnalystBundle
 ];
 
 // src/agent/bundles/scope.ts
@@ -7110,6 +7580,7 @@ var TypeScriptConfig = class extends import_projen22.Component {
   pnpmBundle,
   prReviewBundle,
   projenBundle,
+  requirementsAnalystBundle,
   resolveModelAlias,
   resolveTemplateVariables,
   slackBundle,