@codedrifters/configulator 0.0.257 → 0.0.259

package/lib/index.js

@@ -243,9 +243,12 @@ __export(index_exports, {
   pnpmBundle: () => pnpmBundle,
   prReviewBundle: () => prReviewBundle,
   projenBundle: () => projenBundle,
+  renderCustomDocSectionBlock: () => renderCustomDocSectionBlock,
+  renderCustomDocSections: () => renderCustomDocSections,
   renderFocusSection: () => renderFocusSection,
   renderMeetingTypesSection: () => renderMeetingTypesSection,
   renderPriorityRulesSection: () => renderPriorityRulesSection,
+  renderSourceTierExamples: () => renderSourceTierExamples,
   requirementsAnalystBundle: () => requirementsAnalystBundle,
   requirementsReviewerBundle: () => requirementsReviewerBundle,
   requirementsWriterBundle: () => requirementsWriterBundle,
@@ -1390,6 +1393,98 @@ var baseBundle = {
       ].join("\n"),
       tags: ["project"]
     },
+    {
+      name: "source-quality-verification",
+      description: "Source tier hierarchy (T1\u2013T4), conflict resolution, temporal validity, and source-annotation format for research-producing agents",
+      scope: AGENT_RULE_SCOPE.ALWAYS,
+      content: [
+        "# Source Quality & Verification",
+        "",
+        "All research-producing agents must follow this source hierarchy when",
+        "writing profiles and reference documents. The tiers govern which",
+        "source to prefer when claims conflict and when time-sensitive claims",
+        "need re-verification.",
+        "",
+        "## Source Tier Hierarchy",
+        "",
+        "### T1 \u2014 Primary Living",
+        "",
+        "Authoritative sources that update when reality changes.",
+        "Use these for current-state claims. Examples:",
+        "",
+        "- Official product docs and API references",
+        "- Company about / leadership / team pages",
+        "- Live government registries (SEC EDGAR, Companies House)",
+        "- Current-role LinkedIn profiles",
+        "- Investor relations pages",
+        "",
+        "### T2 \u2014 Primary Snapshot",
+        "",
+        "Authoritative but time-stamped sources straight from the subject.",
+        "Trust for current state only when fresh (< 6 months) and no T1",
+        "source contradicts them. Examples:",
+        "",
+        "- Press releases from the entity",
+        "- Earnings transcripts and investor calls",
+        "- Regulatory filings (10-K, 10-Q, 8-K)",
+        "- Official announcements and conference presentations",
+        "",
+        "### T3 \u2014 Secondary",
+        "",
+        "Third-party sources that interpret or re-report primary material.",
+        "Good for context and triangulation; T1 wins on conflict. Examples:",
+        "",
+        "- News articles and trade press",
+        "- Industry reports and analyst research",
+        "- Database aggregators (Crunchbase, PitchBook, Owler)",
+        "",
+        "### T4 \u2014 Self-Reported / Marketing",
+        "",
+        "Promotional or unverified sources. Use for discovery and leads only",
+        "\u2014 never as the sole source for a factual claim, and always note the",
+        "self-reported nature in the annotation. Examples:",
+        "",
+        "- Vendor comparison pages and customer testimonials on vendor sites",
+        "- Social-media posts",
+        "- Job postings",
+        "- Wikipedia",
+        "",
+        "## Conflict Resolution",
+        "",
+        "Higher tier wins. Within the same tier, more recent wins. If a newer",
+        "T2 source contradicts an older T1 source on a time-sensitive claim,",
+        "flag for re-verification \u2014 the T1 source may simply not have been",
+        "updated yet.",
+        "",
+        "## Temporal Validity",
+        "",
+        "Some claims decay faster than others. When a fast-decay claim comes",
+        "from a source older than 6 months, agents **must** attempt to",
+        "corroborate it with a T1 living source. If no T1 source is available,",
+        "add an inline note: `_(source: YYYY-MM, may need re-verification)_`.",
+        "",
+        "| Decay | Re-verify if source older than | Typical claims |",
+        "|-------|-------------------------------|----------------|",
+        "| **Fast** | 6 months | Leadership roles, employee count, pricing, product features, funding status, office locations |",
+        "| **Slow** | 18 months | Founding year, ownership structure, core business description, industry classification, HQ location |",
+        "| **Stable** | Verify once, note source date | Historical facts (acquisition dates, founding story), published financials for a specific period |",
+        "",
+        "## Source Annotation Format",
+        "",
+        "In the `## Sources` section of profiles and reference documents,",
+        "annotate each source with its tier and date:",
+        "",
+        "```",
+        "1. [Company Leadership Page](https://...) \u2014 T1, accessed 2026-04",
+        "2. [Company press release](https://...) \u2014 T2, published 2026-02",
+        "3. [TechCrunch coverage](https://...) \u2014 T3, published 2025-11",
+        "```",
+        "",
+        "Use `accessed YYYY-MM` for living sources (T1) and `published YYYY-MM`",
+        "for snapshot sources (T2, T3, T4)."
+      ].join("\n"),
+      tags: ["workflow"]
+    },
     {
       name: "issue-conventions",
       description: "Issue title prefixes, GitHub issue type mapping, prerequisite issues",
@@ -2337,7 +2432,7 @@ var bcmWriterBundle = {
 // src/agent/bundles/company-profile.ts
 var companyProfileAnalystSubAgent = {
   name: "company-profile-analyst",
-  description: "Researches an external company (competitor, vendor, partner, customer, etc.) from public sources and produces a structured markdown profile, then enqueues downstream `people:research` and `software:research` issues for notable people and software products surfaced during profiling. One company per session, tracked by company:* GitHub issue labels.",
+  description: "Researches an external company (competitor, vendor, partner, customer, etc.) from public sources and produces a structured markdown profile, then enqueues downstream `people:research` and `software:research` issues for notable people and software products surfaced during profiling. Also handles profile enrichment against business-model canvases (`company:match`), maintenance refreshes on a configurable staleness cadence (`company:refresh`), and cross-profile competitive synthesis for a segment (`company:analyze`). One company or segment per session, tracked by company:* GitHub issue labels.",
   model: AGENT_MODEL.POWERFUL,
   maxTurns: 80,
   platforms: { cursor: { exclude: true } },
@@ -2345,9 +2440,11 @@ var companyProfileAnalystSubAgent = {
     "# Company Profile Analyst Agent",
     "",
     "You research a single external company from public sources and write",
-    "a structured markdown profile. Each profile cycle runs across a small",
-    "sequence of GitHub issues \u2014 one per phase \u2014 and produces a single",
-    "profile file on disk plus optional follow-up research issues.",
+    "a structured markdown profile, then maintain it as facts drift and",
+    "roll profiles up into segment-level competitive analysis. Each",
+    "session claims one GitHub issue \u2014 one phase, one company (or one",
+    "segment for `company:analyze`) \u2014 and produces files on disk plus",
+    "optional follow-up research issues.",
     "",
     "This agent is **domain-neutral**. It makes no assumptions about what",
     "the consuming project sells, which industry it serves, or which",
@@ -2364,7 +2461,9 @@ var companyProfileAnalystSubAgent = {
     "## Design Principles",
     "",
     "1. **One company per session.** Never profile two companies in a",
-    "   single session, even if they came up together.",
+    "   single session, even if they came up together. The `company:analyze`",
+    "   phase is the single exception \u2014 it synthesizes across multiple",
+    "   profiles in **one segment** but never researches a new company.",
     "2. **Public sources only.** Use the company's own site, press, product",
     "   docs, job listings, and other public material. Do not attempt to",
     "   access gated or paywalled content unless the invoking issue body",
@@ -2384,6 +2483,12 @@ var companyProfileAnalystSubAgent = {
     "   `people-profile` bundle via `people:research` issues; software",
     "   products are handed off to the `software-profile` bundle via",
     "   `software:research` issues.",
+    "7. **Enrichment is not re-research.** `company:match` reads existing",
+    "   docs and edits the profile; it never runs web searches. Refresh is",
+    "   the only maintenance phase that goes back to the public web.",
+    "8. **Synthesis waits for drafts.** `company:analyze` blocks if any",
+    "   `company:draft` issues for the target segment are still open.",
+    "   Never publish a partial landscape.",
     "",
     "---",
     "",
@@ -2418,6 +2523,24 @@ var companyProfileAnalystSubAgent = {
     "\u2502 bounded notes     \u2502     \u2502 the configured path  \u2502     \u2502 for people and    \u2502",
     "\u2502 file              \u2502     \u2502                      \u2502     \u2502 software surfaced \u2502",
     "\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518     \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518     \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518",
+    "                                                                \u2502",
+    "                                                                \u25BC",
+    "                                                    \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510",
+    "                                                    \u2502 4. MATCH          \u2502",
+    "                                                    \u2502 Enrich profile    \u2502",
+    "                                                    \u2502 with business-    \u2502",
+    "                                                    \u2502 model and segment \u2502",
+    "                                                    \u2502 context. No web.  \u2502",
+    "                                                    \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518",
+    "",
+    "\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510                           \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510",
+    "\u2502 5. REFRESH        \u2502  (cadence-driven,         \u2502 6. ANALYZE        \u2502",
+    "\u2502 Re-verify an      \u2502   or on-demand)           \u2502 Synthesize across \u2502",
+    "\u2502 existing profile  \u2502                           \u2502 profiles in one   \u2502",
+    "\u2502 with targeted web \u2502                           \u2502 segment. No web.  \u2502",
+    "\u2502 searches. Update  \u2502                           \u2502 Blocks on open    \u2502",
+    "\u2502 in place.         \u2502                           \u2502 company:draft.    \u2502",
+    "\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518                           \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518",
     "```",
     "",
     "**Issue labels encode the phase:**",
@@ -2425,41 +2548,87 @@ var companyProfileAnalystSubAgent = {
     "| Label | Phase | Session work |",
     "|-------|-------|-------------|",
     "| `company:research` | 1. Research | Gather public sources. Write a bounded research-notes file. Create the draft issue. |",
-    "| `company:draft` | 2. Draft | Read the research notes. Write the structured profile to `<PROFILES_DIR>`. Create the follow-up issue if warranted. |",
+    "| `company:draft` | 2. Draft | Read the research notes. Write the structured profile to `<PROFILES_DIR>`. Create the followup and (if enabled) match issues. |",
     "| `company:followup` | 3. Followup | Read the profile. Enqueue people/software research issues for items surfaced in the profile. |",
+    "| `company:match` | 4. Match | Read the profile. Enrich it with business-model, segment, and size context from existing docs. Bidirectionally cross-link matched business-model files. No web. |",
+    "| `company:refresh` | 5. Refresh | Read an existing profile. Run 4\u20136 targeted web searches for recent developments. Update the profile in place and add a revision-history entry. |",
+    "| `company:analyze` | 6. Analyze | Read every profile in one segment. Write a segment-level competitive-analysis document combining feature matrix, positioning, and strategic implications. No web. |",
     "",
     "All issues also carry `type:company-profile` and a `status:*` label.",
     "",
-    "**Issue count per company cycle:** 1 research + 1 draft + 0\u20131 followup =",
-    "**2\u20133 sessions**. The followup phase is skipped when the profile did",
-    "not surface any person or product worth follow-up research.",
+    "**Issue count per company cycle:** 1 research + 1 draft + 0\u20131 followup +",
+    "0\u20131 match = **2\u20134 sessions** on the initial cycle. `company:refresh`",
+    "and `company:analyze` are independent downstream cycles that run on",
+    "their own cadence.",
     "",
     "**Shortened paths:**",
     "- Research phase determines the company is out of scope (not",
     "  relevant, insufficient public material) \u2192 research issue closes",
     "  with a justification and no downstream issues are created \u2192 **1 session**.",
-    "- Short profile with no follow-ups needed \u2192 **2 sessions**.",
+    "- Short profile with no follow-ups needed and no business-model",
+    "  context to match against \u2192 **2 sessions**.",
+    "- Refresh that finds no material change \u2192 **1 session** (revision-",
+    "  history entry only, profile body unchanged).",
     "",
     "---",
     "",
     "## Configurable Paths",
     "",
     "The pipeline uses these placeholders. Consuming projects override the",
-    "defaults by passing paths in the `/profile-company` skill invocation",
-    "or by extending this rule in their own `agentConfig.rules`.",
+    "defaults by passing paths in the `/profile-company`, `/match-company`,",
+    "`/refresh-company`, or `/analyze-segment` skill invocations, or by",
+    "extending this rule in their own `agentConfig.rules`.",
     "",
     "| Placeholder | Meaning | Default |",
     "|-------------|---------|---------|",
     "| `<COMPANY_ROOT>` | Root folder for company profiles | `docs/companies/` |",
     "| `<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) | `docs/src/content/docs/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/` |",
     "",
     "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.",
+    "Business-model canvases are managed by the `business-models` bundle \u2014",
+    "this agent is a **read-only consumer** of `<BUSINESS_MODELS_ROOT>`,",
+    "with the single exception of appending a bidirectional cross-link",
+    "back to the matched profile (Phase 4, Step 6).",
+    "",
+    "---",
+    "",
+    "## Refresh Cadence",
+    "",
+    "Profiles go stale. Companies launch products, raise rounds, rotate",
+    "leadership, or pivot. The pipeline supports a configurable refresh",
+    "cadence so `company:refresh` issues can be filed on a schedule",
+    "without hardcoding the interval:",
+    "",
+    "- **Default staleness threshold:** 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/src/content/docs/project-context.md` (look for a",
+    "  `## Refresh Cadence` section) or in `agentConfig.rules`.",
+    "",
+    "When the `/refresh-company` skill is invoked for a slug that already",
+    "has a profile:",
+    "",
+    "- If the profile is **younger** than the staleness threshold, the",
+    "  skill exits with a message pointing to the existing profile. Pass",
+    "  `force: true` in the issue body to refresh anyway.",
+    "- If the profile is **older** than the staleness threshold, the",
+    "  pipeline files a `company:refresh` issue and Phase 5 updates the",
+    "  existing file in place, preserving its slug and bumping the",
+    "  `date` frontmatter.",
+    "",
+    "Refresh mode never changes the profile's primary type without an",
+    "explicit override in the refresh request \u2014 type changes are material",
+    "and warrant a human review step.",
     "",
     "---",
     "",
@@ -2468,7 +2637,8 @@ var companyProfileAnalystSubAgent = {
     "Run this loop exactly once per session. Never start a second issue.",
     "",
     "1. Claim one open `type:company-profile` issue using phase priority:",
-    "   `company:research` > `company:draft` > `company:followup`.",
+    "   `company:research` > `company:draft` > `company:followup` >",
+    "   `company:match` > `company:refresh` > `company:analyze`.",
     "2. Transition `status:ready` \u2192 `status:in-progress` and create the",
     "   branch per your project's branch-naming convention.",
     "3. Execute the phase handler that matches the issue's `company:*`",
@@ -2577,8 +2747,10 @@ var companyProfileAnalystSubAgent = {
     "   company_type: <one of the taxonomy values>",
     "   website: <primary URL>",
     "   date: YYYY-MM-DD",
+    "   refresh_days: <N, default 180>",
     "   parent_issue: <N>",
     "   notes: <NOTES_DIR>/<COMPANY_SLUG>.notes.md",
+    "   referencedIn: []",
     "   ---",
     "",
     "   # <company name>",
@@ -2607,6 +2779,10 @@ var companyProfileAnalystSubAgent = {
     "   <stack hints from job listings, product docs, public engineering",
     "   content \u2014 each bullet cited>",
     "",
+    "   ## Market Position",
+    "   <which segment(s) they play in, where they sit on the",
+    "   competitive map, who they compete with \u2014 cited>",
+    "",
     "   ## Positioning / Differentiation",
     "   <how they describe themselves and how they differ from adjacent",
     "   companies \u2014 use their own language, cited, rather than inferred>",
@@ -2620,6 +2796,11 @@ var companyProfileAnalystSubAgent = {
     "   - **Products / software to evaluate:** <list of candidate product",
     "     names>",
     "",
+    "   ## Revision History",
+    "   | Date | Changes |",
+    "   |------|---------|",
+    "   | YYYY-MM-DD | Initial profile |",
+    "",
     "   ## Sources",
     "   - <source URL> \u2014 <date accessed>",
     "   ```",
@@ -2630,7 +2811,13 @@ var companyProfileAnalystSubAgent = {
     "   note in the draft issue's closing comment that no follow-up is",
     "   needed.",
     "",
-    "5. **Commit and push** the profile file. Close the draft issue.",
+    "5. **File a `company:match` issue** (depending on this draft issue)",
+    "   so the profile gets enriched against the project's business-model",
+    "   canvases. Skip the match issue only when the invoking project has",
+    "   no business-model canvases at all (Phase 4 will detect and exit",
+    "   gracefully in that case).",
+    "",
+    "6. **Commit and push** the profile file. Close the draft issue.",
     "",
     "---",
     "",
@@ -2726,12 +2913,321 @@ var companyProfileAnalystSubAgent = {
     "",
     "---",
     "",
+    "## Phase 4: Match (`company:match`)",
+    "",
+    "**Goal:** Enrich an existing profile with business-model and segment",
+    "context from the adjacent business-model canvases and industry-",
+    "segment descriptions already tracked in the project. Create",
+    "bidirectional cross-links so both the profile and the matched",
+    "business-model document reference each other.",
+    "",
+    "This phase is **enrichment of a known profile**, not entity",
+    "deduplication \u2014 the profile already exists. It is triggered in two",
+    "ways:",
+    "",
+    "1. **Downstream of draft.** Phase 2 files a `company:match` issue",
+    "   for every new profile once the draft is committed.",
+    "2. **Downstream of a new business-model canvas.** When the",
+    "   `business-models` bundle lands a new canvas (or the orchestrator",
+    "   scans for profiles that should be re-matched), `company:match`",
+    "   issues are filed for each existing profile that might fit the new",
+    "   canvas.",
+    "",
+    "**Budget:** No web searches. Read existing docs, edit the profile,",
+    "cross-link the matched business-model file. Anything that cannot be",
+    "decided from the project's own documents is flagged in the profile's",
+    "`## Risks / Open Questions` section, not resolved with a web search.",
+    "",
+    "### Steps",
+    "",
+    "1. **Read the target profile** at the path referenced in the issue",
+    "   body. The issue body must carry the profile path; if it does not,",
+    "   close the issue with `status:needs-attention` and stop.",
+    "",
+    "2. **Identify the profile's industry / segment context.** Read the",
+    "   profile's `## Summary`, `## Market Position`, and `referencedIn`",
+    "   frontmatter to determine which industry(ies) and segment(s) the",
+    "   company plays in.",
+    "",
+    "3. **Scan `<BUSINESS_MODELS_ROOT>` for candidate canvases.** Walk",
+    "   the directory tree looking for business-model documents in",
+    "   relevant segments. A typical layout is",
+    "   `<BUSINESS_MODELS_ROOT>/<industry>/segments/<segment>/business-model.md`,",
+    "   but consuming projects may use a different layout \u2014 accept any",
+    "   markdown file named `business-model*.md` (or matching the pattern",
+    "   the consuming project declares in `docs/src/content/docs/project-context.md`).",
+    "   If the directory does not exist or contains no canvases, exit",
+    "   gracefully: add a short note to the profile's `## Risks / Open",
+    "   Questions` section and close the issue.",
+    "",
+    "4. **For each candidate canvas, score the match.** For each canvas:",
+    "   - Read the Customer Segments, Key Activities, Value Propositions,",
+    "     and Revenue Streams sections (if present).",
+    "   - Decide whether the profiled company fits one of the customer",
+    "     segments (customer match), offers a competing value proposition",
+    "     (competitor match), supplies a key activity as a vendor (vendor",
+    "     match), or is named explicitly as a partner (partner match).",
+    "   - If the canvas documents size variations (SMB / mid-market /",
+    "     enterprise), pick the variation that matches the profiled",
+    "     company's size signals (headcount, funding, revenue).",
+    "   - Record matches only when the evidence is unambiguous \u2014 skip",
+    "     weak or inferred matches.",
+    "",
+    "5. **Enrich the profile.** Add or update a `## Business Model",
+    "   Context` section using the template below. Place it after",
+    "   `## Market Position` and before `## Positioning / Differentiation`",
+    "   so the synthesis flows naturally:",
+    "",
+    "   ```markdown",
+    "   ## Business Model Context",
+    "",
+    "   ### Matched Business Models",
+    "",
+    "   | Business Model | Segment | Match Type | Size Variation |",
+    "   |----------------|---------|------------|----------------|",
+    "   | [<canvas title>](<relative path to business-model.md>) | <segment> | <customer / competitor / vendor / partner> | <SMB / Mid-Market / Enterprise or `n/a`> |",
+    "",
+    "   ### Segment Classification",
+    "",
+    "   - **Primary segment:** [<segment name>](<relative path to segment index>) \u2014 <one sentence on fit>",
+    "   - **Secondary segment(s):** <list or `n/a`>",
+    "",
+    "   ### Size Classification",
+    "",
+    "   Based on <headcount>, <revenue/funding>, and <any other size",
+    "   signal>, this company matches the **<SMB / Mid-Market /",
+    "   Enterprise>** variation in the <segment> business model.",
+    "   ```",
+    "",
+    "   Use `_No matched business models in <BUSINESS_MODELS_ROOT>._` as",
+    "   the table body when Step 3 found candidates but Step 4 scored",
+    "   zero matches.",
+    "",
+    "6. **Update the matched business-model documents bidirectionally.**",
+    "   For every row in the matched-models table, append a cross-link",
+    "   to the canvas's own Traceability (or Sources) section \u2014 do not",
+    "   rewrite the canvas body. A single line is enough:",
+    "",
+    "   ```markdown",
+    "   - **Profiled company:** [<company name>](<relative path to profile.md>) \u2014 match type: <customer / competitor / vendor / partner>",
+    "   ```",
+    "",
+    "   If a canvas already lists this profile, do not duplicate the line.",
+    "   If the canvas has no Traceability or Sources section, skip the",
+    "   canvas and flag it in the profile's `## Risks / Open Questions`",
+    "   section rather than inventing a new section in someone else's",
+    "   document.",
+    "",
+    "7. **Update the profile's `referencedIn` frontmatter.** Add the",
+    "   relative paths of every matched business-model document and",
+    "   segment index so downstream audit tooling can traverse the link",
+    "   graph without re-scanning the tree.",
+    "",
+    "8. **Append a revision-history row.**",
+    "",
+    "   ```markdown",
+    "   | YYYY-MM-DD | Matched to business models: <comma-separated segment list> |",
+    "   ```",
+    "",
+    "9. **Commit and push.** Close the match issue with a short comment",
+    "   summarizing the matched segments.",
+    "",
+    "---",
+    "",
+    "## Phase 5: Refresh (`company:refresh`)",
+    "",
+    "**Goal:** Re-verify an existing profile with a small number of",
+    "targeted web searches for recent developments, then update the",
+    "profile in place.",
+    "",
+    "**Budget:** 4\u20136 targeted web searches, focused on recent activity.",
+    "Do not redo the full research-phase sweep.",
+    "",
+    "### Steps",
+    "",
+    "1. **Read the existing profile** at the path referenced in the issue",
+    "   body. If the profile file is missing, close the issue with",
+    "   `status:needs-attention` and stop.",
+    "",
+    "2. **Confirm the staleness threshold.** Compare the profile's `date`",
+    "   frontmatter against today's date and the `refresh_days`",
+    "   frontmatter (or the project default from the Refresh Cadence",
+    "   section above). If the profile is younger than the threshold and",
+    "   the issue body does not set `force: true`, close the issue with",
+    "   a short comment and stop \u2014 do not burn the search budget.",
+    "",
+    "3. **Run 4\u20136 targeted searches.** Focus on:",
+    "   - `<company name>` + recent news, press releases, or blog posts",
+    "   - Product launches, feature changes, or pricing updates",
+    "   - Funding rounds, acquisitions, or material ownership changes",
+    "   - Leadership changes (CEO, CTO, CPO, notable departures/arrivals)",
+    "   - New partnerships, certifications, or regulatory milestones",
+    "",
+    "4. **Update the profile in place.** Edit the affected sections with",
+    "   the new information. Cite every new claim. Preserve the slug and",
+    "   the original `parent_issue` field. Bump the `date` frontmatter to",
+    "   today's date.",
+    "",
+    "5. **Do not silently re-type the company.** If the refresh surfaces",
+    "   evidence that the company's primary type has changed (e.g., an",
+    "   industry-player that now sells a directly competing product),",
+    "   flag it in `## Risks / Open Questions` and stop \u2014 do **not**",
+    "   rewrite the `company_type` frontmatter without an explicit",
+    "   override in the refresh issue body (`retype: <new type>`).",
+    "",
+    "6. **Append a revision-history row.** Summarize the delta in one",
+    "   line:",
+    "",
+    "   ```markdown",
+    "   | YYYY-MM-DD | Refreshed: <one-line summary of what changed> |",
+    "   ```",
+    "",
+    "   When the search budget finds no material change, the row still",
+    "   appears so the next scheduled refresh knows this profile was",
+    "   reviewed:",
+    "",
+    "   ```markdown",
+    "   | YYYY-MM-DD | Refreshed: no material change |",
+    "   ```",
+    "",
+    "7. **Update reference entries** (if the project tracks company",
+    "   references under research directories). If the company's",
+    "   relevance to a research area has shifted \u2014 for example, it is no",
+    "   longer a live competitor, or it now plays in a new segment \u2014",
+    "   update the corresponding entry under `referencedIn` and the",
+    "   research-area doc that links to this profile.",
+    "",
+    "8. **Commit and push.** Close the refresh issue with a short comment",
+    "   summarizing the delta (or `no material change`).",
+    "",
+    "---",
+    "",
+    "## Phase 6: Analyze (`company:analyze`)",
+    "",
+    "**Goal:** Produce a segment-level competitive analysis by",
+    "synthesizing every profile in the target segment. The deliverable",
+    "is one markdown document under `<ANALYSIS_DIR>` combining a",
+    "feature-comparison matrix, a positioning map, and the strategic",
+    "implications for the consuming project.",
+    "",
+    "**Budget:** No web searches. Pure synthesis from existing profiles",
+    "and (optionally) existing product docs the consuming project",
+    "maintains.",
+    "",
+    "### Steps",
+    "",
+    "1. **Read the segment scope from the issue body.** It must carry",
+    "   `<SEGMENT_SLUG>` plus the path of every profile to include (or a",
+    "   glob that resolves to them). If the issue body is ambiguous,",
+    "   close with `status:needs-attention` and stop.",
+    "",
+    "2. **Block on open draft issues.** Query for open",
+    "   `company:draft` issues whose title or body mentions the segment",
+    "   slug:",
+    "",
+    "   ```bash",
+    "   gh issue list \\",
+    "     --label 'company:draft' --state open \\",
+    "     --search '<SEGMENT_SLUG> in:title,body' \\",
+    "     --json number,title --limit 200",
+    "   ```",
+    "",
+    "   If the query returns any issues, this analyze issue must block on",
+    "   them. Add `Depends on: #<N>` lines for every open draft, apply",
+    "   `status:blocked`, remove `status:in-progress`, and stop \u2014 **do",
+    "   not publish a partial landscape**. The issue will be eligible",
+    "   again once the drafts close.",
+    "",
+    "3. **Read every in-scope profile.** Collect each profile's Summary,",
+    "   Offering, Classification, Market Position, Positioning /",
+    "   Differentiation, and Risks / Open Questions sections.",
+    "",
+    "4. **Derive a feature axis.** Build the feature axis from the",
+    "   union of bullets across each profile's Offering section (and, if",
+    "   present, a project-maintained feature taxonomy under",
+    "   `<BUSINESS_MODELS_ROOT>`). Do **not** invent features not",
+    "   represented in at least one profile or the project's taxonomy.",
+    "",
+    "5. **Write the analysis document** to",
+    "   `<ANALYSIS_DIR>/<SEGMENT_SLUG>.md` using the template below. Use",
+    "   `_Not available in profiles._` in any cell a profile does not",
+    "   document. Never fabricate a `Yes/No` from a missing field.",
+    "",
+    "   ```markdown",
+    "   ---",
+    '   title: "<segment name> Competitive Analysis"',
+    "   slug: <SEGMENT_SLUG>",
+    "   segment: <segment name>",
+    "   date: YYYY-MM-DD",
+    "   status: draft",
+    "   profiles:",
+    "     - <relative path to profile 1>",
+    "     - <relative path to profile 2>",
+    "   ---",
+    "",
+    "   # <segment name> Competitive Analysis",
+    "",
+    "   ## Market Overview",
+    "   <landscape summary \u2014 total players, market structure, trends",
+    "    visible from the profiles>",
+    "",
+    "   ## Feature Comparison Matrix",
+    "   | Feature | <Company A> | <Company B> | <Company C> |",
+    "   |---------|-------------|-------------|-------------|",
+    "   | <feature> | Yes / No / Partial | ... | ... |",
+    "",
+    "   ## Pricing Comparison",
+    "   <pricing tiers across profiles, where disclosed>",
+    "",
+    "   ## Positioning Map",
+    "   <where each player sits \u2014 by price vs. feature depth, or by",
+    "    segment focus. Textual description; link to an external diagram",
+    "    if the consuming project maintains one.>",
+    "",
+    "   ## Strengths & Vulnerabilities",
+    "   | Company | Key Strength | Key Vulnerability |",
+    "   |---------|--------------|-------------------|",
+    "   | <company> | <strength> | <vulnerability> |",
+    "",
+    "   ## Strategic Implications",
+    "   <which features matter most, where the consuming project can",
+    "    differentiate, what pricing the landscape supports, and which",
+    "    competitive threats to watch>",
+    "",
+    "   ## Recommended Actions",
+    "   | Action | Priority | Rationale |",
+    "   |--------|----------|-----------|",
+    "   | <action> | High / Medium / Low | <why> |",
+    "",
+    "   ## Sources",
+    "   - <relative path to profile 1>",
+    "   - <relative path to profile 2>",
+    "",
+    "   ## Revision History",
+    "   | Date | Changes |",
+    "   |------|---------|",
+    "   | YYYY-MM-DD | Initial analysis |",
+    "   ```",
+    "",
+    "6. **Do not edit the underlying profiles.** `company:analyze` is a",
+    "   synthesis phase \u2014 profiles are **inputs only**. Any cross-link",
+    "   from a profile to the analysis document should be added by a",
+    "   follow-up `company:match` pass, not by this phase.",
+    "",
+    "7. **Commit and push.** Close the analyze issue with a short",
+    "   comment naming the analysis document path.",
+    "",
+    "---",
+    "",
     "## Output Boundaries",
     "",
     "This agent writes **only** to:",
     "",
     "- `<NOTES_DIR>/` \u2014 research-notes files (Phase 1)",
-    "- `<PROFILES_DIR>/` \u2014 company profiles (Phase 2, updated in Phase 3)",
+    "- `<PROFILES_DIR>/` \u2014 company profiles (Phase 2, updated in Phases",
+    "  3, 4, and 5)",
+    "- `<ANALYSIS_DIR>/` \u2014 segment-level competitive-analysis documents",
+    "  (Phase 6)",
     "",
     "In Phase 3, this agent also **creates `people:research` and",
     "`software:research` issues** for people and software products",
@@ -2740,18 +3236,33 @@ var companyProfileAnalystSubAgent = {
     "`people-profile-analyst` and `software-profile-analyst` agents, which",
     "pick up the issues this pipeline creates.",
     "",
-    "The pipeline produces **company profiles and notes only**. Deeper",
-    "research on people or products is delegated to downstream research",
-    "pipelines via `people:research` and `software:research` issues \u2014 this",
-    "agent never writes person profiles, software profiles, product",
-    "evaluations, or comparative analyses itself. Keep this boundary clean",
-    "so the company-profile pipeline stays generic.",
+    "In Phase 4, this agent appends a single bidirectional cross-link",
+    "line to matched business-model documents under",
+    "`<BUSINESS_MODELS_ROOT>`. It never rewrites the canvas body, adds",
+    "new canvas sections, or otherwise mutates business-model content \u2014",
+    "that remains the responsibility of the `business-models` bundle.",
+    "",
+    "In Phase 5, this agent only updates an existing profile in place \u2014",
+    "it never forks a new profile under a different slug.",
+    "",
+    "In Phase 6, this agent only writes a new segment-level analysis",
+    "document. It never edits the underlying company profiles.",
+    "",
+    "The pipeline produces **company profiles, notes, and segment",
+    "analyses**. Deeper research on people or products is delegated to",
+    "downstream research pipelines via `people:research` and",
+    "`software:research` issues \u2014 this agent never writes person",
+    "profiles, software profiles, product evaluations, or",
+    "requirement-style documents itself. Keep this boundary clean so",
+    "the company-profile pipeline stays generic.",
     "",
     "---",
     "",
     "## Rules",
     "",
     "- **One company per session.** Never profile two companies back-to-back.",
+    "  `company:analyze` is the single exception \u2014 it synthesizes one",
+    "  segment per session, not one company.",
     "- **Persist before closing.** Every phase must write its output file",
     "  before closing its issue.",
     "- **Cite everything.** Profile claims without source citations do not",
@@ -2772,10 +3283,24 @@ var companyProfileAnalystSubAgent = {
     "  and products that are genuinely relevant to the framing of this",
     "  profile. Do not open issues for every name or product mentioned in",
     "  passing.",
-    "- **Produce profiles, not requirement or evaluation documents.** Do",
+    "- **Produce profiles and analyses, not requirement documents.** Do",
     "  not open `type:requirement` or formal evaluation issues from this",
     "  pipeline. Follow-up research is scoped through `people:research`",
-    "  and `software:research` only."
+    "  and `software:research` only.",
+    "- **Match is read-mostly.** Phase 4 edits the target profile and",
+    "  appends one line to each matched business-model document. It never",
+    "  rewrites canvas bodies, never runs web searches, and never edits",
+    "  other profiles.",
+    "- **Refresh respects the cadence.** Phase 5 exits early when the",
+    "  profile is younger than the staleness threshold and `force: true`",
+    "  is not set. It always appends a revision-history row so the next",
+    "  scheduled run knows the profile was reviewed.",
+    "- **Analyze blocks on open drafts.** Phase 6 refuses to publish a",
+    "  partial landscape. If any `company:draft` issues for the target",
+    "  segment are still open, the analyze issue is marked",
+    "  `status:blocked` with `Depends on:` lines pointing at each draft.",
+    "- **Refresh, don't fork.** When a profile exists and is past its",
+    "  cadence, update in place rather than creating a new slug."
   ].join("\n")
 };
 var profileCompanySkill = {
@@ -2820,8 +3345,8 @@ var profileCompanySkill = {
     "   company name, selected type, framing, and any overrides.",
     "2. Execute Phase 1 (Research) of the company-profile-analyst agent.",
     "3. Phase 1 creates the `company:draft` issue. Phase 2 may create a",
-    "   `company:followup` issue. Each downstream issue declares its",
-    "   `Depends on:` predecessor.",
+    "   `company:followup` issue **and** a `company:match` issue. Each",
+    "   downstream issue declares its `Depends on:` predecessor.",
     "",
     "## Output",
     "",
@@ -2831,38 +3356,265 @@ var profileCompanySkill = {
     "  (handed off to the `people-profile` bundle)",
     "- `software:research` issues for software products surfaced in the",
     "  profile (handed off to the `software-profile` bundle)",
+    "- A `company:match` issue so the profile is enriched against the",
+    "  project's business-model canvases",
     "- This pipeline produces **company profiles only** \u2014 it does not",
     "  write person profiles, software profiles, product evaluations, or",
-    "  comparative analyses itself."
+    "  comparative analyses itself. Segment-level analysis is produced by",
+    "  the separate `/analyze-segment` skill."
+  ].join("\n")
+};
+var matchCompanySkill = {
+  name: "match-company",
+  description: "Kick off a company-profile match (enrichment) cycle. Creates a company:match issue for an existing profile and dispatches Phase 4 (Match) in the company-profile-analyst agent. Match enriches the profile with business-model, segment, and size context from existing docs \u2014 no web searches.",
+  disableModelInvocation: true,
+  userInvocable: true,
+  context: "fork",
+  agent: "company-profile-analyst",
+  platforms: { cursor: { exclude: true } },
+  instructions: [
+    "# Match Company",
+    "",
+    "Enrich an existing company profile against the project's",
+    "business-model canvases, industry segments, and size descriptions.",
+    "Creates a `company:match` issue for the target profile and",
+    "dispatches Phase 4 (Match) in the company-profile-analyst agent.",
+    "",
+    "**This is enrichment of a known profile, not entity",
+    "deduplication** \u2014 the profile already exists and must be passed by",
+    "path.",
+    "",
+    "## Usage",
+    "",
+    "/match-company <path-to-profile>",
+    "",
+    "Optional extensions in the issue body:",
+    "- `business_models_root: <path>` \u2014 override `<BUSINESS_MODELS_ROOT>`",
+    "  if the project's business-model canvases do not live at the",
+    "  default location",
+    "- `only: <comma-separated list of segment slugs>` \u2014 match only",
+    "  against the listed segments (useful when a new canvas triggers a",
+    "  re-match)",
+    "",
+    "## Default Paths",
+    "",
+    "If the project has no override in `docs/src/content/docs/project-context.md` or",
+    "`agentConfig.rules`, the agent reads canvases from:",
+    "",
+    "- `docs/src/content/docs/industry-research/`",
+    "",
+    "## Budget",
+    "",
+    "- **No web searches.** Phase 4 reads existing docs and edits the",
+    "  profile + one cross-link per matched canvas. Anything that cannot",
+    "  be decided from existing docs is flagged in the profile's",
+    "  `## Risks / Open Questions` section.",
+    "",
+    "## Steps",
+    "",
+    "1. Create a `company:match` issue with `type:company-profile`,",
+    "   `priority:medium`, and `status:ready`. Body must include the",
+    "   profile path and any overrides.",
+    "2. Execute Phase 4 (Match) of the company-profile-analyst agent.",
+    "",
+    "## Output",
+    "",
+    "- The profile gains a `## Business Model Context` section",
+    "- Each matched business-model canvas gains a single cross-link line",
+    "  in its Traceability / Sources section",
+    "- The profile's `referencedIn` frontmatter is updated with matched",
+    "  paths",
+    "- A revision-history row summarizing the matched segments"
+  ].join("\n")
+};
+var refreshCompanySkill = {
+  name: "refresh-company",
+  description: "Kick off a company-profile refresh cycle. Creates a company:refresh issue for an existing profile and dispatches Phase 5 (Refresh) in the company-profile-analyst agent. Refresh re-verifies the profile with 4\u20136 targeted web searches and updates it in place. Respects a configurable staleness threshold so profiles younger than the threshold exit early.",
+  disableModelInvocation: true,
+  userInvocable: true,
+  context: "fork",
+  agent: "company-profile-analyst",
+  platforms: { cursor: { exclude: true } },
+  instructions: [
+    "# Refresh Company",
+    "",
+    "Re-verify an existing company profile with a small number of",
+    "targeted web searches and update the profile in place. Creates a",
+    "`company:refresh` issue for the target profile and dispatches",
+    "Phase 5 (Refresh) in the company-profile-analyst agent.",
+    "",
+    "Refresh respects a configurable **staleness threshold** so scheduled",
+    "refreshes do not burn search budget on profiles that are still",
+    "fresh.",
+    "",
+    "## Usage",
+    "",
+    "/refresh-company <path-to-profile>",
+    "",
+    "Optional extensions in the issue body:",
+    "- `refresh_days: <N>` \u2014 override the default 180-day staleness",
+    "  threshold for this run",
+    "- `force: true` \u2014 refresh even if the profile is younger than the",
+    "  threshold",
+    "- `retype: <taxonomy value>` \u2014 explicitly allow Phase 5 to change",
+    "  the profile's `company_type` when the refresh finds material",
+    "  evidence of a type change",
+    "",
+    "## Staleness Threshold",
+    "",
+    "Order of precedence (first match wins):",
+    "",
+    "1. `refresh_days` in the issue body (per-run override)",
+    "2. `refresh_days` frontmatter on the profile itself",
+    "3. Project-wide default declared under a `## Refresh Cadence`",
+    "   section in `docs/src/content/docs/project-context.md`",
+    "4. Built-in default: **180 days**",
+    "",
+    "If the profile's `date` frontmatter plus the resolved threshold is",
+    "in the future (i.e. the profile is still fresh) and `force: true`",
+    "is not set, Phase 5 closes the refresh issue with a short comment",
+    "and stops without running any searches.",
+    "",
+    "## Budget",
+    "",
+    "- **4\u20136 targeted web searches** focused on recent news, product",
+    "  launches, funding/acquisitions, leadership changes, and",
+    "  partnerships / certifications.",
+    "",
+    "## Steps",
+    "",
+    "1. Create a `company:refresh` issue with `type:company-profile`,",
+    "   `priority:medium`, and `status:ready`. Body must include the",
+    "   profile path and any overrides.",
+    "2. Execute Phase 5 (Refresh) of the company-profile-analyst agent.",
+    "",
+    "## Output",
+    "",
+    "- The profile is updated in place (sections edited, `date` bumped,",
+    "  slug preserved)",
+    "- A revision-history row summarizing the delta \u2014 or",
+    "  `Refreshed: no material change` when the search budget found",
+    "  nothing material",
+    "- Reference entries updated if the company's relevance to a research",
+    "  area shifted"
+  ].join("\n")
+};
+var analyzeSegmentSkill = {
+  name: "analyze-segment",
+  description: "Kick off a segment-level competitive-analysis cycle. Creates a company:analyze issue for the target segment and dispatches Phase 6 (Analyze) in the company-profile-analyst agent. Analyze synthesizes every profile in the segment into one competitive-analysis document. Blocks on open company:draft issues for the segment.",
+  disableModelInvocation: true,
+  userInvocable: true,
+  context: "fork",
+  agent: "company-profile-analyst",
+  platforms: { cursor: { exclude: true } },
+  instructions: [
+    "# Analyze Segment",
+    "",
+    "Produce a segment-level competitive analysis by synthesizing every",
+    "company profile in the target segment into one markdown document.",
+    "Creates a `company:analyze` issue and dispatches Phase 6 (Analyze)",
+    "in the company-profile-analyst agent.",
+    "",
+    "**This is pure synthesis** \u2014 no web searches, no new profile work.",
+    "All inputs must already exist under the profiles directory before",
+    "you run this skill.",
+    "",
+    "## Usage",
+    "",
+    "/analyze-segment <segment-slug>",
+    "",
+    "Optional extensions in the issue body:",
+    "- `profiles: <list of paths>` \u2014 explicit list of profile files to",
+    "  include; otherwise the agent discovers profiles by scanning for",
+    "  the segment slug in each profile's `referencedIn` frontmatter",
+    "- `analysis_dir: <path>` \u2014 override `<ANALYSIS_DIR>` if the project",
+    "  stores analyses somewhere other than the default",
+    "",
+    "## Default Paths",
+    "",
+    "If the project has no override in `docs/src/content/docs/project-context.md` or",
+    "`agentConfig.rules`, outputs land under:",
+    "",
+    "- `docs/companies/analysis/<segment-slug>.md`",
+    "",
+    "## Blocking Rule",
+    "",
+    "Phase 6 refuses to publish a partial landscape. If any",
+    "`company:draft` issues whose title or body mention",
+    "`<SEGMENT_SLUG>` are still open, the analyze issue is marked",
+    "`status:blocked` with `Depends on: #<N>` lines pointing at each",
+    "open draft, `status:in-progress` is removed, and Phase 6 exits",
+    "without writing the analysis. The issue becomes eligible again",
+    "once the drafts close.",
+    "",
+    "## Budget",
+    "",
+    "- **No web searches.** Pure synthesis from existing profiles (and",
+    "  optionally the project's own product docs).",
+    "",
+    "## Steps",
+    "",
+    "1. Create a `company:analyze` issue with `type:company-profile`,",
+    "   `priority:medium`, and `status:ready`. Body must include the",
+    "   segment slug and any overrides.",
+    "2. Execute Phase 6 (Analyze) of the company-profile-analyst agent.",
+    "",
+    "## Output",
+    "",
+    "- One markdown document at `<ANALYSIS_DIR>/<SEGMENT_SLUG>.md`",
+    "  combining feature-comparison matrix, pricing comparison,",
+    "  positioning map, strengths & vulnerabilities, strategic",
+    "  implications, and recommended actions \u2014 every claim sourced back",
+    "  to the underlying profiles",
+    "- This skill does **not** edit the underlying profiles. Cross-",
+    "  linking a profile back to the analysis is the job of a",
+    "  subsequent `company:match` pass."
   ].join("\n")
 };
 var companyProfileBundle = {
   name: "company-profile",
-  description: "Company research and profiling pipeline: research, draft profile, followup. Enabled by default; domain-neutral; filesystem-durable between phases. Phase 3 (Followup) hands surfaced people and software products off to the `people-profile` and `software-profile` bundles via `people:research` and `software:research` issues.",
+  description: "Company research and profiling pipeline: research, draft profile, followup, match, refresh, analyze. Enabled by default; domain-neutral; filesystem-durable between phases. Phase 3 (Followup) hands surfaced people and software products off to the `people-profile` and `software-profile` bundles via `people:research` and `software:research` issues. Phase 4 (Match) enriches profiles against business-model canvases. Phase 5 (Refresh) re-verifies profiles on a configurable staleness cadence. Phase 6 (Analyze) synthesizes profiles in a segment into a competitive-analysis document.",
   appliesWhen: () => true,
   rules: [
     {
       name: "company-profile-workflow",
-      description: "Describes the 3-phase company-profile pipeline, the company:* label taxonomy, and the boundary against downstream research agents.",
+      description: "Describes the 6-phase company-profile pipeline, the company:* label taxonomy, and the boundary against downstream research agents.",
       scope: AGENT_RULE_SCOPE.ALWAYS,
       content: [
         "# Company Profile Workflow",
         "",
         "Use `/profile-company <company-name>` to kick off a company",
-        "research and profiling pipeline. The pipeline runs in up to 3",
-        "phases \u2014 research, draft, followup \u2014 each tracked by its own",
-        "GitHub issue labeled `company:research`, `company:draft`, or",
-        "`company:followup`. All issues carry `type:company-profile`.",
-        "",
-        "The pipeline produces **company profiles only**. Deeper research",
-        "on notable people and software products surfaced while profiling",
-        "is delegated to the `people-profile` and `software-profile`",
-        "bundles via `people:research` and `software:research` issues",
-        "opened during Phase 3 (Followup).",
+        "research and profiling pipeline. The pipeline runs in up to 6",
+        "phases \u2014 research, draft, followup, match, refresh, analyze \u2014",
+        "each tracked by its own GitHub issue labeled `company:research`,",
+        "`company:draft`, `company:followup`, `company:match`,",
+        "`company:refresh`, or `company:analyze`. All issues carry",
+        "`type:company-profile`.",
+        "",
+        "Three additional user-invocable skills drive the maintenance and",
+        "synthesis phases independently:",
+        "",
+        "- `/match-company <path-to-profile>` \u2014 enrich an existing",
+        "  profile with business-model and segment context from the",
+        "  project's business-model canvases (Phase 4, no web searches).",
+        "- `/refresh-company <path-to-profile>` \u2014 re-verify an existing",
+        "  profile with 4\u20136 targeted web searches and update it in place",
+        "  (Phase 5, respects a configurable staleness threshold).",
+        "- `/analyze-segment <segment-slug>` \u2014 synthesize every profile",
+        "  in a segment into one competitive-analysis document (Phase 6,",
+        "  no web searches; blocks on open `company:draft` issues for",
+        "  the segment).",
+        "",
+        "The pipeline produces **company profiles, notes, and segment",
+        "analyses**. Deeper research on notable people and software",
+        "products surfaced while profiling is delegated to the",
+        "`people-profile` and `software-profile` bundles via",
+        "`people:research` and `software:research` issues opened during",
+        "Phase 3 (Followup).",
         "",
         "See the `company-profile-analyst` agent definition for full",
-        "workflow details, default paths, the company-type taxonomy, and",
-        "phase-by-phase instructions."
+        "workflow details, default paths, the company-type taxonomy, the",
+        "staleness-threshold rules, and phase-by-phase instructions."
       ].join("\n"),
       platforms: {
         cursor: { exclude: true }
@@ -2870,7 +3622,12 @@ var companyProfileBundle = {
       tags: ["workflow"]
     }
   ],
-  skills: [profileCompanySkill],
+  skills: [
+    profileCompanySkill,
+    matchCompanySkill,
+    refreshCompanySkill,
+    analyzeSegmentSkill
+  ],
   subAgents: [companyProfileAnalystSubAgent],
   labels: [
     {
@@ -2892,6 +3649,21 @@ var companyProfileBundle = {
       name: "company:followup",
       color: "D4C5F9",
       description: "Phase 3: enqueue follow-up research issues for people and products surfaced in the profile"
+    },
+    {
+      name: "company:match",
+      color: "FBCA04",
+      description: "Phase 4: enrich a company profile with business-model, segment, and size context from existing docs"
+    },
+    {
+      name: "company:refresh",
+      color: "F9D0C4",
+      description: "Phase 5: re-verify an existing company profile with targeted web searches and update it in place"
+    },
+    {
+      name: "company:analyze",
+      color: "5319E7",
+      description: "Phase 6: synthesize every company profile in a segment into a competitive-analysis document"
     }
   ]
 };
@@ -14583,6 +15355,141 @@ var vitestBundle = {
   }
 };
 
+// src/agent/bundles/features.ts
+var SOURCE_TIER_HEADINGS = [
+  { key: "t1", heading: "### T1 \u2014 Primary Living" },
+  { key: "t2", heading: "### T2 \u2014 Primary Snapshot" },
+  { key: "t3", heading: "### T3 \u2014 Secondary" },
+  { key: "t4", heading: "### T4 \u2014 Self-Reported / Marketing" }
+];
+function renderSourceTierExamples(content, examples) {
+  if (!examples) {
+    return content;
+  }
+  const tierEntries = SOURCE_TIER_HEADINGS.flatMap(({ key, heading }) => {
+    const list = examples[key];
+    if (!list || list.length === 0) {
+      return [];
+    }
+    return [{ heading, list }];
+  });
+  if (tierEntries.length === 0) {
+    return content;
+  }
+  let updated = content;
+  for (const { heading, list } of tierEntries) {
+    const injection = [
+      "",
+      "**Project-specific examples:**",
+      "",
+      ...list.map((ex) => `- ${ex}`)
+    ].join("\n");
+    updated = insertAfterHeadingBlock(updated, heading, injection);
+  }
+  return updated;
+}
+function renderCustomDocSections(bundle, sections) {
+  const matching = sections.filter((s) => s.bundleName === bundle.name);
+  if (matching.length === 0) {
+    return bundle;
+  }
+  let rules = bundle.rules;
+  const currentAnchorByTarget = /* @__PURE__ */ new Map();
+  for (const section of matching) {
+    const injection = renderCustomDocSectionBlock(section);
+    const seededAnchor = currentAnchorByTarget.get(section.afterSection);
+    let targetIndex = -1;
+    let targetHeading = "";
+    for (let i = 0; i < rules.length; i += 1) {
+      if (seededAnchor && rules[i].content.includes(seededAnchor)) {
+        targetIndex = i;
+        targetHeading = seededAnchor;
+        break;
+      }
+      if (!seededAnchor) {
+        const match = findHeadingForTitle(
+          rules[i].content,
+          section.afterSection
+        );
+        if (match) {
+          targetIndex = i;
+          targetHeading = match;
+          break;
+        }
+      }
+    }
+    if (targetIndex === -1) {
+      continue;
+    }
+    const targetRule = rules[targetIndex];
+    const updatedRule = {
+      ...targetRule,
+      content: insertAfterHeadingBlock(
+        targetRule.content,
+        targetHeading,
+        injection
+      )
+    };
+    rules = [
+      ...rules.slice(0, targetIndex),
+      updatedRule,
+      ...rules.slice(targetIndex + 1)
+    ];
+    currentAnchorByTarget.set(
+      section.afterSection,
+      `## ${section.sectionTitle}`
+    );
+  }
+  if (rules === bundle.rules) {
+    return bundle;
+  }
+  return { ...bundle, rules };
+}
+function renderCustomDocSectionBlock(section) {
+  const body = section.body.replace(/[\r\n]+$/u, "");
+  return ["", `## ${section.sectionTitle}`, "", body].join("\n");
+}
+function findHeadingForTitle(content, title) {
+  const lines = content.split("\n");
+  for (const line of lines) {
+    const match = line.match(/^(#{1,6}) (.+)$/u);
+    if (match && match[2] === title) {
+      return line;
+    }
+  }
+  return void 0;
+}
+function insertAfterHeadingBlock(content, heading, injection) {
+  const lines = content.split("\n");
+  const headingIndex = lines.findIndex((line) => line === heading);
+  if (headingIndex === -1) {
+    return content;
+  }
+  const headingLevel = countLeadingHashes(heading);
+  let endIndex = lines.length - 1;
+  for (let i = headingIndex + 1; i < lines.length; i += 1) {
+    const nextLevel = countLeadingHashes(lines[i]);
+    if (nextLevel > 0 && nextLevel <= headingLevel) {
+      endIndex = i - 1;
+      break;
+    }
+  }
+  while (endIndex > headingIndex && lines[endIndex] === "") {
+    endIndex -= 1;
+  }
+  const injectionLines = injection.split("\n");
+  const next = [
+    ...lines.slice(0, endIndex + 1),
+    ...injectionLines,
+    ...lines.slice(endIndex + 1)
+  ];
+  return next.join("\n");
+}
+function countLeadingHashes(line) {
+  const match = line.match(/^(#{1,6}) /u);
+  return match ? match[1].length : 0;
+}
+
 // src/agent/bundles/focus.ts
 var DEFAULT_FOCUS_FILE_PATH = ".claude/focus.json";
 var DEFAULT_SCHEMA_VERSION = 1;
@@ -15553,6 +16460,19 @@ var AgentConfig = class _AgentConfig extends import_projen8.Component {
     const isAgentConfig = (c) => c instanceof _AgentConfig;
     return project.components.find(isAgentConfig);
   }
+  /**
+   * Returns `true` when at least one tier array on the supplied
+   * `SourceTierExamples` is non-empty, signalling that the consuming
+   * repo has opted into rendering the base bundle's
+   * `source-quality-verification` rule. Returns `false` for
+   * `undefined`, `{}`, or a fully-empty `{ t1: [], t2: [], t3: [], t4: [] }`.
+   */
+  static hasActiveTierExamples(examples) {
+    if (!examples) {
+      return false;
+    }
+    return (examples.t1?.length ?? 0) > 0 || (examples.t2?.length ?? 0) > 0 || (examples.t3?.length ?? 0) > 0 || (examples.t4?.length ?? 0) > 0;
+  }
   /**
    * Merges default Claude permissions with bundle and user-supplied settings.
    *
@@ -15772,6 +16692,24 @@ ${section}`
         }
       }
     }
+    const tierExamples = this.options.features?.sourceTierExamples;
+    if (_AgentConfig.hasActiveTierExamples(tierExamples)) {
+      const sourceRule = ruleMap.get("source-quality-verification");
+      if (sourceRule) {
+        const updated = renderSourceTierExamples(
+          sourceRule.content,
+          tierExamples
+        );
+        if (updated !== sourceRule.content) {
+          ruleMap.set("source-quality-verification", {
+            ...sourceRule,
+            content: updated
+          });
+        }
+      }
+    } else {
+      ruleMap.delete("source-quality-verification");
+    }
     return [...ruleMap.values()].sort((a, b) => {
       if (a.name === "project-overview") return -1;
       if (b.name === "project-overview") return 1;
@@ -15784,19 +16722,24 @@ ${section}`
   /**
    * Return a bundle's rules with `filePatterns` narrowed to the projects
    * that actually matched the bundle's detection predicate (when the bundle
-   * provides `findApplicableProjects`). Rules with `ALWAYS` scope and rules
-   * on bundles that don't implement the hook are returned unchanged.
+   * provides `findApplicableProjects`) and any project-specified
+   * `features.customDocSections` entries injected into the matching rule
+   * content. Rules with `ALWAYS` scope and rules on bundles that don't
+   * implement the hook are returned with only the custom-section
+   * transformation (if any) applied.
    */
   bundleRulesFor(bundle) {
-    if (!bundle.findApplicableProjects) {
-      return bundle.rules;
+    const customSections = this.options.features?.customDocSections ?? [];
+    const withCustomSections = customSections.length > 0 ? renderCustomDocSections(bundle, customSections) : bundle;
+    if (!withCustomSections.findApplicableProjects) {
+      return withCustomSections.rules;
     }
-    const detected = bundle.findApplicableProjects(this.project);
+    const detected = withCustomSections.findApplicableProjects(this.project);
     if (detected.length === 0) {
-      return bundle.rules;
+      return withCustomSections.rules;
     }
     const scoped = scopeFilePatternsToProjects(this.project, detected);
-    return bundle.rules.map(
+    return withCustomSections.rules.map(
       (rule) => rule.scope === AGENT_RULE_SCOPE.FILE_PATTERN ? { ...rule, filePatterns: scoped } : rule
     );
   }
@@ -18583,9 +19526,12 @@ var TypeScriptConfig = class extends import_projen22.Component {
   pnpmBundle,
   prReviewBundle,
   projenBundle,
+  renderCustomDocSectionBlock,
+  renderCustomDocSections,
   renderFocusSection,
   renderMeetingTypesSection,
   renderPriorityRulesSection,
+  renderSourceTierExamples,
   requirementsAnalystBundle,
   requirementsReviewerBundle,
   requirementsWriterBundle,