@codedrifters/configulator 0.0.345 → 0.0.347

package/lib/index.mjs

@@ -1677,6 +1677,19 @@ function assertValidBundlePathPatterns(value) {
 }
 
 // src/agent/bundles/paths.ts
+var DEFAULT_REQUIREMENT_CATEGORY_DIRS = Object.freeze({
+  business: "business",
+  functional: "functional",
+  nonFunctional: "non-functional",
+  technical: "technical",
+  architecturalDecisions: "architectural-decisions",
+  security: "security",
+  data: "data",
+  integration: "integration",
+  operational: "operational",
+  ux: "ux",
+  multiTenancy: "multi-tenancy"
+});
 var DEFAULT_AGENT_PATHS = Object.freeze({
   docsRoot: "docs/src/content/docs",
   researchRoot: "docs/research",
@@ -1688,7 +1701,8 @@ var DEFAULT_AGENT_PATHS = Object.freeze({
   peopleRoot: "docs/src/content/docs/profiles/people",
   companiesRoot: "docs/src/content/docs/profiles/companies",
   softwareRoot: "docs/src/content/docs/profiles/software",
-  industriesRoot: "docs/src/content/docs/profiles/industries"
+  industriesRoot: "docs/src/content/docs/profiles/industries",
+  requirementCategoryDirs: DEFAULT_REQUIREMENT_CATEGORY_DIRS
 });
 function resolveAgentPaths(paths) {
   const docsRoot = paths?.docsRoot ?? DEFAULT_AGENT_PATHS.docsRoot;
@@ -1702,6 +1716,20 @@ function resolveAgentPaths(paths) {
   const companiesRoot = paths?.companiesRoot ?? `${profilesRoot}/companies`;
   const softwareRoot = paths?.softwareRoot ?? `${profilesRoot}/software`;
   const industriesRoot = paths?.industriesRoot ?? `${profilesRoot}/industries`;
+  const categoryOverrides = paths?.requirementCategoryDirs;
+  const requirementCategoryDirs = {
+    business: categoryOverrides?.business ?? DEFAULT_REQUIREMENT_CATEGORY_DIRS.business,
+    functional: categoryOverrides?.functional ?? DEFAULT_REQUIREMENT_CATEGORY_DIRS.functional,
+    nonFunctional: categoryOverrides?.nonFunctional ?? DEFAULT_REQUIREMENT_CATEGORY_DIRS.nonFunctional,
+    technical: categoryOverrides?.technical ?? DEFAULT_REQUIREMENT_CATEGORY_DIRS.technical,
+    architecturalDecisions: categoryOverrides?.architecturalDecisions ?? DEFAULT_REQUIREMENT_CATEGORY_DIRS.architecturalDecisions,
+    security: categoryOverrides?.security ?? DEFAULT_REQUIREMENT_CATEGORY_DIRS.security,
+    data: categoryOverrides?.data ?? DEFAULT_REQUIREMENT_CATEGORY_DIRS.data,
+    integration: categoryOverrides?.integration ?? DEFAULT_REQUIREMENT_CATEGORY_DIRS.integration,
+    operational: categoryOverrides?.operational ?? DEFAULT_REQUIREMENT_CATEGORY_DIRS.operational,
+    ux: categoryOverrides?.ux ?? DEFAULT_REQUIREMENT_CATEGORY_DIRS.ux,
+    multiTenancy: categoryOverrides?.multiTenancy ?? DEFAULT_REQUIREMENT_CATEGORY_DIRS.multiTenancy
+  };
   return {
     docsRoot,
     researchRoot,
@@ -1713,7 +1741,8 @@ function resolveAgentPaths(paths) {
     peopleRoot,
     companiesRoot,
     softwareRoot,
-    industriesRoot
+    industriesRoot,
+    requirementCategoryDirs
   };
 }
 
@@ -6157,7 +6186,7 @@ function buildScanBusinessModelsSkill(paths, issueDefaults) {
       "Optional extensions in the issue body:",
       "- `plan: <path>` \u2014 path to the industry-discovery plan file that",
       "  cleared this industry for downstream research (e.g.",
-      "  `docs/industries/plans/<slug>.plan.md`)",
+      `  \`${paths.industriesRoot}/plans/<slug>.plan.md\`)`,
       "- `sources: <list>` \u2014 additional authorized input paths",
       "- `exclude: <segment list>` \u2014 segments already covered to skip",
       "- `slug: <kebab-case>` \u2014 override the derived industry slug",
@@ -6557,15 +6586,15 @@ function buildCompanyProfileAnalystSubAgent(paths, issueDefaults, tier) {
       "",
       "| Placeholder | Meaning | Default |",
       "|-------------|---------|---------|",
-      "| `<COMPANY_ROOT>` | Root folder for company profiles | `docs/companies/` |",
+      `| \`<COMPANY_ROOT>\` | Root folder for company profiles | \`${paths.companiesRoot}/\` |`,
       "| `<PROFILES_DIR>` | Final company profile files | `<COMPANY_ROOT>/profiles/` |",
       "| `<NOTES_DIR>` | Research-notes files from Phase 1 | `<COMPANY_ROOT>/notes/` |",
       "| `<ANALYSIS_DIR>` | Segment-level competitive-analysis documents from Phase 6 | `<COMPANY_ROOT>/analysis/` |",
       "| `<COMPANY_SLUG>` | Short kebab-case slug identifying the company | derived from the company name |",
       "| `<SEGMENT_SLUG>` | Short kebab-case slug identifying the industry segment | derived from the segment name |",
       `| \`<BUSINESS_MODELS_ROOT>\` | Where existing business-model canvases live (consumed by Phase 4) | \`${paths.docsRoot}/industry-research/\` |`,
-      "| `<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/` |",
+      `| \`<PEOPLE_PROFILES_DIR>\` | Where existing people profiles live (for duplicate detection during followup) | \`${paths.peopleRoot}/profiles/\` |`,
+      `| \`<SOFTWARE_PROFILES_DIR>\` | Where existing software profiles live (for duplicate detection during followup) | \`${paths.softwareRoot}/profiles/\` |`,
       "",
       `If \`${paths.docsRoot}/project-context.md\` specifies a different company-research`,
       "tree (for example by reusing the research-pipeline deliverables",
@@ -7388,8 +7417,8 @@ function buildProfileCompanySkill(paths, issueDefaults) {
       `If the project has no override in \`${paths.docsRoot}/project-context.md\` or`,
       "`agentConfig.rules`, outputs land under:",
       "",
-      "- `docs/companies/notes/<slug>.notes.md`",
-      "- `docs/companies/profiles/<slug>.md`",
+      `- \`${paths.companiesRoot}/notes/<slug>.notes.md\``,
+      `- \`${paths.companiesRoot}/profiles/<slug>.md\``,
       "",
       "## Steps",
       "",
@@ -7594,7 +7623,7 @@ function buildAnalyzeSegmentSkill(paths, issueDefaults) {
       `If the project has no override in \`${paths.docsRoot}/project-context.md\` or`,
       "`agentConfig.rules`, outputs land under:",
       "",
-      "- `docs/companies/analysis/<segment-slug>.md`",
+      `- \`${paths.companiesRoot}/analysis/<segment-slug>.md\``,
       "",
       "## Blocking Rule",
       "",
@@ -8026,7 +8055,7 @@ function buildCustomerProfileAnalystSubAgent(paths, issueDefaults, tier) {
       "| `<COMPETITORS_DIR>` | Per-archetype competitor analyses | `<CUSTOMER_ROOT>/competitors/` |",
       "| `<COMPETITORS_PAGE>` | One-archetype competitor-analysis page | `<COMPETITORS_DIR>/<ARCHETYPE_SLUG>.md` |",
       "| `<DISCOVERY_DIR>` | Discovery reports written during Phase 1 | `<researchRoot>/customer/` |",
-      "| `<MATRIX_FILE>` | Shared software-profile feature-matrix file | `docs/software/feature-matrix.md` |",
+      `| \`<MATRIX_FILE>\` | Shared software-profile feature-matrix file | \`${paths.softwareRoot}/feature-matrix.md\` |`,
       "| `<SCOPE_SLUG>` | Short kebab-case slug identifying the discovery scope | derived from the discover issue |",
       "| `<ARCHETYPE_SLUG>` | Short kebab-case slug identifying one archetype | derived from the profile issue |",
       "",
@@ -8659,7 +8688,7 @@ function buildAnalyzeCustomerCompetitorsSkill(paths, issueDefaults) {
       "",
       "Optional extensions:",
       "- `matrix_file: <path>` \u2014 override for the shared feature-matrix",
-      "  file. Defaults to `docs/software/feature-matrix.md`.",
+      `  file. Defaults to \`${paths.softwareRoot}/feature-matrix.md\`.`,
       "",
       "## Default Paths",
       "",
@@ -10505,7 +10534,7 @@ function buildIndustryDiscoveryAnalystSubAgent(paths, issueDefaults) {
       "",
       "| Placeholder | Meaning | Default |",
       "|-------------|---------|---------|",
-      "| `<INDUSTRY_ROOT>` | Root folder for all industry-discovery outputs | `docs/industries/` |",
+      `| \`<INDUSTRY_ROOT>\` | Root folder for all industry-discovery outputs | \`${paths.industriesRoot}/\` |`,
       "| `<CANDIDATES_DIR>` | Candidate-list files (Phase 1) | `<INDUSTRY_ROOT>/candidates/` |",
       "| `<EVALUATIONS_DIR>` | Evaluation files with per-candidate scores (Phase 2) | `<INDUSTRY_ROOT>/evaluations/` |",
       "| `<PLANS_DIR>` | Plan files summarizing downstream research (Phase 3) | `<INDUSTRY_ROOT>/plans/` |",
@@ -10826,9 +10855,9 @@ function buildDiscoverIndustriesSkill(paths, issueDefaults) {
       `If the project has no override in \`${paths.docsRoot}/project-context.md\` or`,
       "`agentConfig.rules`, outputs land under:",
       "",
-      "- `docs/industries/candidates/<slug>.candidates.md`",
-      "- `docs/industries/evaluations/<slug>.evaluation.md`",
-      "- `docs/industries/plans/<slug>.plan.md`",
+      `- \`${paths.industriesRoot}/candidates/<slug>.candidates.md\``,
+      `- \`${paths.industriesRoot}/evaluations/<slug>.evaluation.md\``,
+      `- \`${paths.industriesRoot}/plans/<slug>.plan.md\``,
       "",
       "## Steps",
       "",
@@ -16459,13 +16488,13 @@ function buildPeopleProfileAnalystSubAgent(paths, issueDefaults, tier) {
       "",
       "| Placeholder | Meaning | Default |",
       "|-------------|---------|---------|",
-      "| `<PEOPLE_ROOT>` | Root folder for person profiles | `docs/people/` |",
+      `| \`<PEOPLE_ROOT>\` | Root folder for person profiles | \`${paths.peopleRoot}/\` |`,
       "| `<PROFILES_DIR>` | Final person profile files | `<PEOPLE_ROOT>/profiles/` |",
       "| `<NOTES_DIR>` | Research-notes files from Phase 1 | `<PEOPLE_ROOT>/notes/` |",
       "| `<PERSON_SLUG>` | Short kebab-case slug identifying the person | derived from the person's name |",
-      "| `<COMPANIES_DIR>` | Where existing company profiles live (for cross-references and duplicate detection during followup) | `docs/companies/profiles/` |",
-      "| `<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/` |",
+      `| \`<COMPANIES_DIR>\` | Where existing company profiles live (for cross-references and duplicate detection during followup) | \`${paths.companiesRoot}/profiles/\` |`,
+      `| \`<SOFTWARE_DIR>\` | Where existing software profiles live (for cross-references and duplicate detection during followup) | \`${paths.softwareRoot}/profiles/\` |`,
+      `| \`<MEETINGS_DIR>\` | Where meeting notes live (for cross-references) | \`${paths.meetingsRoot}/\` |`,
       "",
       `If \`${paths.docsRoot}/project-context.md\` specifies a different people-research`,
       "tree or cross-reference target, prefer that. Otherwise fall back to",
@@ -17037,14 +17066,14 @@ function buildProfilePersonSkill(paths, issueDefaults) {
       `If the project has no override in \`${paths.docsRoot}/project-context.md\` or`,
       "`agentConfig.rules`, outputs land under:",
       "",
-      "- `docs/people/notes/<slug>.notes.md`",
-      "- `docs/people/profiles/<slug>.md`",
+      `- \`${paths.peopleRoot}/notes/<slug>.notes.md\``,
+      `- \`${paths.peopleRoot}/profiles/<slug>.md\``,
       "",
       "Cross-references are resolved against:",
       "",
-      "- `docs/companies/profiles/`",
-      "- `docs/software/profiles/`",
-      "- `docs/meetings/`",
+      `- \`${paths.companiesRoot}/profiles/\``,
+      `- \`${paths.softwareRoot}/profiles/\``,
+      `- \`${paths.meetingsRoot}/\``,
       "",
       "## Steps",
       "",
@@ -20803,7 +20832,7 @@ function buildRequirementsAnalystSubAgent(paths, issueDefaults) {
       `| \`<COMPETITIVE_ROOT>\` | Competitive analysis docs | \`${paths.docsRoot}/business-strategy/competitive/\` |`,
       `| \`<PRODUCT_ROOT>\` | Product roadmap / entity taxonomy | \`${paths.docsRoot}/product/\` |`,
       `| \`<MEETINGS_ROOT>\` | Meeting extracts | \`${paths.docsRoot}/research/meetings/\` |`,
-      `| \`<RESEARCH_REQUIREMENTS_ROOT>\` | Scan reports and proposals | \`${paths.docsRoot}/research/requirements/\` |`,
+      `| \`<RESEARCH_REQUIREMENTS_ROOT>\` | Scan reports and proposals | \`${paths.researchRequirementsRoot}/\` |`,
       `| \`<REQUIREMENTS_ROOT>\` | Final requirement documents (owned by requirements-writer) | \`${paths.requirementsRoot}/\` |`,
       "| `<PREFIX>` | Project-specific requirement ID prefix | e.g. `VRTX`, `ACME` |",
       "",
@@ -21224,7 +21253,7 @@ function buildRequirementsAnalystBundle(paths = DEFAULT_AGENT_PATHS, issueDefaul
 var requirementsAnalystBundle = buildRequirementsAnalystBundle();
 
 // src/agent/bundles/requirements-writer.ts
-var TEMPLATE_BR = `---
+var templateBr = (paths) => `---
 title: "BR-NNN: [Business Requirement Title]"
 ---
 
@@ -21293,9 +21322,9 @@ Other business requirements, external factors, or organizational decisions this
 
 ## Traceability
 
-- **Decomposes into:** [FR-NNN](../functional/FR-NNN-slug.md), [FR-NNN](../functional/FR-NNN-slug.md)
-- **Constrained by:** [NFR-NNN](../non-functional/NFR-NNN-slug.md)
-- **Related:** [SEC-NNN](../security/SEC-NNN-slug.md)
+- **Decomposes into:** [FR-NNN](../${paths.requirementCategoryDirs.functional}/FR-NNN-slug.md), [FR-NNN](../${paths.requirementCategoryDirs.functional}/FR-NNN-slug.md)
+- **Constrained by:** [NFR-NNN](../${paths.requirementCategoryDirs.nonFunctional}/NFR-NNN-slug.md)
+- **Related:** [SEC-NNN](../${paths.requirementCategoryDirs.security}/SEC-NNN-slug.md)
 - **Depends on (cross-tier):** [XX-NNN](../category/XX-NNN-slug.md) \u2014 [platform/industry requirement this depends on]
 - **Enables (cross-tier):** [XX-NNN](../category/XX-NNN-slug.md) \u2014 [customer-workflow/consumer-app requirement this enables]
 
@@ -21331,7 +21360,7 @@ Other business requirements, external factors, or organizational decisions this
 |---|---|---|
 | YYYY-MM-DD | [Name] | Initial draft |
 `;
-var TEMPLATE_FR = `---
+var templateFr = (paths) => `---
 title: "FR-NNN: [Functional Requirement Title]"
 ---
 
@@ -21432,9 +21461,9 @@ What data is created, read, updated, or deleted by this feature. Reference DR do
 
 ## Traceability
 
-- **Implements:** [BR-NNN](../business/BR-NNN-slug.md)
-- **Constrained by:** [NFR-NNN](../non-functional/NFR-NNN-slug.md)
-- **Related:** [INT-NNN](../integration/INT-NNN-slug.md)
+- **Implements:** [BR-NNN](../${paths.requirementCategoryDirs.business}/BR-NNN-slug.md)
+- **Constrained by:** [NFR-NNN](../${paths.requirementCategoryDirs.nonFunctional}/NFR-NNN-slug.md)
+- **Related:** [INT-NNN](../${paths.requirementCategoryDirs.integration}/INT-NNN-slug.md)
 - **Depends on (cross-tier):** [XX-NNN](../category/XX-NNN-slug.md) \u2014 [platform/industry requirement this depends on]
 - **Enables (cross-tier):** [XX-NNN](../category/XX-NNN-slug.md) \u2014 [customer-workflow/consumer-app requirement this enables]
 
@@ -21470,7 +21499,7 @@ What data is created, read, updated, or deleted by this feature. Reference DR do
 |---|---|---|
 | YYYY-MM-DD | [Name] | Initial draft |
 `;
-var TEMPLATE_NFR = `---
+var templateNfr = (paths) => `---
 title: "NFR-NNN: [Non-Functional Requirement Title]"
 ---
 
@@ -21532,9 +21561,9 @@ How compliance with this requirement will be monitored in production. Reference
 
 ## Traceability
 
-- **Supports:** [BR-NNN](../business/BR-NNN-slug.md)
-- **Constrains:** [FR-NNN](../functional/FR-NNN-slug.md)
-- **Monitored by:** [OPS-NNN](../operational/OPS-NNN-slug.md)
+- **Supports:** [BR-NNN](../${paths.requirementCategoryDirs.business}/BR-NNN-slug.md)
+- **Constrains:** [FR-NNN](../${paths.requirementCategoryDirs.functional}/FR-NNN-slug.md)
+- **Monitored by:** [OPS-NNN](../${paths.requirementCategoryDirs.operational}/OPS-NNN-slug.md)
 - **Depends on (cross-tier):** [XX-NNN](../category/XX-NNN-slug.md) \u2014 [platform/industry requirement this depends on]
 - **Enables (cross-tier):** [XX-NNN](../category/XX-NNN-slug.md) \u2014 [customer-workflow/consumer-app requirement this enables]
 
@@ -21570,7 +21599,7 @@ How compliance with this requirement will be monitored in production. Reference
 |---|---|---|
 | YYYY-MM-DD | [Name] | Initial draft |
 `;
-var TEMPLATE_TR = `---
+var templateTr = (paths) => `---
 title: "TR-NNN: [Technical Requirement Title]"
 ---
 
@@ -21683,9 +21712,9 @@ Other technologies this choice interacts with, and any known compatibility const
 
 ## Traceability
 
-- **Justified by:** [ADR-NNN](../architectural-decisions/ADR-NNN-slug.md)
-- **Supports:** [FR-NNN](../functional/FR-NNN-slug.md)
-- **Constrained by:** [NFR-NNN](../non-functional/NFR-NNN-slug.md)
+- **Justified by:** [ADR-NNN](../${paths.requirementCategoryDirs.architecturalDecisions}/ADR-NNN-slug.md)
+- **Supports:** [FR-NNN](../${paths.requirementCategoryDirs.functional}/FR-NNN-slug.md)
+- **Constrained by:** [NFR-NNN](../${paths.requirementCategoryDirs.nonFunctional}/NFR-NNN-slug.md)
 - **Depends on (cross-tier):** [XX-NNN](../category/XX-NNN-slug.md) \u2014 [platform/industry requirement this depends on]
 - **Enables (cross-tier):** [XX-NNN](../category/XX-NNN-slug.md) \u2014 [customer-workflow/consumer-app requirement this enables]
 
@@ -21721,7 +21750,7 @@ Other technologies this choice interacts with, and any known compatibility const
 |---|---|---|
 | YYYY-MM-DD | [Name] | Initial draft |
 `;
-var TEMPLATE_ADR = `---
+var templateAdr = (paths) => `---
 title: "ADR-NNN: [Decision Title]"
 ---
 
@@ -21811,8 +21840,8 @@ High-level guidance for implementing this decision. Detailed implementation goes
 
 ## Traceability
 
-- **Supports:** [BR-NNN](../business/BR-NNN-slug.md)
-- **Implemented by:** [TR-NNN](../technical/TR-NNN-slug.md)
+- **Supports:** [BR-NNN](../${paths.requirementCategoryDirs.business}/BR-NNN-slug.md)
+- **Implemented by:** [TR-NNN](../${paths.requirementCategoryDirs.technical}/TR-NNN-slug.md)
 - **Related:** [ADR-NNN](ADR-NNN-slug.md)
 - **Depends on (cross-tier):** [XX-NNN](../category/XX-NNN-slug.md) \u2014 [platform/industry requirement this depends on]
 - **Enables (cross-tier):** [XX-NNN](../category/XX-NNN-slug.md) \u2014 [customer-workflow/consumer-app requirement this enables]
@@ -21849,7 +21878,7 @@ High-level guidance for implementing this decision. Detailed implementation goes
 |---|---|---|
 | YYYY-MM-DD | [Name] | Initial draft |
 `;
-var TEMPLATE_SEC = `---
+var templateSec = (paths) => `---
 title: "SEC-NNN: [Security Requirement Title]"
 ---
 
@@ -21921,10 +21950,10 @@ How compliance with this security requirement will be verified.
 
 ## Traceability
 
-- **Protects:** [FR-NNN](../functional/FR-NNN-slug.md)
-- **Constrained by:** [NFR-NNN](../non-functional/NFR-NNN-slug.md)
-- **Implements:** [BR-NNN](../business/BR-NNN-slug.md)
-- **Related data:** [DR-NNN](../data/DR-NNN-slug.md)
+- **Protects:** [FR-NNN](../${paths.requirementCategoryDirs.functional}/FR-NNN-slug.md)
+- **Constrained by:** [NFR-NNN](../${paths.requirementCategoryDirs.nonFunctional}/NFR-NNN-slug.md)
+- **Implements:** [BR-NNN](../${paths.requirementCategoryDirs.business}/BR-NNN-slug.md)
+- **Related data:** [DR-NNN](../${paths.requirementCategoryDirs.data}/DR-NNN-slug.md)
 - **Depends on (cross-tier):** [XX-NNN](../category/XX-NNN-slug.md) \u2014 [platform/industry requirement this depends on]
 - **Enables (cross-tier):** [XX-NNN](../category/XX-NNN-slug.md) \u2014 [customer-workflow/consumer-app requirement this enables]
 
@@ -21960,7 +21989,7 @@ How compliance with this security requirement will be verified.
 |---|---|---|
 | YYYY-MM-DD | [Name] | Initial draft |
 `;
-var TEMPLATE_DR = `---
+var templateDr = (paths) => `---
 title: "DR-NNN: [Data Requirement Title]"
 ---
 
@@ -22036,9 +22065,9 @@ How this data is classified and what handling rules apply based on that classifi
 
 ## Traceability
 
-- **Supports:** [FR-NNN](../functional/FR-NNN-slug.md)
-- **Protected by:** [SEC-NNN](../security/SEC-NNN-slug.md)
-- **Stored per:** [TR-NNN](../technical/TR-NNN-slug.md)
+- **Supports:** [FR-NNN](../${paths.requirementCategoryDirs.functional}/FR-NNN-slug.md)
+- **Protected by:** [SEC-NNN](../${paths.requirementCategoryDirs.security}/SEC-NNN-slug.md)
+- **Stored per:** [TR-NNN](../${paths.requirementCategoryDirs.technical}/TR-NNN-slug.md)
 - **Depends on (cross-tier):** [XX-NNN](../category/XX-NNN-slug.md) \u2014 [platform/industry requirement this depends on]
 - **Enables (cross-tier):** [XX-NNN](../category/XX-NNN-slug.md) \u2014 [customer-workflow/consumer-app requirement this enables]
 
@@ -22074,7 +22103,7 @@ How this data is classified and what handling rules apply based on that classifi
 |---|---|---|
 | YYYY-MM-DD | [Name] | Initial draft |
 `;
-var TEMPLATE_INT = `---
+var templateInt = (paths) => `---
 title: "INT-NNN: [Integration Requirement Title]"
 ---
 
@@ -22167,9 +22196,9 @@ What happens when this integration is unavailable. How does the system degrade g
 
 ## Traceability
 
-- **Enables:** [FR-NNN](../functional/FR-NNN-slug.md)
-- **Constrained by:** [NFR-NNN](../non-functional/NFR-NNN-slug.md)
-- **Secured by:** [SEC-NNN](../security/SEC-NNN-slug.md)
+- **Enables:** [FR-NNN](../${paths.requirementCategoryDirs.functional}/FR-NNN-slug.md)
+- **Constrained by:** [NFR-NNN](../${paths.requirementCategoryDirs.nonFunctional}/NFR-NNN-slug.md)
+- **Secured by:** [SEC-NNN](../${paths.requirementCategoryDirs.security}/SEC-NNN-slug.md)
 - **Depends on (cross-tier):** [XX-NNN](../category/XX-NNN-slug.md) \u2014 [platform/industry requirement this depends on]
 - **Enables (cross-tier):** [XX-NNN](../category/XX-NNN-slug.md) \u2014 [customer-workflow/consumer-app requirement this enables]
 
@@ -22205,7 +22234,7 @@ What happens when this integration is unavailable. How does the system degrade g
 |---|---|---|
 | YYYY-MM-DD | [Name] | Initial draft |
 `;
-var TEMPLATE_OPS = `---
+var templateOps = (paths) => `---
 title: "OPS-NNN: [Operational Requirement Title]"
 ---
 
@@ -22281,9 +22310,9 @@ If this applies to an existing system, document the current operational posture.
 
 ## Traceability
 
-- **Monitors:** [NFR-NNN](../non-functional/NFR-NNN-slug.md)
-- **Supports:** [BR-NNN](../business/BR-NNN-slug.md)
-- **Uses:** [TR-NNN](../technical/TR-NNN-slug.md)
+- **Monitors:** [NFR-NNN](../${paths.requirementCategoryDirs.nonFunctional}/NFR-NNN-slug.md)
+- **Supports:** [BR-NNN](../${paths.requirementCategoryDirs.business}/BR-NNN-slug.md)
+- **Uses:** [TR-NNN](../${paths.requirementCategoryDirs.technical}/TR-NNN-slug.md)
 - **Depends on (cross-tier):** [XX-NNN](../category/XX-NNN-slug.md) \u2014 [platform/industry requirement this depends on]
 - **Enables (cross-tier):** [XX-NNN](../category/XX-NNN-slug.md) \u2014 [customer-workflow/consumer-app requirement this enables]
 
@@ -22319,7 +22348,7 @@ If this applies to an existing system, document the current operational posture.
 |---|---|---|
 | YYYY-MM-DD | [Name] | Initial draft |
 `;
-var TEMPLATE_UX = `---
+var templateUx = (paths) => `---
 title: "UX-NNN: [UX Requirement Title]"
 ---
 
@@ -22397,9 +22426,9 @@ Reference to the project's design system, component library, or style guide if o
 
 ## Traceability
 
-- **Enhances:** [FR-NNN](../functional/FR-NNN-slug.md)
-- **Constrained by:** [NFR-NNN](../non-functional/NFR-NNN-slug.md)
-- **Supports:** [BR-NNN](../business/BR-NNN-slug.md)
+- **Enhances:** [FR-NNN](../${paths.requirementCategoryDirs.functional}/FR-NNN-slug.md)
+- **Constrained by:** [NFR-NNN](../${paths.requirementCategoryDirs.nonFunctional}/NFR-NNN-slug.md)
+- **Supports:** [BR-NNN](../${paths.requirementCategoryDirs.business}/BR-NNN-slug.md)
 - **Depends on (cross-tier):** [XX-NNN](../category/XX-NNN-slug.md) \u2014 [platform/industry requirement this depends on]
 - **Enables (cross-tier):** [XX-NNN](../category/XX-NNN-slug.md) \u2014 [customer-workflow/consumer-app requirement this enables]
 
@@ -22435,7 +22464,7 @@ Reference to the project's design system, component library, or style guide if o
 |---|---|---|
 | YYYY-MM-DD | [Name] | Initial draft |
 `;
-var TEMPLATE_MT = `---
+var templateMt = (paths) => `---
 title: "MT-NNN: [Multi-Tenancy Requirement Title]"
 ---
 
@@ -22514,9 +22543,9 @@ How the system prevents one tenant from degrading the experience of others.
 
 ## Traceability
 
-- **Implements:** [BR-NNN](../business/BR-NNN-slug.md)
-- **Secured by:** [SEC-NNN](../security/SEC-NNN-slug.md)
-- **Constrained by:** [NFR-NNN](../non-functional/NFR-NNN-slug.md)
+- **Implements:** [BR-NNN](../${paths.requirementCategoryDirs.business}/BR-NNN-slug.md)
+- **Secured by:** [SEC-NNN](../${paths.requirementCategoryDirs.security}/SEC-NNN-slug.md)
+- **Constrained by:** [NFR-NNN](../${paths.requirementCategoryDirs.nonFunctional}/NFR-NNN-slug.md)
 - **Depends on (cross-tier):** [XX-NNN](../category/XX-NNN-slug.md) \u2014 [platform/industry requirement this depends on]
 - **Enables (cross-tier):** [XX-NNN](../category/XX-NNN-slug.md) \u2014 [customer-workflow/consumer-app requirement this enables]
 
@@ -22587,7 +22616,7 @@ Use [\`_template-{PREFIX}.md\`](../templates/_template-{PREFIX}.md) for all new
 - Every document must include YAML frontmatter with a \`title\` field
 - Every document must include a \`## Traceability\` section
 `;
-var TEMPLATE_REQUIREMENTS_README = `---
+var templateRequirementsReadme = (paths) => `---
 title: "[Project Name] \u2014 Requirements Documentation"
 ---
 
@@ -22597,17 +22626,17 @@ This directory contains the structured requirements taxonomy for [Project Name].
 
 | Category | Prefix | Directory | Purpose |
 |---|---|---|---|
-| Business Requirements | BR | [\`business/\`](business/README.md) | Strategic intent, stakeholders, success metrics |
-| Functional Requirements | FR | [\`functional/\`](functional/README.md) | User stories, flows, acceptance criteria |
-| Non-Functional Requirements | NFR | [\`non-functional/\`](non-functional/README.md) | Performance, scalability, availability targets |
-| Technical Requirements | TR | [\`technical/\`](technical/README.md) | Technology choices, framework decisions |
-| Architectural Decisions | ADR | [\`architectural-decisions/\`](architectural-decisions/README.md) | Context, decision, consequences (standard ADR format) |
-| Security & Compliance | SEC | [\`security/\`](security/README.md) | Auth, encryption, audit, regulatory |
-| Data Requirements | DR | [\`data/\`](data/README.md) | Data models, retention, classification, RPO/RTO |
-| Integration Requirements | INT | [\`integration/\`](integration/README.md) | APIs, third-party systems, protocols |
-| Operational Requirements | OPS | [\`operational/\`](operational/README.md) | Deployment, monitoring, alerting, logging |
-| UX Requirements | UX | [\`ux/\`](ux/README.md) | Accessibility, responsiveness, i18n |
-| Multi-Tenancy & Licensing | MT | [\`multi-tenancy/\`](multi-tenancy/README.md) | Tenant isolation, feature gating, billing |
+| Business Requirements | BR | [\`${paths.requirementCategoryDirs.business}/\`](${paths.requirementCategoryDirs.business}/README.md) | Strategic intent, stakeholders, success metrics |
+| Functional Requirements | FR | [\`${paths.requirementCategoryDirs.functional}/\`](${paths.requirementCategoryDirs.functional}/README.md) | User stories, flows, acceptance criteria |
+| Non-Functional Requirements | NFR | [\`${paths.requirementCategoryDirs.nonFunctional}/\`](${paths.requirementCategoryDirs.nonFunctional}/README.md) | Performance, scalability, availability targets |
+| Technical Requirements | TR | [\`${paths.requirementCategoryDirs.technical}/\`](${paths.requirementCategoryDirs.technical}/README.md) | Technology choices, framework decisions |
+| Architectural Decisions | ADR | [\`${paths.requirementCategoryDirs.architecturalDecisions}/\`](${paths.requirementCategoryDirs.architecturalDecisions}/README.md) | Context, decision, consequences (standard ADR format) |
+| Security & Compliance | SEC | [\`${paths.requirementCategoryDirs.security}/\`](${paths.requirementCategoryDirs.security}/README.md) | Auth, encryption, audit, regulatory |
+| Data Requirements | DR | [\`${paths.requirementCategoryDirs.data}/\`](${paths.requirementCategoryDirs.data}/README.md) | Data models, retention, classification, RPO/RTO |
+| Integration Requirements | INT | [\`${paths.requirementCategoryDirs.integration}/\`](${paths.requirementCategoryDirs.integration}/README.md) | APIs, third-party systems, protocols |
+| Operational Requirements | OPS | [\`${paths.requirementCategoryDirs.operational}/\`](${paths.requirementCategoryDirs.operational}/README.md) | Deployment, monitoring, alerting, logging |
+| UX Requirements | UX | [\`${paths.requirementCategoryDirs.ux}/\`](${paths.requirementCategoryDirs.ux}/README.md) | Accessibility, responsiveness, i18n |
+| Multi-Tenancy & Licensing | MT | [\`${paths.requirementCategoryDirs.multiTenancy}/\`](${paths.requirementCategoryDirs.multiTenancy}/README.md) | Tenant isolation, feature gating, billing |
 
 Each directory contains a \`README.md\` with detailed guidance on what belongs in that category (and what doesn't), common disambiguation tips, and project-specific context. When unsure where a requirement belongs, start with the category README.
 
@@ -22673,9 +22702,9 @@ Example:
 \`\`\`markdown
 ## Traceability
 
-- **Implements:** [FR-001](../functional/FR-001-user-registration.md)
-- **Constrained by:** [NFR-001](../non-functional/NFR-001-uptime-sla.md)
-- **Related:** [SEC-001](../security/SEC-001-multi-tenant-auth.md)
+- **Implements:** [FR-001](../${paths.requirementCategoryDirs.functional}/FR-001-user-registration.md)
+- **Constrained by:** [NFR-001](../${paths.requirementCategoryDirs.nonFunctional}/NFR-001-uptime-sla.md)
+- **Related:** [SEC-001](../${paths.requirementCategoryDirs.security}/SEC-001-multi-tenant-auth.md)
 \`\`\`
 
 ### Link Types
@@ -23069,35 +23098,70 @@ var WRITE_REQUIREMENT_EVALS_JSON = JSON.stringify(
   null,
   2
 );
-var REQUIREMENTS_WRITER_REFERENCE_FILES = [
-  { path: "_references/templates/_template-BR.md", content: TEMPLATE_BR },
-  { path: "_references/templates/_template-FR.md", content: TEMPLATE_FR },
-  { path: "_references/templates/_template-NFR.md", content: TEMPLATE_NFR },
-  { path: "_references/templates/_template-TR.md", content: TEMPLATE_TR },
-  { path: "_references/templates/_template-ADR.md", content: TEMPLATE_ADR },
-  { path: "_references/templates/_template-SEC.md", content: TEMPLATE_SEC },
-  { path: "_references/templates/_template-DR.md", content: TEMPLATE_DR },
-  { path: "_references/templates/_template-INT.md", content: TEMPLATE_INT },
-  { path: "_references/templates/_template-OPS.md", content: TEMPLATE_OPS },
-  { path: "_references/templates/_template-UX.md", content: TEMPLATE_UX },
-  { path: "_references/templates/_template-MT.md", content: TEMPLATE_MT },
-  {
-    path: "_references/templates/_template-category-README.md",
-    content: TEMPLATE_CATEGORY_README
-  },
-  {
-    path: "_references/templates/_template-requirements-README.md",
-    content: TEMPLATE_REQUIREMENTS_README
-  },
-  {
-    path: "_references/standards-and-frameworks.md",
-    content: STANDARDS_AND_FRAMEWORKS
-  },
-  {
-    path: "evals/evals.json",
-    content: WRITE_REQUIREMENT_EVALS_JSON
-  }
-];
+function buildRequirementsWriterReferenceFiles(paths) {
+  return [
+    {
+      path: "_references/templates/_template-BR.md",
+      content: templateBr(paths)
+    },
+    {
+      path: "_references/templates/_template-FR.md",
+      content: templateFr(paths)
+    },
+    {
+      path: "_references/templates/_template-NFR.md",
+      content: templateNfr(paths)
+    },
+    {
+      path: "_references/templates/_template-TR.md",
+      content: templateTr(paths)
+    },
+    {
+      path: "_references/templates/_template-ADR.md",
+      content: templateAdr(paths)
+    },
+    {
+      path: "_references/templates/_template-SEC.md",
+      content: templateSec(paths)
+    },
+    {
+      path: "_references/templates/_template-DR.md",
+      content: templateDr(paths)
+    },
+    {
+      path: "_references/templates/_template-INT.md",
+      content: templateInt(paths)
+    },
+    {
+      path: "_references/templates/_template-OPS.md",
+      content: templateOps(paths)
+    },
+    {
+      path: "_references/templates/_template-UX.md",
+      content: templateUx(paths)
+    },
+    {
+      path: "_references/templates/_template-MT.md",
+      content: templateMt(paths)
+    },
+    {
+      path: "_references/templates/_template-category-README.md",
+      content: TEMPLATE_CATEGORY_README
+    },
+    {
+      path: "_references/templates/_template-requirements-README.md",
+      content: templateRequirementsReadme(paths)
+    },
+    {
+      path: "_references/standards-and-frameworks.md",
+      content: STANDARDS_AND_FRAMEWORKS
+    },
+    {
+      path: "evals/evals.json",
+      content: WRITE_REQUIREMENT_EVALS_JSON
+    }
+  ];
+}
 function buildRequirementsWriterSubAgent(paths) {
   return {
     name: "requirements-writer",
@@ -23297,13 +23361,13 @@ function buildRequirementsWriterSubAgent(paths) {
       "1. Write the requirement itself (FR, DR, INT, OPS, etc.) with full",
       "   detail.",
       "2. Where the requirement needs a technology decision, add a note:",
-      '   *"Technology selection pending \u2014 see [ADR-NNN](../architectural-decisions/ADR-NNN-slug.md)"*.',
+      `   *"Technology selection pending \u2014 see [ADR-NNN](../${paths.requirementCategoryDirs.architecturalDecisions}/ADR-NNN-slug.md)"*.`,
       "3. Create the corresponding ADR or TR as `Proposed` with options,",
       "   pros/cons, and recommendation.",
       '4. In the ADR/TR open items, add: *"Human decision required.',
       '   Dependent requirements: [list]"*.',
       "5. In the original requirement's open items, add a cross-reference:",
-      '   *"Blocked by [ADR-NNN](../architectural-decisions/ADR-NNN-slug.md) \u2014',
+      `   *"Blocked by [ADR-NNN](../${paths.requirementCategoryDirs.architecturalDecisions}/ADR-NNN-slug.md) \u2014`,
       '   technology selection pending human review."*',
       "",
       "This creates a clear chain: the requirement is understood, the",
@@ -23390,9 +23454,9 @@ function buildRequirementsWriterSubAgent(paths) {
       "```markdown",
       "## Traceability",
       "",
-      "- **Implements:** [BR-001](../business/BR-001-self-service-onboarding.md)",
-      "- **Constrained by:** [NFR-001](../non-functional/NFR-001-api-response-times.md)",
-      "- **Related:** [SEC-001](../security/SEC-001-authentication-framework.md)",
+      `- **Implements:** [BR-001](../${paths.requirementCategoryDirs.business}/BR-001-self-service-onboarding.md)`,
+      `- **Constrained by:** [NFR-001](../${paths.requirementCategoryDirs.nonFunctional}/NFR-001-api-response-times.md)`,
+      `- **Related:** [SEC-001](../${paths.requirementCategoryDirs.security}/SEC-001-authentication-framework.md)`,
       "```",
       "",
       "### Link Types",
@@ -23452,7 +23516,7 @@ function buildRequirementsWriterSubAgent(paths) {
       "",
       "Number each item within its subsection. Assign a priority. Call out",
       "interdependencies with open items in other documents using the",
-      "format: `-> Depends on: [FR-001 Open Item #2](../functional/FR-001-slug.md#open-items)`.",
+      `format: \`-> Depends on: [FR-001 Open Item #2](../${paths.requirementCategoryDirs.functional}/FR-001-slug.md#open-items)\`.`,
       "",
       "The `## Open Items` section is **not optional** \u2014 it appears in every",
       'document, even if a subsection is empty (write "None identified.").',
@@ -23711,7 +23775,7 @@ function buildWriteRequirementSkill(paths, issueDefaults) {
     context: "fork",
     agent: "requirements-writer",
     platforms: { cursor: { exclude: true } },
-    referenceFiles: REQUIREMENTS_WRITER_REFERENCE_FILES,
+    referenceFiles: buildRequirementsWriterReferenceFiles(paths),
     instructions: [
       "# Write Requirement",
       "",
@@ -24023,7 +24087,7 @@ function buildRequirementsReviewerSubAgent(paths, issueDefaults) {
       "1. **Full audit** \u2014 every requirement document under",
       "   `<REQUIREMENTS_ROOT>` across all categories",
       "2. **Category audit** \u2014 every document in one category directory",
-      "   (e.g., all FRs under `<REQUIREMENTS_ROOT>/functional/`)",
+      `   (e.g., all FRs under \`<REQUIREMENTS_ROOT>/${paths.requirementCategoryDirs.functional}/\`)`,
       "3. **Single document** \u2014 one specific requirement file",
       "4. **Targeted check** \u2014 one or more checks from the catalog below,",
       '   run across the documents in scope (e.g., "check all traceability',
@@ -24451,7 +24515,7 @@ function buildRequirementsReviewerSubAgent(paths, issueDefaults) {
       "",
       "Each finding must cite the file path and the specific check that",
       'produced it (e.g., "Check 4: Cross-Reference Integrity \u2014 target',
-      "file `../security/SEC-007-audit-logs.md` does not exist on",
+      `file \`../${paths.requirementCategoryDirs.security}/SEC-007-audit-logs.md\` does not exist on`,
       'disk").',
       "",
       "---",
@@ -26065,13 +26129,13 @@ function buildSoftwareProfileAnalystSubAgent(paths, issueDefaults, tier) {
       "",
       "| Placeholder | Meaning | Default |",
       "|-------------|---------|---------|",
-      "| `<SOFTWARE_ROOT>` | Root folder for software profiles | `docs/software/` |",
+      `| \`<SOFTWARE_ROOT>\` | Root folder for software profiles | \`${paths.softwareRoot}/\` |`,
       "| `<PROFILES_DIR>` | Final software profile files | `<SOFTWARE_ROOT>/profiles/` |",
       "| `<NOTES_DIR>` | Research-notes files from Phase 1 | `<SOFTWARE_ROOT>/notes/` |",
       "| `<MATRIX_FILE>` | Shared feature-matrix file | `<SOFTWARE_ROOT>/feature-matrix.md` |",
       "| `<PRODUCT_SLUG>` | Short kebab-case slug identifying the product | derived from the product name |",
-      "| `<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/` |",
+      `| \`<COMPANY_PROFILES_DIR>\` | Where existing company profiles live (for duplicate detection during followup) | \`${paths.companiesRoot}/profiles/\` |`,
+      `| \`<PEOPLE_PROFILES_DIR>\` | Where existing people profiles live (for duplicate detection during followup) | \`${paths.peopleRoot}/profiles/\` |`,
       `| \`<BCM_DOC_ROOT>\` | Root folder for BCM capability-model documents (used by Phase 4 to locate capabilities) | \`${paths.bcmRoot}/\` |`,
       "| `<BCM_CAPABILITY_MAP>` | Capability-map file that lists the L1/L2/L3 hierarchy | `<BCM_DOC_ROOT>/capability-map.md` |",
       "| `<UNMAPPED_THRESHOLD>` | Minimum number of unmapped features on a single profile that triggers a `bcm:outline` follow-up for that feature cluster | `1` (every unmapped feature triggers a `bcm:outline`) |",
@@ -26741,9 +26805,9 @@ function buildProfileSoftwareSkill(paths, issueDefaults) {
       `If the project has no override in \`${paths.docsRoot}/project-context.md\` or`,
       "`agentConfig.rules`, outputs land under:",
       "",
-      "- `docs/software/notes/<slug>.notes.md`",
-      "- `docs/software/profiles/<slug>.md`",
-      "- `docs/software/feature-matrix.md` (shared across all products)",
+      `- \`${paths.softwareRoot}/notes/<slug>.notes.md\``,
+      `- \`${paths.softwareRoot}/profiles/<slug>.md\``,
+      `- \`${paths.softwareRoot}/feature-matrix.md\` (shared across all products)`,
       "",
       "## Steps",
       "",
@@ -26829,7 +26893,7 @@ function buildMapSoftwareSkill(paths, issueDefaults) {
       `- \`${paths.bcmRoot}/\` \u2014 BCM capability-model documents`,
       `- \`${paths.bcmRoot}/capability-map.md\` \u2014 capability map`,
       "",
-      "and writes back to `docs/software/profiles/<slug>.md` under the",
+      `and writes back to \`${paths.softwareRoot}/profiles/<slug>.md\` under the`,
       "`## Capability Mapping` section only. No other section of the",
       "profile is rewritten.",
       "",
@@ -28966,7 +29030,7 @@ var VERSION = {
    *
    * CLI and lib are versioned separately, so this is the lib version.
    */
-  AWS_CDK_LIB_VERSION: "2.258.0",
+  AWS_CDK_LIB_VERSION: "2.258.1",
   /**
    * Version of the AWS Constructs library to use.
    */
@@ -37497,6 +37561,7 @@ export {
   DEFAULT_PROGRESS_FILES_FORMAT,
   DEFAULT_PROGRESS_FILES_STALE_AFTER_HOURS,
   DEFAULT_PROGRESS_FILES_STATE_DIR,
+  DEFAULT_REQUIREMENT_CATEGORY_DIRS,
   DEFAULT_REQUIRE_PRODUCT_CONTEXT,
   DEFAULT_RESOLVED_ISSUE_DEFAULTS,
   DEFAULT_SAMPLE_COMPILER_OPTIONS,