@codedrifters/configulator 0.0.263 → 0.0.264

package/lib/index.mjs

@@ -9333,7 +9333,7 @@ var REQ_WRITE_ISSUE_SCHEMA_SECTION = [
 // 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.",
+  description: "Discovers requirement gaps from BCM model docs, competitive analysis, product docs, and meeting extracts. Produces scan reports, proposals, and req:write issues for the downstream requirements-writer agent. Runs through a 2-phase pipeline (scan \u2192 draft-trace), one phase per session, tracked by req:* GitHub issue labels.",
   model: AGENT_MODEL.POWERFUL,
   maxTurns: 80,
   platforms: { cursor: { exclude: true } },
@@ -9374,35 +9374,39 @@ var requirementsAnalystSubAgent = {
     "",
     "## State Machine Overview",
     "",
-    "Requirements synthesis flows through **3 phases**:",
+    "Requirements synthesis flows through **2 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",
+    "\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\u2500\u2500\u2500\u2500\u2510",
+    "\u2502  1. SCAN     \u2502\u2500\u2500\u2500\u2500\u25B6\u2502  2. DRAFT-TRACE  \u2502",
+    "\u2502  Read docs,  \u2502     \u2502  Write proposals,\u2502",
+    "\u2502  identify    \u2502     \u2502  create req:write\u2502",
+    "\u2502  gaps, check \u2502     \u2502  issues, update  \u2502",
+    "\u2502  for dupes   \u2502     \u2502  source docs     \u2502",
+    "\u2502              \u2502     \u2502  with 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\u2500\u2500\u2500\u2500\u2518",
     "```",
     "",
+    "This pipeline matches the `scan \u2192 draft-trace \u2192 write` pattern",
+    "used by the sibling openhi project. Draft and Trace were previously",
+    "separate phases; they were collapsed because the proposals file Draft",
+    "wrote was only ever consumed by Trace (no human review, no async work",
+    "between the two), so the phase boundary added latency without value.",
+    "See ADR-009 for the full reasoning.",
+    "",
     "**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 |",
+    "| `req:draft-trace` | 2. Draft & Trace | Write proposals, create `req:write` GitHub issues for each proposal, and update source documents with traceability notes \u2014 all in a single session |",
     "",
     "All issues also carry `type:requirement` and a `status:*` label.",
     "",
-    "**Issue count per scan cycle:** 1 scan + 1 draft + 1 trace = **3 sessions**.",
+    "**Issue count per scan cycle:** 1 scan + 1 draft-trace = **2 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)",
+    "- No gaps found after scan \u2192 skip draft-trace \u2192 **1 session**",
     "",
     "---",
     "",
@@ -9431,7 +9435,7 @@ var requirementsAnalystSubAgent = {
     "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`.",
+    "   `req:scan` > `req:draft-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.",
@@ -9532,7 +9536,7 @@ var requirementsAnalystSubAgent = {
     "   ```",
     "",
     "7. **Create downstream issues based on findings:**",
-    "   - If any new gaps were identified \u2192 create `req:draft` issue",
+    "   - If any new gaps were identified \u2192 create `req:draft-trace` 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",
@@ -9543,12 +9547,54 @@ var requirementsAnalystSubAgent = {
     "",
     "---",
     "",
-    "## Phase 2: Draft (`req:draft`)",
+    "## Phase 2: Draft & Trace (`req:draft-trace`)",
+    "",
+    "**Goal:** Expand each identified gap into a requirement proposal, create",
+    "a `req:write` GitHub issue for each proposal so the downstream",
+    "`requirements-writer` bundle picks it up, and backfill source-document",
+    "traceability notes \u2014 all in a single session.",
+    "",
+    "**Budget:** No web searches. Reading + writing proposals + issue creation",
+    "+ minor traceability edits to source documents.",
+    "",
+    "Draft and Trace were previously separate phases. They were collapsed",
+    "because the proposals file written by Draft was only ever consumed by",
+    "Trace \u2014 no human review, no async work, no CI validation sat between",
+    "them. See ADR-009 for the decision record.",
+    "",
+    "### `req:write` issue schema",
+    "",
+    "The `req:write` issues this phase creates are picked up by the",
+    "downstream `requirements-writer` agent, which parses a strict",
+    "schema on intake. The authoritative schema is defined in the",
+    "`requirements-writer` sub-agent prompt under **The `req:write`",
+    "Issue Schema** \u2014 every `req:write` issue this phase opens must",
+    "conform. The same schema is embedded in the",
+    "`requirements-reviewer` follow-up generator so the three",
+    "producers never drift apart.",
+    "",
+    ...REQ_WRITE_ISSUE_SCHEMA_SECTION,
+    "",
+    "**Deriving the three required fields from the proposal.** For",
+    "every `req:write` issue this phase opens, the three fields come",
+    "directly from the proposal entry written earlier in the same",
+    "session:",
     "",
-    "**Goal:** Expand each identified gap into a requirement proposal with enough",
-    "detail for the requirements-writer to produce a full document.",
+    "- **Category** \u2014 the proposal's `**Category:**` line.",
+    "- **Tier** \u2014 the proposal's `**Tier:**` line.",
+    "- **Output Path** \u2014",
+    "  `<REQUIREMENTS_ROOT>/<category-dir>/<PREFIX>-<NNN>-<slug>.md`,",
+    "  using the sequence number determined in the proposal step below.",
     "",
-    "**Budget:** No web searches. Reading + writing.",
+    "**Validation step \u2014 required before opening the issue.** Before",
+    "calling `gh issue create`, verify all three required fields are",
+    "populated and internally consistent (Category matches title",
+    "prefix, Tier matches `tier:*` label, Output Path filename starts",
+    "with the Category prefix). If any field cannot be derived, open",
+    "the issue with `status:needs-attention` (not `status:ready`) and",
+    "include a `Missing: <field> \u2014 <one-line reason>` line so a human",
+    "triaging the issue only has to supply the remaining value(s)",
+    "before flipping the label to `status:ready`.",
     "",
     "### Steps",
     "",
@@ -9599,61 +9645,7 @@ var requirementsAnalystSubAgent = {
     "   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.",
-    "",
-    "### `req:write` issue schema",
-    "",
-    "The `req:write` issues this phase creates are picked up by the",
-    "downstream `requirements-writer` agent, which parses a strict",
-    "schema on intake. The authoritative schema is defined in the",
-    "`requirements-writer` sub-agent prompt under **The `req:write`",
-    "Issue Schema** \u2014 every `req:write` issue this phase opens must",
-    "conform. The same schema is embedded in the",
-    "`requirements-reviewer` follow-up generator so the three",
-    "producers never drift apart.",
-    "",
-    ...REQ_WRITE_ISSUE_SCHEMA_SECTION,
-    "",
-    "**Deriving the three required fields from the proposal.** For",
-    "every `req:write` issue this phase opens, the three fields come",
-    "directly from the Phase 2 proposal entry:",
-    "",
-    "- **Category** \u2014 the proposal's `**Category:**` line.",
-    "- **Tier** \u2014 the proposal's `**Tier:**` line (added in Phase 2).",
-    "  If the proposal omitted the Tier line (older proposals may),",
-    "  route the issue through `Missing:` rather than guessing.",
-    "- **Output Path** \u2014",
-    "  `<REQUIREMENTS_ROOT>/<category-dir>/<PREFIX>-<NNN>-<slug>.md`,",
-    "  using the sequence number determined in Phase 2 step 4.",
-    "",
-    "**Validation step \u2014 required before opening the issue.** Before",
-    "calling `gh issue create`, verify all three required fields are",
-    "populated and internally consistent (Category matches title",
-    "prefix, Tier matches `tier:*` label, Output Path filename starts",
-    "with the Category prefix). If any field cannot be derived, open",
-    "the issue with `status:needs-attention` (not `status:ready`) and",
-    "include a `Missing: <field> \u2014 <one-line reason>` line so a human",
-    "triaging the issue only has to supply the remaining value(s)",
-    "before flipping the label to `status:ready`.",
-    "",
-    "### Steps",
-    "",
-    "1. **Read the proposals** from Phase 2.",
-    "",
-    "2. **Create requirement issues.** For each proposal:",
+    "5. **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). Each",
@@ -9698,7 +9690,7 @@ var requirementsAnalystSubAgent = {
     "   whichever of the three fields **could** be derived so a human",
     "   triaging the issue has the minimum possible cleanup.",
     "",
-    "3. **Update source documents.** In each BCM model doc or competitive",
+    "6. **Update source documents.** In each BCM model doc or competitive",
     "   analysis that was scanned, add a note in the project-relevance /",
     "   strategic-implications section (whichever heading the source doc uses)",
     "   indicating that a requirement issue was created:",
@@ -9708,10 +9700,10 @@ var requirementsAnalystSubAgent = {
     "     (issue #<N>)",
     "   ```",
     "",
-    "4. **Comment on the scan issue** with a summary of all issues created and",
+    "7. **Comment on the scan issue** with a summary of all issues created and",
     "   all docs updated.",
     "",
-    "5. **Commit and push.**",
+    "8. **Commit and push.**",
     "",
     "---",
     "",
@@ -9789,39 +9781,41 @@ var scanRequirementsSkill = {
     "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.",
+    "3. If gaps are found, a `req:draft-trace` 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."
+    "- A `req:draft-trace` 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.",
+  description: "Requirements gap-discovery agent bundle for BCM-driven projects. 2-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.",
+      description: "Describes the 2-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` agent (a separate bundle).",
+        "discovery cycle. The pipeline runs in 2 phases \u2014 scan and",
+        "draft-trace \u2014 each tracked by its own GitHub issue labeled",
+        "`req:scan` or `req:draft-trace`. All issues carry",
+        "`type:requirement`.",
+        "",
+        "The requirements-analyst *discovers gaps, drafts proposals, and",
+        "opens `req:write` issues for the downstream writer*; it does",
+        "**not** write final requirement documents. Writing is the job of",
+        "the downstream `requirements-writer` agent (a separate bundle).",
         "Keep that boundary clean: proposals land under the research",
         "requirements directory, not under the authoritative requirements",
-        "tree. The trace phase tags new issues with `req:write` so the",
-        "writer bundle picks them up automatically.",
+        "tree. The draft-trace phase tags new issues with `req:write` so",
+        "the writer bundle picks them up automatically.",
         "",
         "See the `requirements-analyst` agent definition for full workflow",
         "details and phase-by-phase instructions."
@@ -9846,14 +9840,9 @@ var requirementsAnalystBundle = {
       description: "Phase 1: scan source docs for requirement gaps and deduplicate"
     },
     {
-      name: "req:draft",
+      name: "req:draft-trace",
       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"
+      description: "Phase 2: draft proposals, create req:write issues, and backfill source-doc traceability"
     }
   ]
 };
@@ -11737,8 +11726,8 @@ var requirementsWriterSubAgent = {
     "This agent produces **requirement documents only** \u2014 capability",
     "models are written by the `bcm-writer` agent and requirement-gap",
     "discovery is the responsibility of the `requirements-analyst` agent.",
-    "Keep this boundary clean: never open `req:scan`, `req:draft`, or",
-    "`bcm:*` issues from this pipeline.",
+    "Keep this boundary clean: never open `req:scan`,",
+    "`req:draft-trace`, or `bcm:*` issues from this pipeline.",
     "",
     "Follow your project's shared agent conventions (`AGENTS.md`,",
     "`CLAUDE.md`, or equivalent) for all commit, branch, and PR rules.",
@@ -12272,7 +12261,7 @@ var requirementsWriterSubAgent = {
     "specialized upstream/downstream agents.",
     "",
     "**Do NOT create:**",
-    "- `req:scan`, `req:draft`, or `req:trace` issues \u2014 those belong to",
+    "- `req:scan` or `req:draft-trace` issues \u2014 those belong to",
     "  the `requirements-analyst` bundle",
     "- `bcm:*` issues \u2014 those belong to the `bcm-writer` bundle",
     "- `people:*`, `company:*`, `software:*`, `research:*`, or",
@@ -12320,8 +12309,8 @@ var requirementsWriterSubAgent = {
     "  exists as a file but is missing from its category index is",
     "  invisible to anyone browsing the documentation tree.",
     "- **Write requirements, not capability models or gap reports.**",
-    "  Never open `req:scan`, `req:draft`, `req:trace`, or `bcm:*` issues",
-    "  from this pipeline."
+    "  Never open `req:scan`, `req:draft-trace`, or `bcm:*` issues from",
+    "  this pipeline."
   ].join("\n")
 };
 var writeRequirementSkill = {
@@ -12416,8 +12405,8 @@ var requirementsWriterBundle = {
         "The pipeline produces **requirement documents only** \u2014 capability",
         "models are written by the `bcm-writer` agent and gap discovery is",
         "the responsibility of the `requirements-analyst` agent. The",
-        "writer never opens `req:scan`, `req:draft`, `req:trace`, or",
-        "`bcm:*` issues.",
+        "writer never opens `req:scan`, `req:draft-trace`, or `bcm:*`",
+        "issues.",
         "",
         "Documents follow the 11-category taxonomy (BR, FR, NFR, TR, ADR,",
         "SEC, DR, INT, OPS, UX, MT) and the four-tier classification",
@@ -12523,8 +12512,8 @@ var requirementsReviewerSubAgent = {
     "`requirements-writer` bundle (requirement docs) and `bcm-writer`",
     "bundle (capability models). Gap discovery belongs to the",
     "`requirements-analyst` bundle. Keep this boundary clean: never open",
-    "`req:scan`, `req:draft`, `req:trace`, `req:review`, or `bcm:*`",
-    "issues from this pipeline. The only follow-ups you open are the",
+    "`req:scan`, `req:draft-trace`, `req:review`, or `bcm:*` issues",
+    "from this pipeline. The only follow-ups you open are the",
     "`req:write` issues documented below.",
     "",
     "Follow your project's shared agent conventions (`AGENTS.md`,",
@@ -12737,8 +12726,8 @@ var requirementsReviewerSubAgent = {
     "doc and must be rewritten or removed). Route follow-up issues to",
     "`req:write` so the `requirements-writer` \u2014 the only agent scoped",
     "to edit under `<REQUIREMENTS_ROOT>` \u2014 picks them up. Do **not**",
-    "route Check 4 findings to `req:trace`; the analyst bundle does",
-    "not edit requirement documents and the issue would sit",
+    "route Check 4 findings to `req:draft-trace`; the analyst bundle",
+    "does not edit requirement documents and the issue would sit",
     "unresolved. See the Follow-Up Issues section below for the full",
     "Check 3 vs. Check 4 routing split.",
     "",
@@ -13157,11 +13146,12 @@ var requirementsReviewerSubAgent = {
     "    docs, competitive-analysis notes, product-roadmap entries,",
     "    meeting extracts \u2014 that should link forward to an existing",
     "    requirement (Check 3: orphaned requirements whose fix lives",
-    "    in the source tree, not the requirement doc) \u2192 `req:trace`",
+    "    in the source tree, not the requirement doc) \u2192 `req:draft-trace`",
     "    (the `requirements-analyst` agent picks it up to backfill",
-    "    source-doc traceability). **Do not** route Check 4 broken",
-    "    cross-references here \u2014 the analyst bundle never writes to",
-    "    `<REQUIREMENTS_ROOT>` and the issue would sit unresolved.",
+    "    source-doc traceability inside its combined draft-trace phase).",
+    "    **Do not** route Check 4 broken cross-references here \u2014 the",
+    "    analyst bundle never writes to `<REQUIREMENTS_ROOT>` and the",
+    "    issue would sit unresolved.",
     "  - A new requirement is needed (e.g., a `Proposed` ADR is missing",
     "    for a deferred technology choice) \u2192 `req:scan` (the analyst",
     "    runs a scoped scan to confirm the gap, then drafts the new",
@@ -13175,7 +13165,7 @@ var requirementsReviewerSubAgent = {
     "",
     "**Check 12 exception \u2014 stale `Proposed` ADR/TR triage.** Check 12",
     "findings are the one case where follow-up flows through a new",
-    "`req:review` issue rather than `req:write` / `req:trace` /",
+    "`req:review` issue rather than `req:write` / `req:draft-trace` /",
     "`req:scan`. The finding is a decision a human must make, not an",
     "edit to a requirement document, so:",
     "",
@@ -13615,8 +13605,9 @@ var reviewRequirementsSkill = {
     "- One verification script under `<REVIEW_REPORTS_ROOT>` (only",
     "  for audits >10 documents)",
     "- Follow-up GitHub issues for every Critical and Warning finding,",
-    "  carrying the appropriate phase label (`req:write`, `req:trace`,",
-    "  or `req:scan`) for the downstream agent that should act",
+    "  carrying the appropriate phase label (`req:write`,",
+    "  `req:draft-trace`, or `req:scan`) for the downstream agent that",
+    "  should act",
     "- An aggregated `req:review` follow-up issue labeled",
     "  `status:needs-attention` when Check 12 surfaces stale `Proposed`",
     "  ADR/TR documents (one issue per review, not one per document);",
@@ -13771,9 +13762,9 @@ var requirementsReviewerBundle = {
         "The review phase produces **review reports and follow-up issues",
         "only** \u2014 it never edits requirement documents, capability",
         "models, or research notes. It files follow-up issues with the",
-        "appropriate phase label (`req:write`, `req:trace`, `req:scan`,",
-        "or \u2014 only for Check 12 stale-decision triage \u2014 `req:review`)",
-        "for the downstream agent or human to pick up.",
+        "appropriate phase label (`req:write`, `req:draft-trace`,",
+        "`req:scan`, or \u2014 only for Check 12 stale-decision triage \u2014",
+        "`req:review`) for the downstream agent or human to pick up.",
         "",
         "For audits covering more than 10 documents, the reviewer writes",
         "a read-only Python verification script alongside the report and",
@@ -13816,9 +13807,9 @@ var requirementsReviewerBundle = {
         "Authoring remains the responsibility of the `requirements-writer`",
         "(requirement docs) and `bcm-writer` (capability models) bundles.",
         "Gap discovery is the responsibility of the `requirements-analyst`",
-        "bundle. The reviewer never opens `req:scan`, `req:draft`,",
-        "`req:trace`, `req:review`, or `bcm:*` issues \u2014 only `req:write`",
-        "follow-ups from either phase.",
+        "bundle. The reviewer never opens `req:scan`, `req:draft-trace`,",
+        "`req:review`, or `bcm:*` issues \u2014 only `req:write` follow-ups",
+        "from either phase.",
         "",
         "**Soft dependency on the `requirements-writer` bundle.** The",
         "reviewer reads category templates from",