@codedrifters/configulator 0.0.290 → 0.0.291

package/lib/index.js

@@ -377,6 +377,7 @@ __export(index_exports, {
   renderSkillEvalsRuleContent: () => renderSkillEvalsRuleContent,
   renderSkillEvalsRunnerScript: () => renderSkillEvalsRunnerScript,
   renderSourceTierExamples: () => renderSourceTierExamples,
+  renderStubIndexConventionRuleContent: () => renderStubIndexConventionRuleContent,
   renderUnblockDependentsScript: () => renderUnblockDependentsScript,
   renderUnblockDependentsSection: () => renderUnblockDependentsSection,
   requirementsAnalystBundle: () => requirementsAnalystBundle,
@@ -837,13 +838,16 @@ var agendaAnalystSubAgent = {
     "   `duration_min` \xB1 5 minutes. If it doesn't, adjust section times",
     "   or cut content \u2014 do not ship a math-broken agenda.",
     "",
-    "7. **Create the folder `index.md` if missing.** Populate it with:",
+    "7. **Create the folder `index.md` if missing.** Populate it",
+    "   following the `stub-index-convention` rule:",
     "   - Frontmatter `title` (short sidebar label) and `description`",
     "     (one line).",
     "   - A 2\u20134 sentence summary of the meeting's objective and desired",
     "     outcomes pulled from the agenda.",
     "   - A `## Documents` section linking to `./agenda.md` (and",
     "     `./notes.md` once the meeting-analyst produces it).",
+    "   - No body `# Heading` \u2014 the frontmatter `title:` already",
+    "     renders as the page H1.",
     "",
     "   Do NOT set `sidebar.hidden: true` on `index.md` \u2014 it is the page",
     "   that should appear in the sidebar.",
@@ -1607,8 +1611,6 @@ function renderIssueTemplatesStarterPage(_it) {
     "description: Canonical gh issue create recipes \u2014 one per downstream phase label.",
     "---",
     "",
-    "# Issue Templates",
-    "",
     "This page lists the canonical `gh issue create` recipe for every",
     "downstream issue kind dispatched by an agent in this monorepo.",
     "Bundles and agent prompts cite the matching section below instead",
@@ -3043,6 +3045,71 @@ function assertValidProductContextPath(value) {
   }
 }
 
+// src/agent/bundles/stub-index-convention.ts
+function renderStubIndexConventionRuleContent() {
+  return [
+    "# Section Index Pages",
+    "",
+    "When any agent creates or updates an `index.md` (or `README.md`)",
+    "in a docs subdirectory under a Starlight content root, the file's",
+    "body must include:",
+    "",
+    "1. **A 1\u20132 paragraph summary** of the section's purpose and how",
+    "   it fits into the larger research, requirements, or capability",
+    "   area. Readers landing on the page should understand what's in",
+    "   the section without falling back to the sidebar.",
+    "",
+    "2. **A grouped, linked listing of the directory's children**",
+    "   (table or bullet list). When a natural taxonomy exists (e.g.",
+    "   organizations grouped by sub-segment, regulations grouped by",
+    "   jurisdiction, capabilities grouped by tier), use it. Otherwise",
+    "   sort alphabetically by title. Every listing entry must link",
+    "   to the child page.",
+    "",
+    "3. **No body `# Heading`.** Starlight renders the frontmatter",
+    "   `title:` as the page H1 automatically \u2014 a body H1 produces a",
+    "   duplicate. The same no-body-H1 contract that applies to skill",
+    "   templates and inline agent templates also applies to every",
+    "   index page emitted by an agent.",
+    "",
+    "## When this applies",
+    "",
+    "The convention applies to every `index.md` / `README.md` file",
+    "covered by the shared-index path globs documented in the",
+    "`shared-editing-safety` rule:",
+    "",
+    "- `docs/src/content/docs/**/index.md`",
+    "- `docs/src/content/docs/**/README.md`",
+    "",
+    "Any agent that scaffolds a new directory under a Starlight",
+    "content root MUST populate the directory's index page following",
+    "this contract \u2014 a one-sentence stub is not acceptable.",
+    "",
+    "## Reference shapes",
+    "",
+    "Existing rich indexes are the canonical reference shape. Examples:",
+    "",
+    "- A `<MEETINGS_ROOT>/<YYYY-MM-DD>-<slug>/index.md` populated by",
+    "  the `agenda-analyst` bundle: frontmatter `title` /",
+    "  `description`, a 2\u20134 sentence summary, and a `## Documents`",
+    "  section listing every page in the folder.",
+    "- A regulations scope index that opens with two paragraphs of",
+    "  context and groups every linked regulation under a",
+    "  `## Regulations` table by jurisdiction.",
+    "- A standards-organizations index that groups every linked",
+    "  organization under a `## Organizations` heading by role",
+    "  (governance, working group, implementer).",
+    "",
+    "## Out of scope",
+    "",
+    "- Auto-generated child listings via Astro/Starlight components.",
+    "  Agents emit hand-curated tables or bullet lists; the rule",
+    "  defines the shape, not the rendering technology.",
+    "- Backfilling pre-existing stub indexes is a downstream-consumer",
+    "  cleanup task, not a configulator change."
+  ].join("\n");
+}
+
 // src/agent/bundles/base.ts
 var createPackageSkill = {
   name: "create-package",
@@ -4128,6 +4195,16 @@ function buildBaseBundle(paths = DEFAULT_AGENT_PATHS) {
         },
         tags: ["workflow"]
       },
+      {
+        name: "stub-index-convention",
+        description: "Section-index convention: every agent-emitted `index.md` / `README.md` under a Starlight docs root carries a contextual summary plus a grouped, linked listing of the directory's children \u2014 and no body `# Heading` (Starlight renders the frontmatter `title:` as the page H1).",
+        scope: AGENT_RULE_SCOPE.ALWAYS,
+        content: renderStubIndexConventionRuleContent(),
+        platforms: {
+          cursor: { exclude: true }
+        },
+        tags: ["workflow"]
+      },
       {
         name: "skill-evals",
         description: "Skill eval harness contract: declarative prompt/expected-output regression suites per skill at `<skillsRoot>/<skill-name>/evals/evals.json`, parameterised by a shared product-context fixture so the same eval shape works across every configulator-consuming project without forking fixtures.",
@@ -4403,8 +4480,6 @@ function buildBcmWriterSubAgent(paths) {
       "   tier: L1 | L2 | L3",
       "   ---",
       "",
-      "   # BCM Outline: <Capability Name>",
-      "",
       "   ## Capability Name",
       "   <noun or noun phrase \u2014 never a verb>",
       "",
@@ -4484,8 +4559,6 @@ function buildBcmWriterSubAgent(paths) {
       "   date: YYYY-MM-DD",
       "   ---",
       "",
-      "   # <Capability Name>",
-      "",
       "   ## Capability Definitions",
       "   <1\u20132 sentences from the outline's Proposed Definition, refined>",
       "",
@@ -4895,8 +4968,6 @@ title: "Business Model: <Segment Name>"
 description: "Business Model Canvas analysis for the <segment name> segment of the <industry> industry."
 ---
 
-# Business Model: <Segment Name>
-
 | Field | Value |
 |-------|-------|
 | **Industry** | <industry name> |
@@ -5280,8 +5351,6 @@ function buildBusinessModelsAnalystSubAgent(paths) {
       "   status: complete",
       "   ---",
       "",
-      "   # Business Model Scan: <Industry Name>",
-      "",
       "   ## Source Inputs",
       "   - Industry plan: <relative path>",
       "   - Prior research: <relative path> (optional)",
@@ -5369,8 +5438,12 @@ function buildBusinessModelsAnalystSubAgent(paths) {
       "",
       "7. **Create the segment index** at",
       "   `<BUSINESS_MODELS_ROOT>/<industry>/segments/<SEGMENT_SLUG>/index.md`",
-      "   if it does not already exist. The index should carry a short",
-      "   description and link to `./business-model.md`.",
+      "   if it does not already exist. Follow the",
+      "   `stub-index-convention` rule: a 1\u20132 paragraph summary of the",
+      "   segment plus a linked listing of every page in the folder",
+      "   (`./business-model.md` and any value-stream / capability pages",
+      "   that land later). No body `# Heading` \u2014 the frontmatter",
+      "   `title:` already renders as the page H1.",
       "",
       "8. **Create one `business-models:complete` issue** with",
       "   `Depends on: #<canvas-issue>`. Its body references the path to",
@@ -6161,8 +6234,6 @@ function buildCompanyProfileAnalystSubAgent(paths) {
       "   parent_issue: <N>",
       "   ---",
       "",
-      "   # Research Notes: <company name>",
-      "",
       "   ## Framing",
       "   <why this company was requested and what to learn>",
       "",
@@ -6224,8 +6295,6 @@ function buildCompanyProfileAnalystSubAgent(paths) {
       "   referencedIn: []",
       "   ---",
       "",
-      "   # <company name>",
-      "",
       "   ## Summary",
       "   <2\u20134 sentence elevator description: what they do, who they sell to>",
       "",
@@ -6636,8 +6705,6 @@ function buildCompanyProfileAnalystSubAgent(paths) {
       "     - <relative path to profile 2>",
       "   ---",
       "",
-      "   # <segment name> Competitive Analysis",
-      "",
       "   ## Market Overview",
       "   <landscape summary \u2014 total players, market structure, trends",
       "    visible from the profiles>",
@@ -7200,8 +7267,6 @@ archetype: <ARCHETYPE_SLUG>
 segment: <SEGMENT_SLUG>
 ---
 
-# <Customer Archetype Name>
-
 | Field | Value |
 |-------|-------|
 | **Archetype** | <short noun phrase identifying the archetype> |
@@ -7567,8 +7632,6 @@ function buildCustomerProfileAnalystSubAgent(paths) {
       "   scope: <SCOPE_SLUG>",
       "   ---",
       "",
-      "   # Customer Discovery: <Scope>",
-      "",
       "   ## Scope Context",
       "   - **Scope:** <SCOPE_SLUG>",
       "   - **Sources scanned:** <counts by source type>",
@@ -7714,8 +7777,6 @@ function buildCustomerProfileAnalystSubAgent(paths) {
       "   archetype: <ARCHETYPE_SLUG>",
       "   ---",
       "",
-      "   # Competitors: <Archetype Name>",
-      "",
       "   ## Market Overview",
       "   <Brief overview of the competitive landscape this archetype",
       "   evaluates.>",
@@ -9622,8 +9683,6 @@ function buildIndustryDiscoveryAnalystSubAgent(paths) {
       "   candidate_count: <N>",
       "   ---",
       "",
-      "   # Industry Candidates: <scope>",
-      "",
       "   ## Scope",
       "   <verbatim scope statement from the issue>",
       "",
@@ -9684,8 +9743,6 @@ function buildIndustryDiscoveryAnalystSubAgent(paths) {
       "   threshold: <0.0\u20131.0>",
       "   ---",
       "",
-      "   # Industry Evaluation: <scope>",
-      "",
       "   ## Fit Rubric",
       "   <verbatim rubric table, including weights and threshold>",
       "",
@@ -9742,8 +9799,6 @@ function buildIndustryDiscoveryAnalystSubAgent(paths) {
       "   evaluation_source: <EVALUATIONS_DIR>/<DISCOVERY_SLUG>.evaluation.md",
       "   ---",
       "",
-      "   # Industry Plan: <scope>",
-      "",
       "   ## Cleared Verticals",
       "   | Vertical | Score | Downstream Issue |",
       "   |----------|-------|------------------|",
@@ -10196,8 +10251,6 @@ function buildMaintenanceAuditSubAgent(paths) {
       "   status: complete",
       "   ---",
       "",
-      "   # Maintenance Audit: <AUDIT_SLUG>",
-      "",
       "   ## Scope",
       "   - **Docs root:** `<DOCS_ROOT>`",
       "   - **Checks run:** <list of check categories>",
@@ -10319,8 +10372,6 @@ function buildMaintenanceAuditSubAgent(paths) {
       "   status: complete",
       "   ---",
       "",
-      "   # Maintenance Fix: <AUDIT_SLUG>",
-      "",
       "   ## Source Audit Report",
       "   <link to the Phase 1 audit report>",
       "",
@@ -10421,8 +10472,6 @@ function buildMaintenanceAuditSubAgent(paths) {
       "   status: complete",
       "   ---",
       "",
-      "   # Maintenance Verify: <AUDIT_SLUG>",
-      "",
       "   ## Source Reports",
       "   - Scan report: <link>",
       "   - Fix report: <link>",
@@ -14589,8 +14638,6 @@ function buildPeopleProfileAnalystSubAgent(paths) {
       "   parent_issue: <N>",
       "   ---",
       "",
-      "   # Research Notes: <person name>",
-      "",
       "   ## Framing",
       "   <why this person was requested and what to learn>",
       "",
@@ -14652,8 +14699,6 @@ function buildPeopleProfileAnalystSubAgent(paths) {
       "   notes: <NOTES_DIR>/<PERSON_SLUG>.notes.md",
       "   ---",
       "",
-      "   # <person name>",
-      "",
       "   ## Summary",
       "   <2\u20134 sentence elevator description: who they are, what they do,",
       "   why they matter to this project>",
@@ -17237,8 +17282,6 @@ jurisdiction: <federal | state | provincial | international | local>
 industry: <industry-slug or 'platform'>
 ---
 
-# <Regulation Name>
-
 | Field | Value |
 |-------|-------|
 | **Official name** | <full legal name> |
@@ -17609,8 +17652,6 @@ function buildRegulatoryResearchAnalystSubAgent(paths) {
       "   scope: <SCOPE_SLUG>",
       "   ---",
       "",
-      "   # Regulatory Scan: <Scope>",
-      "",
       "   ## Scope Context",
       "   - **Scope type:** <industry / jurisdiction / platform>",
       "   - **Scope identifier:** <SCOPE_SLUG>",
@@ -17661,7 +17702,12 @@ function buildRegulatoryResearchAnalystSubAgent(paths) {
       "",
       "7. **Create or update the scope index page** at",
       "   `<SCOPE_INDEX_PAGE>` so downstream regulations link back to a",
-      "   coherent landing page for the scope.",
+      "   coherent landing page for the scope. Follow the",
+      "   `stub-index-convention` rule: the body must carry a 1\u20132",
+      "   paragraph contextual summary plus a grouped, linked listing of",
+      "   every regulation in the scope (e.g. by jurisdiction). No body",
+      "   `# Heading` \u2014 the frontmatter `title:` already renders as the",
+      "   page H1.",
       "",
       "8. **Commit and push** the scan report and the scope index page.",
       "   Close the scan issue.",
@@ -18519,8 +18565,6 @@ function buildRequirementsAnalystSubAgent(paths) {
       "   status: complete",
       "   ---",
       "",
-      "   # Requirements Scan: <scope>",
-      "",
       "   ## Source Documents Reviewed",
       "   - <path> \u2014 <brief description>",
       "",
@@ -18656,42 +18700,32 @@ function buildRequirementsAnalystSubAgent(paths) {
       "   directory under `<REQUIREMENTS_ROOT>/<category>/` to find the next",
       "   available `NNN` for each proposed requirement.",
       "",
-      "5. **Create requirement issues.** For each proposal:",
+      "5. **Create requirement issues.** For each proposal, file a",
+      "   `req:write` issue using the canonical recipe documented in",
+      "   `## Template: req:write` of",
+      "   `docs/src/content/docs/agents/issue-templates.md`.",
       "",
       "   All `type:requirement` issues default to `priority:medium` (override",
       "   only if the proposal's priority was explicitly High or Low). Each",
       "   issue must also carry the `req:write` phase label plus the matching",
       "   `tier:*` label so the downstream `requirements-writer` bundle picks",
-      "   it up with the correct tier.",
-      "",
-      "   ```bash",
-      "   gh issue create \\",
-      '     --title "docs(<category>): <PREFIX>-<NNN> \u2014 <title>" \\',
-      '     --label "type:requirement" --label "req:write" --label "tier:<tier-slug>" --label "status:ready" --label "priority:medium" \\',
-      '     --body "## Objective',
-      "   Write <PREFIX>-<NNN> \u2014 <title>.",
-      "",
-      "   **Category:** <BR/FR/NFR/TR/ADR/SEC/DR/INT/OPS/UX/MT>",
-      "   **Tier:** <platform/industry/customer-workflow/consumer-app>",
-      "   **Output Path:** <REQUIREMENTS_ROOT>/<category-dir>/<PREFIX>-<NNN>-<slug>.md",
-      "",
-      "   ## Context",
-      "   - **Gap identified by:** requirements scan of <source>",
-      "   - **Proposals file:** <RESEARCH_REQUIREMENTS_ROOT>/req-proposals-<scope>-<date>.md",
+      "   it up with the correct tier. Concretely, the label list includes",
+      '   `--label "type:requirement"`, `--label "req:write"`,',
+      '   `--label "tier:<tier-slug>"`, `--label "status:ready"`, and',
+      '   `--label "priority:medium"`.',
       "",
-      "   ## Inputs / Read",
-      "   - **Depends on:** (none)",
-      "   - **Read:** <RESEARCH_REQUIREMENTS_ROOT>/req-proposals-<scope>-<date>.md, <source docs>",
+      "   The body must carry the three writer-required fields in an",
+      "   `## Objective` block, written as bold-prefixed lines so the",
+      "   writer's intake parser can pull them out:",
       "",
-      "   ## 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)",
+      "   - `**Category:** <BR/FR/NFR/TR/ADR/SEC/DR/INT/OPS/UX/MT>`",
+      "   - `**Tier:** <platform/industry/customer-workflow/consumer-app>`",
+      "   - `**Output Path:** <REQUIREMENTS_ROOT>/<category-dir>/<PREFIX>-<NNN>-<slug>.md`",
       "",
-      "   ## Scope Size",
-      '   small"',
-      "   ```",
+      "   Then under `## Inputs / Read`, list the proposals file",
+      "   (`<RESEARCH_REQUIREMENTS_ROOT>/req-proposals-<scope>-<date>.md`)",
+      "   and any source documents the writer should consult (BCM model",
+      "   docs, competitive analyses, product docs).",
       "",
       "   When one of Category / Tier / Output Path could not be derived",
       "   from the proposal (for example, the proposal omitted the Tier",
@@ -18867,8 +18901,6 @@ var TEMPLATE_BR = `---
 title: "BR-NNN: [Business Requirement Title]"
 ---
 
-# BR-NNN: [Business Requirement Title]
-
 ## Metadata
 
 | Field | Value |
@@ -18976,8 +19008,6 @@ var TEMPLATE_FR = `---
 title: "FR-NNN: [Functional Requirement Title]"
 ---
 
-# FR-NNN: [Functional Requirement Title]
-
 ## Metadata
 
 | Field | Value |
@@ -19117,8 +19147,6 @@ var TEMPLATE_NFR = `---
 title: "NFR-NNN: [Non-Functional Requirement Title]"
 ---
 
-# NFR-NNN: [Non-Functional Requirement Title]
-
 ## Metadata
 
 | Field | Value |
@@ -19219,8 +19247,6 @@ var TEMPLATE_TR = `---
 title: "TR-NNN: [Technical Requirement Title]"
 ---
 
-# TR-NNN: [Technical Requirement Title]
-
 ## Metadata
 
 | Field | Value |
@@ -19372,8 +19398,6 @@ var TEMPLATE_ADR = `---
 title: "ADR-NNN: [Decision Title]"
 ---
 
-# ADR-NNN: [Decision Title]
-
 ## Metadata
 
 | Field | Value |
@@ -19502,8 +19526,6 @@ var TEMPLATE_SEC = `---
 title: "SEC-NNN: [Security Requirement Title]"
 ---
 
-# SEC-NNN: [Security Requirement Title]
-
 ## Metadata
 
 | Field | Value |
@@ -19615,8 +19637,6 @@ var TEMPLATE_DR = `---
 title: "DR-NNN: [Data Requirement Title]"
 ---
 
-# DR-NNN: [Data Requirement Title]
-
 ## Metadata
 
 | Field | Value |
@@ -19731,8 +19751,6 @@ var TEMPLATE_INT = `---
 title: "INT-NNN: [Integration Requirement Title]"
 ---
 
-# INT-NNN: [Integration Requirement Title]
-
 ## Metadata
 
 | Field | Value |
@@ -19864,8 +19882,6 @@ var TEMPLATE_OPS = `---
 title: "OPS-NNN: [Operational Requirement Title]"
 ---
 
-# OPS-NNN: [Operational Requirement Title]
-
 ## Metadata
 
 | Field | Value |
@@ -19980,8 +19996,6 @@ var TEMPLATE_UX = `---
 title: "UX-NNN: [UX Requirement Title]"
 ---
 
-# UX-NNN: [UX Requirement Title]
-
 ## Metadata
 
 | Field | Value |
@@ -20098,8 +20112,6 @@ var TEMPLATE_MT = `---
 title: "MT-NNN: [Multi-Tenancy Requirement Title]"
 ---
 
-# MT-NNN: [Multi-Tenancy Requirement Title]
-
 ## Metadata
 
 | Field | Value |
@@ -20252,8 +20264,6 @@ var TEMPLATE_REQUIREMENTS_README = `---
 title: "[Project Name] \u2014 Requirements Documentation"
 ---
 
-# [Project Name] \u2014 Requirements Documentation
-
 This directory contains the structured requirements taxonomy for [Project Name]. It covers the full lifecycle from business intent through operational concerns, providing traceability between strategic goals and implementation work.
 
 ## Taxonomy Overview
@@ -21010,12 +21020,9 @@ function buildRequirementsWriterSubAgent(paths) {
       "tier: platform",
       "---",
       "",
-      "# FR-001: User Registration",
-      "",
       "...",
       "```",
       "",
-      "The `title` value must match the document's `# Heading` line.",
       "Titles containing colons must be wrapped in double quotes. The",
       "`tier` field must be one of `platform`, `industry`,",
       "`customer-workflow`, or `consumer-app` (use whatever tier slugs the",
@@ -23079,8 +23086,6 @@ function buildResearchAnalystSubAgent(paths) {
       "   slice_count: <N>",
       "   ---",
       "",
-      "   # Research Scope: <question>",
-      "",
       "   ## Question",
       "   <verbatim question from the issue>",
       "",
@@ -23150,8 +23155,6 @@ function buildResearchAnalystSubAgent(paths) {
       "   parent_issue: <N>",
       "   ---",
       "",
-      "   # Slice NN: <title>",
-      "",
       "   ## Question",
       "   <the slice-level question>",
       "",
@@ -23216,8 +23219,6 @@ function buildResearchAnalystSubAgent(paths) {
       "   slices_read: <count>",
       "   ---",
       "",
-      "   # Verification Report: <question>",
-      "",
       "   ## Acceptance Criteria Coverage",
       "   - [x] <criterion> \u2014 covered by slice(s) <NN, NN>",
       "   - [ ] <criterion> \u2014 **not covered**; gap noted in deliverable",
@@ -23825,8 +23826,6 @@ function buildSoftwareProfileAnalystSubAgent(paths) {
       "   parent_issue: <N>",
       "   ---",
       "",
-      "   # Research Notes: <product name>",
-      "",
       "   ## Framing",
       "   <why this product was requested and what to learn>",
       "",
@@ -23887,8 +23886,6 @@ function buildSoftwareProfileAnalystSubAgent(paths) {
       "   notes: <NOTES_DIR>/<PRODUCT_SLUG>.notes.md",
       "   ---",
       "",
-      "   # <product name>",
-      "",
       "   ## Summary",
       "   <2\u20134 sentence elevator description: what it does, who it's for>",
       "",
@@ -23973,8 +23970,6 @@ function buildSoftwareProfileAnalystSubAgent(paths) {
       "updated: YYYY-MM-DD",
       "---",
       "",
-      "# Software Feature Matrix",
-      "",
       "| product | feature | <segment-1> | <segment-2> | ... | score | source |",
       "|---------|---------|-------------|-------------|-----|-------|--------|",
       "| <slug>  | <feature-name> | 0\u20131 | 0\u20131 | ... | <weighted-sum> | <profile-path> |",
@@ -24602,8 +24597,6 @@ title: "<Standard Name>"
 description: "Overview and cross-version comparison of <Standard Name>."
 ---
 
-# <Standard Name>
-
 | Field | Value |
 |-------|-------|
 | **Standard** | <standard name> |
@@ -24921,8 +24914,6 @@ function buildStandardsResearchAnalystSubAgent(paths) {
       "   standard: <STANDARD_SLUG>",
       "   ---",
       "",
-      "   # Query Plan: <Standard Name>",
-      "",
       "   ## Context",
       "   <1\u20132 paragraphs on why this standard matters to the consuming",
       "   project and what gaps this research campaign fills.>",
@@ -25124,7 +25115,14 @@ function buildStandardsResearchAnalystSubAgent(paths) {
       "   the overview page, then populate each section from the version",
       "   pages.",
       "",
-      "4. **Write the overview page** at `<OVERVIEW_PAGE>`. Fill:",
+      "4. **Write the overview page** at `<OVERVIEW_PAGE>`. Follow",
+      "   the `stub-index-convention` rule: the body opens with a",
+      "   1\u20132 paragraph contextual summary of the standard and its",
+      "   versions, and the version pages, modules, and extensions",
+      "   sections below double as the grouped, linked listing of",
+      "   every child page in the standard's folder. No body",
+      "   `# Heading` \u2014 the frontmatter `title:` already renders as",
+      "   the page H1. Required sections to fill:",
       "   - **Version Timeline** \u2014 publication dates, status, milestones",
       "   - **Module / Resource Maturity Progression** \u2014 matrix with",
       "     modules as rows and versions as columns, using the standard's",
@@ -33085,6 +33083,7 @@ var TypeScriptConfig = class extends import_projen23.Component {
   renderSkillEvalsRuleContent,
   renderSkillEvalsRunnerScript,
   renderSourceTierExamples,
+  renderStubIndexConventionRuleContent,
   renderUnblockDependentsScript,
   renderUnblockDependentsSection,
   requirementsAnalystBundle,