@codedrifters/configulator 0.0.248 → 0.0.250

package/lib/index.mjs

@@ -869,7 +869,36 @@ var baseBundle = {
         "- **Never edit generated files** \u2014 they are marked with `// ~~ Generated by projen`",
         "- **After modifying Projen configuration**, run `pnpm exec projen` to regenerate files, then `pnpm install` to update the lockfile.",
         "- **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"
+        "- **Export from index.ts** to maintain clean public APIs",
+        "",
+        "## Repository Layout",
+        "",
+        "Every monorepo built with `@codedrifters/configulator` uses a fixed",
+        "top-level folder layout. Read a sub-project's role directly from its",
+        "outdir:",
+        "",
+        "| Folder | Purpose |",
+        "|--------|---------|",
+        "| `/docs` | **Single** monorepo-wide Starlight docs site (the one site that lives outside `/sites`). |",
+        "| `/apps/@scope/<name>` | Deployable applications (CDK stacks, mobile apps, backend services). |",
+        "| `/packages/@scope/<name>` | Shared libraries (published npm packages and workspace-internal libraries). |",
+        "| `/sites/@scope/<name>` | User-facing web front ends that are **not** the monorepo-wide docs site. |",
+        "",
+        "Every sub-project under `apps/`, `packages/`, or `sites/` is named",
+        "`@ownerscope/<name>`, where **scope is the owning party** (not a",
+        "category). Kind is captured by the top-level folder \u2014 never scope by",
+        "category (e.g. `@apps/foo`, `@libs/bar`).",
+        "",
+        "To place a **new** sub-project, always use a scaffolding skill \u2014 never",
+        "hand-roll the path:",
+        "",
+        "- `/create-package` \u2014 new shared library under `packages/<scope>/<name>`",
+        "- `/create-app` \u2014 new deployable app under `apps/<scope>/<name>`",
+        "- `/create-site` \u2014 new web front end under `sites/<scope>/<name>`",
+        "",
+        "The `monorepo-layout` rule documents the full contract (outdir",
+        "defaults per project type, the docs-singleton carve-out, synth-time",
+        "enforcement)."
       ].join("\n"),
       tags: ["project"]
     },
@@ -1220,8 +1249,8 @@ var baseBundle = {
         "at `/docs`. It is **not** `sites/@scope/docs`.",
         "",
         "- The docs site is monorepo-wide. Sub-project documentation belongs",
-        "  inside that single site (under `docs/content/`), not in a per-package",
-        "  `docs/` folder.",
+        "  inside that single site (under `docs/src/content/docs/`), not in a",
+        "  per-package `docs/` folder.",
         "- Configulator's `StarlightProject` defaults its `outdir` to `/docs` and",
         '  its `role` to `"docs"`. A second `StarlightProject` with `role: "docs"`',
         "  fails synth \u2014 the singleton rule is enforced at validate time.",
@@ -1314,7 +1343,7 @@ var baseBundle = {
 };
 
 // src/agent/bundles/project-context.ts
-var PROJECT_CONTEXT_PATH = "docs/project-context.md";
+var PROJECT_CONTEXT_PATH = "docs/src/content/docs/project-context.md";
 var SUBPROJECT_ROLE_GUIDANCE = [
   "### Sub-project roles",
   "",
@@ -1486,7 +1515,7 @@ var bcmWriterSubAgent = {
     "   map rating), L1/L2/L3 decomposition with business-object focus,",
     "   and value stream cross-mapping are preserved verbatim. Only",
     "   *paths* are parameterized; vocabulary is not.",
-    "5. **Project Relevance comes from `docs/project-context.md`.** The",
+    "5. **Project Relevance comes from `docs/src/content/docs/project-context.md`.** The",
     "   Project Relevance section of every BCM document is framed against",
     "   the mission, target users, and in/out-of-scope capabilities",
     "   captured in that file. Never invent project framing.",
@@ -1521,7 +1550,7 @@ var bcmWriterSubAgent = {
     "|-------|-------|-------------|",
     "| `bcm:outline` | 1. Outline | Identify the capability (name-as-noun, business object, L1/L2/L3 tier). Write a short outline file in the outline working directory. Create the scaffold issue. |",
     "| `bcm:scaffold` | 2. Scaffold | Create the BCM document with BIZBOK section headings and placeholder content for each attribute. Create the context issue. |",
-    "| `bcm:context` | 3. Context | Fill Project Relevance (framed against `docs/project-context.md`), Value Stream Mapping, Enabling Software Systems, Roles Involved, and Company Size Applicability. Create the connect issue. |",
+    "| `bcm:context` | 3. Context | Fill Project Relevance (framed against `docs/src/content/docs/project-context.md`), Value Stream Mapping, Enabling Software Systems, Roles Involved, and Company Size Applicability. Create the connect issue. |",
     "| `bcm:connect` | 4. Connect | Cross-link with parent/sibling capabilities, update the capability registry `_index.md` and capability-map file, and open downstream research issues for surfaced people/companies/requirement gaps. |",
     "",
     "All issues also carry `type:bcm-document` and a `status:*` label.",
@@ -1534,7 +1563,7 @@ var bcmWriterSubAgent = {
     "**Shortened paths:**",
     "- **Outline determines the capability is out of scope** (duplicate of",
     "  an existing capability, not a business capability, or clearly not",
-    "  relevant per `docs/project-context.md`) \u2192 outline issue closes with",
+    "  relevant per `docs/src/content/docs/project-context.md`) \u2192 outline issue closes with",
     "  a justification and no downstream issues are created \u2192 **1",
     "  session**.",
     "- **Scaffold reuses an existing BCM document** (the capability turned",
@@ -1558,15 +1587,15 @@ var bcmWriterSubAgent = {
     "",
     "| Placeholder | Meaning | Default |",
     "|-------------|---------|---------|",
-    "| `<BCM_DOC_ROOT>` | Root folder for all BCM capability-model documents | `docs/bcm/` |",
-    "| `<OUTLINE_ROOT>` | Working-directory root for outline files produced in Phase 1 | `docs/bcm/.outlines/` |",
+    "| `<BCM_DOC_ROOT>` | Root folder for all BCM capability-model documents | `docs/src/content/docs/concepts/` |",
+    "| `<OUTLINE_ROOT>` | Working-directory root for outline files produced in Phase 1 | `docs/src/content/docs/concepts/.outlines/` |",
     "| `<REGISTRY_INDEX>` | Capability registry `_index.md` file that lists every BCM doc | `<BCM_DOC_ROOT>/_index.md` |",
     "| `<CAPABILITY_MAP>` | Capability-map file that shows the L1/L2/L3 hierarchy | `<BCM_DOC_ROOT>/capability-map.md` |",
     "| `<ENTITY_TAXONOMY>` | Entity-taxonomy / product-context file used for business-object alignment | `docs/product/entity-taxonomy.md` |",
     "| `<BCM_SLUG>` | Short kebab-case slug identifying one BCM capability | derived from the capability name |",
-    "| `<PREFIX>` | Optional project-specific BCM ID prefix | derived from `docs/project-context.md` if specified |",
+    "| `<PREFIX>` | Optional project-specific BCM ID prefix | derived from `docs/src/content/docs/project-context.md` if specified |",
     "",
-    "If `docs/project-context.md` specifies a different BCM tree, prefer",
+    "If `docs/src/content/docs/project-context.md` specifies a different BCM tree, prefer",
     "that. Otherwise fall back to the defaults above.",
     "",
     "---",
@@ -1588,7 +1617,7 @@ var bcmWriterSubAgent = {
     "| **Definition** | 1\u20132 sentences | Describes what the capability is and its boundary \u2014 not how it is implemented. |",
     "| **Outcome** | 1 sentence | The measurable result the capability produces for the business. |",
     "| **Tier** | `L1` / `L2` / `L3` | L1 = top-level domain, L2 = mid-level grouping, L3 = granular capability that maps to one business object. |",
-    "| **Heat Map Rating** | `critical` / `high` / `medium` / `low` | Strategic importance to the business. Sourced from `docs/project-context.md` or the invoking issue \u2014 never invented. |",
+    "| **Heat Map Rating** | `critical` / `high` / `medium` / `low` | Strategic importance to the business. Sourced from `docs/src/content/docs/project-context.md` or the invoking issue \u2014 never invented. |",
     "",
     "### L1 / L2 / L3 Decomposition",
     "",
@@ -1616,7 +1645,7 @@ var bcmWriterSubAgent = {
     "- The input/output business objects at each stage",
     "",
     "Value streams are authoritative inputs \u2014 they come from",
-    "`docs/project-context.md`, a dedicated value-stream doc under",
+    "`docs/src/content/docs/project-context.md`, a dedicated value-stream doc under",
     "`<BCM_DOC_ROOT>`, or the invoking issue. If no value stream is",
     "defined, write a `TODO: value stream not yet defined` placeholder and",
     "flag the context issue with `status:needs-attention`. Never invent",
@@ -1644,7 +1673,7 @@ var bcmWriterSubAgent = {
     "and write a short outline file that the scaffold phase will use as its",
     "spec.",
     "",
-    "**Budget:** Reading the invoking issue, `docs/project-context.md`, the",
+    "**Budget:** Reading the invoking issue, `docs/src/content/docs/project-context.md`, the",
     "capability map, the entity taxonomy, and the registry `_index.md`.",
     "Write one outline file. No BCM document is created in this phase.",
     "",
@@ -1656,7 +1685,7 @@ var bcmWriterSubAgent = {
     "   any proposed tier, and any authoritative references (value streams,",
     "   existing parents/siblings, source meeting, source requirement).",
     "",
-    "2. **Read `docs/project-context.md`** for mission, in/out-of-scope",
+    "2. **Read `docs/src/content/docs/project-context.md`** for mission, in/out-of-scope",
     "   capabilities, domain vocabulary, and any BCM-specific overrides",
     "   (paths, prefix, heat-map inputs).",
     "",
@@ -1800,7 +1829,7 @@ var bcmWriterSubAgent = {
     "   TODO: filled in Phase 3 (Context).",
     "",
     "   ## Project Relevance",
-    "   TODO: filled in Phase 3 (Context) from docs/project-context.md.",
+    "   TODO: filled in Phase 3 (Context) from docs/src/content/docs/project-context.md.",
     "",
     "   ## Traceability",
     "   - **Parent capability:** <parent-slug or `none`>",
@@ -1828,7 +1857,7 @@ var bcmWriterSubAgent = {
     "Roles Involved, and Company Size Applicability \u2014 and append a",
     "revision-history entry.",
     "",
-    "**Budget:** Read the scaffold, `docs/project-context.md`, the value",
+    "**Budget:** Read the scaffold, `docs/src/content/docs/project-context.md`, the value",
     "stream source, and the entity taxonomy. Targeted research only \u2014",
     "enough to fill each section with cited facts. Do not open downstream",
     "issues in this phase; that is Phase 4's job.",
@@ -1847,13 +1876,13 @@ var bcmWriterSubAgent = {
     "",
     "1. **Read the scaffolded BCM document** referenced in the issue body.",
     "",
-    "2. **Read `docs/project-context.md`** for mission, target users,",
+    "2. **Read `docs/src/content/docs/project-context.md`** for mission, target users,",
     "   in/out-of-scope capabilities, and key stakeholders \u2014 this is the",
     "   authoritative source for the Project Relevance section.",
     "",
     "3. **Resolve the value stream.** Find the value-stream source named in",
     "   the outline or the issue body. If none is provided, check",
-    "   `docs/project-context.md` and `<BCM_DOC_ROOT>` for a value-stream",
+    "   `docs/src/content/docs/project-context.md` and `<BCM_DOC_ROOT>` for a value-stream",
     "   doc. If still unresolved, write a `TODO: value stream not yet",
     "   defined` placeholder and flag the context issue with",
     "   `status:needs-attention`.",
@@ -1866,7 +1895,7 @@ var bcmWriterSubAgent = {
     "5. **Fill `## Company Size Applicability`.** Indicate whether this",
     "   capability applies to `small`, `medium`, `large`, or `enterprise`",
     "   organizations, with a one-line rationale each. Source from",
-    "   `docs/project-context.md` target users when possible.",
+    "   `docs/src/content/docs/project-context.md` target users when possible.",
     "",
     "6. **Fill `## Enabling Software Systems`.** List the software systems",
     "   (internal or external) that enable this capability. Reference",
@@ -1884,7 +1913,7 @@ var bcmWriterSubAgent = {
     "   ```",
     "",
     "8. **Fill `## Project Relevance`.** Frame the capability against",
-    "   `docs/project-context.md`:",
+    "   `docs/src/content/docs/project-context.md`:",
     "   - Which in-scope capability does this match (or overlap with)?",
     "   - Which mission pillar does it support?",
     "   - Which target-user role benefits from it?",
@@ -2063,13 +2092,13 @@ var writeBcmSkill = {
     "",
     "## Default Paths",
     "",
-    "If the project has no override in `docs/project-context.md` or",
+    "If the project has no override in `docs/src/content/docs/project-context.md` or",
     "`agentConfig.rules`, outputs land under:",
     "",
-    "- `docs/bcm/.outlines/<slug>.outline.md` (Phase 1)",
-    "- `docs/bcm/<slug>.md` (Phases 2\u20134)",
-    "- `docs/bcm/_index.md` (Phase 4, registry update)",
-    "- `docs/bcm/capability-map.md` (Phase 4, capability-map update)",
+    "- `docs/src/content/docs/concepts/.outlines/<slug>.outline.md` (Phase 1)",
+    "- `docs/src/content/docs/concepts/<slug>.md` (Phases 2\u20134)",
+    "- `docs/src/content/docs/concepts/_index.md` (Phase 4, registry update)",
+    "- `docs/src/content/docs/concepts/capability-map.md` (Phase 4, capability-map update)",
     "",
     "## Steps",
     "",
@@ -2292,7 +2321,7 @@ var companyProfileAnalystSubAgent = {
     "| `<PEOPLE_PROFILES_DIR>` | Where existing people profiles live (for duplicate detection during followup) | `docs/people/profiles/` |",
     "| `<SOFTWARE_PROFILES_DIR>` | Where existing software profiles live (for duplicate detection during followup) | `docs/software/profiles/` |",
     "",
-    "If `docs/project-context.md` specifies a different company-research",
+    "If `docs/src/content/docs/project-context.md` specifies a different company-research",
     "tree (for example by reusing the research-pipeline deliverables",
     "folder), prefer that. Otherwise fall back to the defaults above.",
     "",
@@ -2642,7 +2671,7 @@ var profileCompanySkill = {
     "",
     "## Default Paths",
     "",
-    "If the project has no override in `docs/project-context.md` or",
+    "If the project has no override in `docs/src/content/docs/project-context.md` or",
     "`agentConfig.rules`, outputs land under:",
     "",
     "- `docs/companies/notes/<slug>.notes.md`",
@@ -3049,7 +3078,7 @@ var industryDiscoveryAnalystSubAgent = {
     "the consuming project sells, which industries matter, or what the",
     "scoring rubric should weight. All domain-specific vocabulary, scoring",
     "inputs, output locations, and threshold values come from the invoking",
-    "issue body, `docs/project-context.md`, or the consuming project's",
+    "issue body, `docs/src/content/docs/project-context.md`, or the consuming project's",
     "configuration.",
     "",
     "Follow your project's shared agent conventions (`AGENTS.md`,",
@@ -3074,7 +3103,7 @@ var industryDiscoveryAnalystSubAgent = {
     "   companies, or source projects. Use placeholders that the skill",
     "   invocation or consuming project fills in.",
     "5. **Configurable rubric.** The fit rubric \u2014 criteria, weights, and",
-    "   threshold \u2014 comes from `docs/project-context.md` or the invoking",
+    "   threshold \u2014 comes from `docs/src/content/docs/project-context.md` or the invoking",
     "   issue body. Never invent weights or pass/fail cutoffs without an",
     "   authoritative source.",
     "6. **Planning only.** This pipeline produces candidate lists,",
@@ -3137,7 +3166,7 @@ var industryDiscoveryAnalystSubAgent = {
     "| `<PLANS_DIR>` | Plan files summarizing downstream research (Phase 3) | `<INDUSTRY_ROOT>/plans/` |",
     "| `<DISCOVERY_SLUG>` | Short kebab-case slug identifying one discovery cycle | derived from the scope |",
     "",
-    "If `docs/project-context.md` specifies a different industry-discovery",
+    "If `docs/src/content/docs/project-context.md` specifies a different industry-discovery",
     "tree, prefer that. Otherwise fall back to the defaults above.",
     "",
     "---",
@@ -3150,7 +3179,7 @@ var industryDiscoveryAnalystSubAgent = {
     "",
     "1. **Invoking issue body.** If the issue body includes a `## Fit",
     "   Rubric` section, use it verbatim.",
-    "2. **`docs/project-context.md`.** If the project context file includes",
+    "2. **`docs/src/content/docs/project-context.md`.** If the project context file includes",
     "   a `## Industry Fit Rubric` section, use it.",
     "3. **Default scaffold.** If neither source defines a rubric, write a",
     "   placeholder rubric with `TODO:` weights and flag the evaluate issue",
@@ -3273,7 +3302,7 @@ var industryDiscoveryAnalystSubAgent = {
     "1. **Read the candidate file** referenced in the issue body.",
     "",
     "2. **Resolve the fit rubric** per the Fit Rubric Convention above.",
-    "   If neither the invoking issue nor `docs/project-context.md` defines",
+    "   If neither the invoking issue nor `docs/src/content/docs/project-context.md` defines",
     "   a rubric, emit a scaffold and flag `status:needs-attention` \u2014 do not",
     "   silently invent weights or thresholds.",
     "",
@@ -3448,12 +3477,12 @@ var discoverIndustriesSkill = {
     "- `slug: <kebab-case>` \u2014 override the derived discovery slug",
     "- `rubric: inline` \u2014 include an inline `## Fit Rubric` section to use",
     "  for Phase 2; otherwise the agent falls back to",
-    "  `docs/project-context.md` or a scaffold",
+    "  `docs/src/content/docs/project-context.md` or a scaffold",
     "- `threshold: <0.0\u20131.0>` \u2014 override the rubric's default threshold",
     "",
     "## Default Paths",
     "",
-    "If the project has no override in `docs/project-context.md` or",
+    "If the project has no override in `docs/src/content/docs/project-context.md` or",
     "`agentConfig.rules`, outputs land under:",
     "",
     "- `docs/industries/candidates/<slug>.candidates.md`",
@@ -3706,7 +3735,7 @@ var maintenanceAuditSubAgent = {
     "",
     "| Placeholder | Meaning | Example |",
     "|-------------|---------|---------|",
-    "| `<DOCS_ROOT>` | Root of the doc tree being audited | `docs/requirements/`, `docs/adrs/`, `docs/bcm/` |",
+    "| `<DOCS_ROOT>` | Root of the doc tree being audited | `docs/src/content/docs/requirements/`, `docs/src/content/docs/requirements/architectural-decisions/`, `docs/src/content/docs/concepts/` |",
     "| `<REGISTRY_INDEX>` | Registry or index file to check for drift | `<DOCS_ROOT>/_index.md`, `<DOCS_ROOT>/README.md` |",
     "| `<AUDIT_ROOT>` | Where audit reports are written | `docs/maintenance/` |",
     "| `<AUDIT_SLUG>` | Short identifier for this audit scope | e.g. `requirements-xrefs`, `adr-registry`, `bcm-traceability` |",
@@ -3999,10 +4028,10 @@ var maintenanceAuditSkill = {
     "",
     "Where `<scope>` is a short slug plus path for the doc tree to",
     "audit. Examples:",
-    "- `requirements-xrefs:docs/requirements/` \u2014 audit requirement",
+    "- `requirements-xrefs:docs/src/content/docs/requirements/` \u2014 audit requirement",
     "  traceability links and the category registries",
-    "- `adr-registry:docs/adrs/` \u2014 audit the ADR registry index",
-    "- `bcm-traceability:docs/bcm/` \u2014 audit BCM capability-model",
+    "- `adr-registry:docs/src/content/docs/requirements/architectural-decisions/` \u2014 audit the ADR registry index",
+    "- `bcm-traceability:docs/src/content/docs/concepts/` \u2014 audit BCM capability-model",
     "  cross-references",
     "",
     "The consuming project defines which scopes are valid.",
@@ -5470,7 +5499,7 @@ var peopleProfileAnalystSubAgent = {
     "| `<SOFTWARE_DIR>` | Where existing software profiles live (for cross-references and duplicate detection during followup) | `docs/software/profiles/` |",
     "| `<MEETINGS_DIR>` | Where meeting notes live (for cross-references) | `docs/meetings/` |",
     "",
-    "If `docs/project-context.md` specifies a different people-research",
+    "If `docs/src/content/docs/project-context.md` specifies a different people-research",
     "tree or cross-reference target, prefer that. Otherwise fall back to",
     "the defaults above. Cross-reference directories are read-only \u2014 this",
     "agent never writes into them.",
@@ -5485,7 +5514,7 @@ var peopleProfileAnalystSubAgent = {
     "- **Default cadence:** 180 days from the profile's `date` frontmatter.",
     "- **Override:** the invoking issue body may specify a `refresh_days: N`",
     "  field, or the consuming project may set a project-wide default in",
-    "  `docs/project-context.md`.",
+    "  `docs/src/content/docs/project-context.md`.",
     "",
     "When the `/profile-person` skill is invoked for a slug that already",
     "has a profile:",
@@ -5920,7 +5949,7 @@ var profilePersonSkill = {
     "",
     "## Default Paths",
     "",
-    "If the project has no override in `docs/project-context.md` or",
+    "If the project has no override in `docs/src/content/docs/project-context.md` or",
     "`agentConfig.rules`, outputs land under:",
     "",
     "- `docs/people/notes/<slug>.notes.md`",
@@ -7256,8 +7285,8 @@ var prReviewBundle = {
         "",
         "human-required:",
         "  paths:",
-        '    - "docs/requirements/architectural-decisions/**"',
-        '    - "docs/project-context.md"',
+        '    - "docs/src/content/docs/requirements/architectural-decisions/**"',
+        '    - "docs/src/content/docs/project-context.md"',
         '    - ".github/workflows/**"',
         '    - ".github/CODEOWNERS"',
         '    - ".projenrc.ts"',
@@ -7879,7 +7908,7 @@ var REQ_WRITE_ISSUE_SCHEMA_SECTION = [
   "- **Output Path:** absolute-from-repo-root path ending in",
   "  `<PREFIX>-<NNN>-<slug>.md` under the target category directory",
   "  (for example,",
-  "  `docs/requirements/functional/FR-012-checkout-flow.md`).",
+  "  `docs/src/content/docs/requirements/functional/FR-012-checkout-flow.md`).",
   "",
   "### Strongly Recommended",
   "",
@@ -7990,12 +8019,12 @@ var requirementsAnalystSubAgent = {
     "",
     "| 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/` |",
+    "| `<BCM_DOCS_ROOT>` | Root of BCM model docs (capability models) | `docs/src/content/docs/concepts/` |",
+    "| `<COMPETITIVE_ROOT>` | Competitive analysis docs | `docs/src/content/docs/business-strategy/competitive/` |",
+    "| `<PRODUCT_ROOT>` | Product roadmap / entity taxonomy | `docs/src/content/docs/product/` |",
+    "| `<MEETINGS_ROOT>` | Meeting extracts | `docs/src/content/docs/research/meetings/` |",
+    "| `<RESEARCH_REQUIREMENTS_ROOT>` | Scan reports and proposals | `docs/src/content/docs/research/requirements/` |",
+    "| `<REQUIREMENTS_ROOT>` | Final requirement documents (owned by requirements-writer) | `docs/src/content/docs/requirements/` |",
     "| `<PREFIX>` | Project-specific requirement ID prefix | e.g. `VRTX`, `ACME` |",
     "",
     "If your project stores these in different locations, substitute accordingly",
@@ -8033,7 +8062,7 @@ var requirementsAnalystSubAgent = {
     "",
     "| Scope | What to read | What to look for |",
     "|-------|-------------|-----------------|",
-    "| **BCM model doc** | One `{PREFIX}-NNN` doc under `<BCM_DOCS_ROOT>` | The doc's project-relevance section (commonly `## <Project> Relevance` or `## Strategic Implications`) \u2014 gaps where capabilities exist but no FR/BR/INT addresses them. Use `docs/project-context.md` to judge what is relevant. |",
+    "| **BCM model doc** | One `{PREFIX}-NNN` doc under `<BCM_DOCS_ROOT>` | The doc's project-relevance section (commonly `## <Project> Relevance` or `## Strategic Implications`) \u2014 gaps where capabilities exist but no FR/BR/INT addresses them. Use `docs/src/content/docs/project-context.md` to judge what is relevant. |",
     "| **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) |",
@@ -8296,7 +8325,7 @@ var requirementsAnalystSubAgent = {
     "",
     "| Direction | Agent | What |",
     "|-----------|-------|------|",
-    "| Upstream | BCM Writer | Scans capability-model docs for project-relevance gaps (judged against `docs/project-context.md`) |",
+    "| Upstream | BCM Writer | Scans capability-model docs for project-relevance gaps (judged against `docs/src/content/docs/project-context.md`) |",
     "| Upstream | Company Research | Scans competitive analysis for feature comparison gaps |",
     "| Upstream | Meeting Analyst | Scans meeting extracts for requirement proposals |",
     "| Downstream | `requirements-writer` | Picks up the `type:requirement` + `req:write` issues this agent creates and drafts the actual requirement document |",
@@ -10209,7 +10238,7 @@ This reference provides detailed guidance on the standards and frameworks that i
 
 ## Tier-Specific Standards Guidance
 
-The four architectural tiers (Platform, Industry, Customer Workflow, Consumer Application) influence which standards are most relevant when writing requirements. The tier names below are the bundle defaults \u2014 consuming projects may rename or reduce the tier set in their own \`docs/project-context.md\`.
+The four architectural tiers (Platform, Industry, Customer Workflow, Consumer Application) influence which standards are most relevant when writing requirements. The tier names below are the bundle defaults \u2014 consuming projects may rename or reduce the tier set in their own \`docs/src/content/docs/project-context.md\`.
 
 ### Platform Tier
 All category-specific standards apply at their full depth. Platform requirements define the core infrastructure that all other tiers depend on. Pay particular attention to:
@@ -10350,18 +10379,18 @@ var requirementsWriterSubAgent = {
     "",
     "The pipeline uses these placeholders. Consuming projects override the",
     "defaults by passing paths in the `/write-requirement` skill",
-    "invocation, by recording overrides in `docs/project-context.md`, or",
+    "invocation, by recording overrides in `docs/src/content/docs/project-context.md`, or",
     "by extending this rule in their own `agentConfig.rules`.",
     "",
     "| Placeholder | Meaning | Default |",
     "|-------------|---------|---------|",
-    "| `<REQUIREMENTS_ROOT>` | Root folder for final requirement documents | `docs/requirements/` |",
+    "| `<REQUIREMENTS_ROOT>` | Root folder for final requirement documents | `docs/src/content/docs/requirements/` |",
     "| `<RESEARCH_REQUIREMENTS_ROOT>` | Where the upstream `requirements-analyst` writes proposals | `docs/research/requirements/` |",
     `| \`<TEMPLATES_ROOT>\` | Where the category templates ship (set automatically by this bundle) | \`${REQUIREMENTS_WRITER_PATHS.templatesRoot}\` |`,
     `| \`<STANDARDS_REF>\` | Standards & frameworks reference document | \`${REQUIREMENTS_WRITER_PATHS.standardsRef}\` |`,
-    "| `<PREFIX>` | Project-specific requirement ID prefix | none \u2014 requirement IDs use the category prefix (`BR`, `FR`, \u2026) unless `docs/project-context.md` defines a project prefix |",
+    "| `<PREFIX>` | Project-specific requirement ID prefix | none \u2014 requirement IDs use the category prefix (`BR`, `FR`, \u2026) unless `docs/src/content/docs/project-context.md` defines a project prefix |",
     "",
-    "If `docs/project-context.md` specifies a different requirements tree,",
+    "If `docs/src/content/docs/project-context.md` specifies a different requirements tree,",
     "prefer that. Otherwise fall back to the defaults above.",
     "",
     "---",
@@ -10382,7 +10411,7 @@ var requirementsWriterSubAgent = {
     'Tier is **orthogonal** to category \u2014 category answers "what kind"',
     'while tier answers "where in the architecture." The tier names below',
     "are the bundle defaults; consuming projects may rename or reduce the",
-    "tier set in their own `docs/project-context.md`.",
+    "tier set in their own `docs/src/content/docs/project-context.md`.",
     "",
     ...REQUIREMENTS_TIER_TABLE_SECTION,
     "",
@@ -10519,7 +10548,7 @@ var requirementsWriterSubAgent = {
     "",
     "- **PREFIX** \u2014 category abbreviation (`BR`, `FR`, `NFR`, `TR`,",
     "  `ADR`, `SEC`, `DR`, `INT`, `OPS`, `UX`, `MT`). If the project",
-    "  declares a project-wide prefix in `docs/project-context.md`, use",
+    "  declares a project-wide prefix in `docs/src/content/docs/project-context.md`, use",
     "  it instead.",
     "- **NNN** \u2014 three-digit sequential number (001, 002, 012). Always",
     "  check the target category directory under `<REQUIREMENTS_ROOT>`",
@@ -10791,7 +10820,7 @@ var requirementsWriterSubAgent = {
     "",
     "7. **Set frontmatter.** At minimum: `title`, `description`, `tier`.",
     "   If the project declares optional frontmatter conventions in",
-    "   `docs/project-context.md` (such as `referencedIn.meetings[]`),",
+    "   `docs/src/content/docs/project-context.md` (such as `referencedIn.meetings[]`),",
     "   honor them. Otherwise stop at the minimum.",
     "",
     "8. **Update the category index.** If the category directory has a",
@@ -10929,7 +10958,7 @@ var writeRequirementSkill = {
     "- `tier: platform | industry | customer-workflow | consumer-app` \u2014",
     "  the architectural tier (default: `platform`)",
     "- `prefix: <PROJECT_PREFIX>` \u2014 override the default category prefix",
-    "  with a project-specific one declared in `docs/project-context.md`",
+    "  with a project-specific one declared in `docs/src/content/docs/project-context.md`",
     "- `customer: <link-or-slug>` \u2014 link the requirement to a customer",
     "  profile (expected for Customer Workflow / Consumer Application",
     "  tiers in projects that track customer profiles)",
@@ -10940,12 +10969,12 @@ var writeRequirementSkill = {
     "",
     "## Default Paths",
     "",
-    "If the project has no override in `docs/project-context.md` or",
+    "If the project has no override in `docs/src/content/docs/project-context.md` or",
     "`agentConfig.rules`, outputs land under:",
     "",
-    "- `docs/requirements/<category-dir>/<PREFIX>-<NNN>-<slug>.md`",
-    "- `docs/requirements/<category-dir>/README.md` (registry update)",
-    "- `docs/requirements/README.md` (top-level README, generated on",
+    "- `docs/src/content/docs/requirements/<category-dir>/<PREFIX>-<NNN>-<slug>.md`",
+    "- `docs/src/content/docs/requirements/<category-dir>/README.md` (registry update)",
+    "- `docs/src/content/docs/requirements/README.md` (top-level README, generated on",
     "  first use only)",
     "",
     "Templates and the standards reference ship with this skill under",
@@ -11171,18 +11200,18 @@ var requirementsReviewerSubAgent = {
     "",
     "The pipeline uses these placeholders. Consuming projects override",
     "the defaults by passing paths in the `/review-requirements` skill",
-    "invocation, by recording overrides in `docs/project-context.md`, or",
+    "invocation, by recording overrides in `docs/src/content/docs/project-context.md`, or",
     "by extending this rule in their own `agentConfig.rules`.",
     "",
     "| Placeholder | Meaning | Default |",
     "|-------------|---------|---------|",
-    "| `<REQUIREMENTS_ROOT>` | Root folder for final requirement documents | `docs/requirements/` |",
+    "| `<REQUIREMENTS_ROOT>` | Root folder for final requirement documents | `docs/src/content/docs/requirements/` |",
     "| `<REVIEW_REPORTS_ROOT>` | Where review reports are written | `docs/research/reviews/` |",
     `| \`<TEMPLATES_ROOT>\` | Where the writer bundle ships category templates (read-only for this agent) | \`${REQUIREMENTS_WRITER_PATHS.templatesRoot}\` |`,
     `| \`<STANDARDS_REF>\` | Standards & frameworks reference shipped by the writer bundle | \`${REQUIREMENTS_WRITER_PATHS.standardsRef}\` |`,
     "| `<STALE_PROPOSED_THRESHOLD_DAYS>` | Age (in days) after which a `Proposed` ADR/TR is flagged as a stale decision by Check 12 | `14` |",
     "",
-    "If `docs/project-context.md` specifies a different requirements",
+    "If `docs/src/content/docs/project-context.md` specifies a different requirements",
     "tree, prefer that. Otherwise fall back to the defaults above.",
     "",
     "---",
@@ -11241,7 +11270,7 @@ var requirementsReviewerSubAgent = {
     "- YAML frontmatter present with `title` and `description` fields",
     "- Title in frontmatter matches the `# Heading` line",
     "- File name follows `{PREFIX}-{NNN}-{slug}.md` (or the project",
-    "  prefix declared in `docs/project-context.md`)",
+    "  prefix declared in `docs/src/content/docs/project-context.md`)",
     "- File is in the correct category directory under",
     "  `<REQUIREMENTS_ROOT>`",
     "- `Status` field is set to one of the valid values: `Draft`,",
@@ -11273,7 +11302,7 @@ var requirementsReviewerSubAgent = {
     "",
     "Check that the requirement dependency graph is connected. Apply",
     "these expectations as defaults; override them when the project's",
-    "`docs/project-context.md` defines a different traceability shape:",
+    "`docs/src/content/docs/project-context.md` defines a different traceability shape:",
     "",
     "- Every FR should trace back to at least one BR (via",
     '  "Implements")',
@@ -11342,7 +11371,7 @@ var requirementsReviewerSubAgent = {
     "  integration shape?)",
     "- **Staleness** \u2014 Are statuses up to date? Are there `Draft`",
     "  documents that should have progressed?",
-    "- **Naming consistency** \u2014 When `docs/project-context.md` declares",
+    "- **Naming consistency** \u2014 When `docs/src/content/docs/project-context.md` declares",
     "  a project name or product name, verify it is used consistently",
     "  across documents.",
     "",
@@ -11411,7 +11440,7 @@ var requirementsReviewerSubAgent = {
     "Verify that every document has a valid tier classification. The",
     "default tier set is `platform`, `industry`, `customer-workflow`,",
     "`consumer-app`; consuming projects may rename or reduce the tier",
-    "set in their own `docs/project-context.md`.",
+    "set in their own `docs/src/content/docs/project-context.md`.",
     "",
     "- `tier` field is set in YAML frontmatter (one of the project's",
     "  declared tier slugs)",
@@ -11461,7 +11490,7 @@ var requirementsReviewerSubAgent = {
     "### 11. Cross-Referencing Convention Compliance",
     "",
     "Verify alignment with the project's cross-referencing conventions",
-    "(usually documented in `docs/project-context.md` or a profile",
+    "(usually documented in `docs/src/content/docs/project-context.md` or a profile",
     "registry index):",
     "",
     "- Requirements that reference profiled organizations use the",
@@ -11506,7 +11535,7 @@ var requirementsReviewerSubAgent = {
     "",
     "The threshold placeholder `<STALE_PROPOSED_THRESHOLD_DAYS>` is",
     "configurable \u2014 override it in the `req:review` issue body, in",
-    "`docs/project-context.md`, or via `agentConfig.rules`. The default",
+    "`docs/src/content/docs/project-context.md`, or via `agentConfig.rules`. The default",
     "of 14 days sits above the orchestrator's existing 72h / 168h stale",
     "thresholds for `status:in-progress` / `status:blocked` and fits",
     "the pace at which architectural decisions are typically ratified.",
@@ -11917,7 +11946,7 @@ var requirementsReviewerSubAgent = {
     "",
     "- **Targets** \u2014 one or more requirement IDs or paths to deprecate",
     "  (for example, `ADR-007-auth-provider.md` or",
-    "  `docs/requirements/architecture/ADR-007-auth-provider.md`).",
+    "  `docs/src/content/docs/requirements/architecture/ADR-007-auth-provider.md`).",
     "- **Transition** \u2014 per target, either `Deprecated` (no successor)",
     "  or `Superseded-by: <path>` (where `<path>` is the relative path",
     "  or requirement ID of the replacement document). When the",
@@ -12097,7 +12126,7 @@ var requirementsReviewerSubAgent = {
     "  deprecation follow-up must cite the referencing document path and",
     "  the line(s) that mention the deprecated ID.",
     "- **Do not invent traceability rules.** Use the defaults documented",
-    "  above unless the project's `docs/project-context.md` declares a",
+    "  above unless the project's `docs/src/content/docs/project-context.md` declares a",
     "  different traceability shape.",
     "- **Audits >10 documents must use a verification script.** Manual",
     "  review of large sets always misses broken links."
@@ -12154,7 +12183,7 @@ var reviewRequirementsSkill = {
     "",
     "## Default Paths",
     "",
-    "If the project has no override in `docs/project-context.md` or",
+    "If the project has no override in `docs/src/content/docs/project-context.md` or",
     "`agentConfig.rules`, outputs land under:",
     "",
     "- `docs/research/reviews/review-<scope>-YYYY-MM-DD.md` \u2014 the",
@@ -12337,7 +12366,7 @@ var requirementsReviewerBundle = {
         "Check 12 flags ADR and TR documents that have carried",
         "`Status: Proposed` longer than",
         "`<STALE_PROPOSED_THRESHOLD_DAYS>` days (default 14, configurable",
-        "via the `req:review` issue body, `docs/project-context.md`, or",
+        "via the `req:review` issue body, `docs/src/content/docs/project-context.md`, or",
         "`agentConfig.rules`). Stale decisions are reported in a separate",
         "**Stale decisions** section of the review report and trigger one",
         "aggregated `req:review` follow-up issue labeled",
@@ -12530,7 +12559,7 @@ var researchAnalystSubAgent = {
     "| `<RESEARCH_SLUG>` | Short kebab-case slug identifying one research cycle | derived from the question |",
     "| `<N>` | Number of slices (default 4, max 8) | `4` |",
     "",
-    "If `docs/project-context.md` specifies a different research tree,",
+    "If `docs/src/content/docs/project-context.md` specifies a different research tree,",
     "prefer that. Otherwise fall back to the defaults above.",
     "",
     "---",
@@ -12820,7 +12849,7 @@ var researchSkill = {
     "",
     "## Default Paths",
     "",
-    "If the project has no override in `docs/project-context.md` or",
+    "If the project has no override in `docs/src/content/docs/project-context.md` or",
     "`agentConfig.rules`, outputs land under:",
     "",
     "- `docs/research/scopes/<slug>.scope.md`",
@@ -13110,7 +13139,7 @@ var softwareProfileAnalystSubAgent = {
     "4. **Generic over specific.** No hardcoded product types, feature",
     "   taxonomies, or segment assumptions. Use the generic software-type",
     "   taxonomy below and let consuming projects override it via their",
-    "   `docs/project-context.md` or `agentConfig.rules`.",
+    "   `docs/src/content/docs/project-context.md` or `agentConfig.rules`.",
     "5. **Cite everything.** Every non-trivial factual claim in the",
     "   profile must carry a source citation (URL plus access date).",
     "6. **Follow-up, don't widen scope.** If the session turns up adjacent",
@@ -13122,7 +13151,7 @@ var softwareProfileAnalystSubAgent = {
     "   products stay inside this pipeline via `software:research`",
     "   issues.",
     "7. **Segment weights live in project context.** Segment-importance",
-    "   weights belong in `docs/project-context.md` (or an override",
+    "   weights belong in `docs/src/content/docs/project-context.md` (or an override",
     "   passed in the issue body). This agent reads them; it never",
     "   invents them.",
     "",
@@ -13157,14 +13186,14 @@ var softwareProfileAnalystSubAgent = {
     "the project's own strategy; features that serve high-weight segments",
     "rank higher in the matrix.",
     "",
-    "**Convention:** segment weights live in `docs/project-context.md`",
+    "**Convention:** segment weights live in `docs/src/content/docs/project-context.md`",
     "under a `## Segment Weights` section. The format is a simple",
     "markdown table with `segment` and `weight` columns. Weights are",
     "non-negative numbers; the scale is project-defined (0\u20131, 0\u201310, and",
     "0\u2013100 are all valid as long as the project is internally",
     "consistent).",
     "",
-    "Example `docs/project-context.md` fragment:",
+    "Example `docs/src/content/docs/project-context.md` fragment:",
     "",
     "```markdown",
     "## Segment Weights",
@@ -13177,7 +13206,7 @@ var softwareProfileAnalystSubAgent = {
     "| hobbyist  | 0.5 |",
     "```",
     "",
-    "If `docs/project-context.md` does not define segment weights,",
+    "If `docs/src/content/docs/project-context.md` does not define segment weights,",
     "**do not invent them**. Either:",
     "",
     "- Accept an `weights:` override in the invoking issue body, or",
@@ -13239,7 +13268,7 @@ var softwareProfileAnalystSubAgent = {
     "| `<COMPANY_PROFILES_DIR>` | Where existing company profiles live (for duplicate detection during followup) | `docs/companies/profiles/` |",
     "| `<PEOPLE_PROFILES_DIR>` | Where existing people profiles live (for duplicate detection during followup) | `docs/people/profiles/` |",
     "",
-    "If `docs/project-context.md` specifies a different software-research",
+    "If `docs/src/content/docs/project-context.md` specifies a different software-research",
     "tree (for example by reusing the research-pipeline deliverables",
     "folder), prefer that. Otherwise fall back to the defaults above.",
     "",
@@ -13419,7 +13448,7 @@ var softwareProfileAnalystSubAgent = {
     "4. **Create the `software:matrix` issue** with",
     "   `Depends on: #<profile-issue>`. Its body references the profile",
     "   path, the matrix file path, and the segment-weights source",
-    "   (`docs/project-context.md` or an explicit override).",
+    "   (`docs/src/content/docs/project-context.md` or an explicit override).",
     "",
     "5. **Commit and push** the profile file. Close the profile issue.",
     "",
@@ -13443,7 +13472,7 @@ var softwareProfileAnalystSubAgent = {
     "```markdown",
     "---",
     'title: "Software Feature Matrix"',
-    "weights_source: docs/project-context.md#segment-weights",
+    "weights_source: docs/src/content/docs/project-context.md#segment-weights",
     "updated: YYYY-MM-DD",
     "---",
     "",
@@ -13465,12 +13494,12 @@ var softwareProfileAnalystSubAgent = {
     "score = \u03A3 (coverage[segment] * weight[segment])",
     "```",
     "",
-    "using the weights loaded from `docs/project-context.md`.",
+    "using the weights loaded from `docs/src/content/docs/project-context.md`.",
     "",
     "### Steps",
     "",
     "1. **Load segment weights.** Read `## Segment Weights` from",
-    "   `docs/project-context.md`. If absent, fall back to the",
+    "   `docs/src/content/docs/project-context.md`. If absent, fall back to the",
     "   `weights:` override in the issue body, or the single-segment",
     "   default described in `## Segment-Importance Weights` above.",
     "",
@@ -13655,7 +13684,7 @@ var softwareProfileAnalystSubAgent = {
     "- **Cite everything.** Profile claims without source citations do not",
     "  belong in the deliverable.",
     "- **No invented weights.** Segment weights come from",
-    "  `docs/project-context.md` or an explicit issue-body override. If",
+    "  `docs/src/content/docs/project-context.md` or an explicit issue-body override. If",
     "  neither is available, fall back to the single-segment default and",
     "  flag the gap \u2014 never guess.",
     "- **Delegate, don't duplicate.** The vendor company and primary-",
@@ -13708,12 +13737,12 @@ var profileSoftwareSkill = {
     "- `slug: <kebab-case>` \u2014 override the derived product slug",
     "- `weights: <table>` \u2014 override the segment-importance weights for",
     "  this profile cycle (otherwise loaded from",
-    "  `docs/project-context.md`)",
+    "  `docs/src/content/docs/project-context.md`)",
     "- `sources: <list>` \u2014 additional authorized sources beyond public web",
     "",
     "## Default Paths",
     "",
-    "If the project has no override in `docs/project-context.md` or",
+    "If the project has no override in `docs/src/content/docs/project-context.md` or",
     "`agentConfig.rules`, outputs land under:",
     "",
     "- `docs/software/notes/<slug>.notes.md`",
@@ -13772,7 +13801,7 @@ var softwareProfileBundle = {
         "The pipeline produces **software profiles, research notes, and",
         "rows in a shared feature matrix**. Features are ranked against",
         "segment-importance weights declared in",
-        "`docs/project-context.md` under a `## Segment Weights` section.",
+        "`docs/src/content/docs/project-context.md` under a `## Segment Weights` section.",
         "Deeper research on adjacent products surfaced in a profile is",
         "delegated to new cycles of this same pipeline via",
         "`software:followup` issues. Deeper research on the vendor",
@@ -16102,11 +16131,11 @@ function getStarlightRole(sub) {
 function formatLayoutViolation(violation) {
   const { projectName, projectType, outdir, expectedRoot } = violation;
   const expectedExample = expectedRoot === MONOREPO_LAYOUT.DOCS ? "docs/" : `${expectedRoot}/<scope>/<name>`;
-  return `[monorepo-layout] ${projectType} "${projectName}" has outdir "${outdir}", which is outside the expected root "${expectedRoot}/" (expected e.g. "${expectedExample}"). See docs/requirements/architectural-decisions/ADR-006-monorepo-layout.md.`;
+  return `[monorepo-layout] ${projectType} "${projectName}" has outdir "${outdir}", which is outside the expected root "${expectedRoot}/" (expected e.g. "${expectedExample}"). See docs/src/content/docs/requirements/architectural-decisions/ADR-006-monorepo-layout.md.`;
 }
 function formatStarlightSingletonViolation(violation) {
   const names = violation.projectNames.map((n) => `"${n}"`).join(", ");
-  return `[monorepo-layout] Multiple StarlightProject instances with role: "docs" found (${names}). ADR-006 allows exactly one docs-role Starlight project per MonorepoProject. Either remove the duplicates or set role: "site" on the additional ones so they land under sites/. See docs/requirements/architectural-decisions/ADR-006-monorepo-layout.md.`;
+  return `[monorepo-layout] Multiple StarlightProject instances with role: "docs" found (${names}). ADR-006 allows exactly one docs-role Starlight project per MonorepoProject. Either remove the duplicates or set role: "site" on the additional ones so they land under sites/. See docs/src/content/docs/requirements/architectural-decisions/ADR-006-monorepo-layout.md.`;
 }
 function outdirMatchesRoot(relOutdir, expectedRoot) {
   const segments = relOutdir.split("/").filter((s) => s.length > 0);
@@ -16700,6 +16729,16 @@ var MonorepoProject = class extends TypeScriptAppProject {
        * Default PNPM version to use in the monorepo.
        */
       pnpmVersion: VERSION.PNPM_VERSION,
+      /**
+       * Node.js version used in GitHub Actions workflows (build, upgrade, etc.).
+       * Pinning this inserts an `actions/setup-node` step before dependency
+       * install so CI does not fall back to whatever Node the `ubuntu-latest`
+       * runner ships with (currently Node 20.x, which is below the floor
+       * required by Astro 6 / Starlight).
+       *
+       * @see {@link VERSION.NODE_WORKFLOWS}
+       */
+      workflowNodeVersion: VERSION.NODE_WORKFLOWS,
       /**
        * By default treat as a registry consumer (upgrade workflow syncs configulator).
        */
@@ -16896,7 +16935,10 @@ var MonorepoProject = class extends TypeScriptAppProject {
     const upgradeJob = upgradeWorkflow?.getJob("upgrade");
     const jobWithSteps = upgradeJob && "steps" in upgradeJob ? upgradeJob : void 0;
     if (jobWithSteps?.steps && Array.isArray(jobWithSteps.steps)) {
-      const insertIndex = 4;
+      const upgradeStepIndex = jobWithSteps.steps.findIndex(
+        (step) => step.name === "Upgrade dependencies"
+      );
+      const insertIndex = upgradeStepIndex >= 0 ? upgradeStepIndex + 1 : jobWithSteps.steps.length;
       if (this.configulatorRegistryConsumer) {
         jobWithSteps.steps.splice(insertIndex, 0, {
           name: `Sync ${CONFIGULATOR_PACKAGE_NAME} in workspace`,