@codedrifters/configulator 0.0.258 → 0.0.260

package/lib/index.js

@@ -2432,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 } },
@@ -2440,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",
@@ -2459,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",
@@ -2479,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.",
     "",
     "---",
     "",
@@ -2513,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:**",
@@ -2520,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.",
     "",
     "---",
     "",
@@ -2563,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:*`",
@@ -2672,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>",
@@ -2702,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>",
@@ -2715,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>",
     "   ```",
@@ -2725,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.",
     "",
     "---",
     "",
@@ -2821,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",
@@ -2835,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",
@@ -2867,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 = {
@@ -2915,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",
     "",
@@ -2926,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 }
@@ -2965,7 +3622,12 @@ var companyProfileBundle = {
       tags: ["workflow"]
     }
   ],
-  skills: [profileCompanySkill],
+  skills: [
+    profileCompanySkill,
+    matchCompanySkill,
+    refreshCompanySkill,
+    analyzeSegmentSkill
+  ],
   subAgents: [companyProfileAnalystSubAgent],
   labels: [
     {
@@ -2987,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"
     }
   ]
 };
@@ -5594,7 +6271,7 @@ var orchestratorBundle = {
 // src/agent/bundles/people-profile.ts
 var peopleProfileAnalystSubAgent = {
   name: "people-profile-analyst",
-  description: "Researches an individual person (colleague, customer contact, vendor contact, partner contact, industry expert, or connector) from public sources and produces a structured markdown profile cross-linked to companies, software, and meeting notes, then enqueues downstream `company:research` and `software:research` issues for unprofiled companies and software products surfaced during profiling. One person per session, tracked by people:* GitHub issue labels.",
+  description: "Researches an individual person (colleague, customer contact, vendor contact, partner contact, industry expert, or connector) from public sources and produces a structured markdown profile cross-linked to companies, software, and meeting notes, then enqueues downstream `company:research` and `software:research` issues for unprofiled companies and software products surfaced during profiling. Also handles maintenance refreshes on a configurable staleness cadence (`people:refresh`). One person per session, tracked by people:* GitHub issue labels.",
   model: AGENT_MODEL.POWERFUL,
   maxTurns: 80,
   platforms: { cursor: { exclude: true } },
@@ -5654,6 +6331,12 @@ var peopleProfileAnalystSubAgent = {
     "   the `software-profile` bundle via `software:research` issues.",
     "   Meeting notes remain link-only \u2014 this agent never creates",
     "   meeting-research issues.",
+    "9. **Refresh is targeted re-verification, not re-research.**",
+    "   `people:refresh` runs a small number of targeted searches focused",
+    "   on the narrow set of facts that drift (role, employer, primary",
+    "   public channel) and updates the profile in place. It never",
+    "   re-runs the full research-phase sweep and never forks the profile",
+    "   under a new slug.",
     "",
     "---",
     "",
@@ -5688,6 +6371,15 @@ var peopleProfileAnalystSubAgent = {
     "\u2502 bounded notes     \u2502     \u2502 the configured path  \u2502     \u2502 company/software   \u2502",
     "\u2502 file              \u2502     \u2502                      \u2502     \u2502 research issues    \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\u2500\u2518",
+    "",
+    "\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510",
+    "\u2502 4. REFRESH        \u2502  (cadence-driven, or on-demand)",
+    "\u2502 Re-verify an      \u2502",
+    "\u2502 existing profile  \u2502",
+    "\u2502 with targeted web \u2502",
+    "\u2502 searches. Update  \u2502",
+    "\u2502 in place.         \u2502",
+    "\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:**",
@@ -5697,13 +6389,13 @@ var peopleProfileAnalystSubAgent = {
     "| `people:research` | 1. Research | Gather public sources. Write a bounded research-notes file. Create the draft issue. |",
     "| `people:draft` | 2. Draft | Read the research notes. Write the structured profile to `<PROFILES_DIR>`. Create the followup issue if warranted. |",
     "| `people:followup` | 3. Followup | Read the profile. Update cross-references to existing companies, software, and meeting notes. Enqueue `company:research` and `software:research` issues for unprofiled, genuinely-relevant entities surfaced in the profile. |",
+    "| `people:refresh` | 4. Refresh | Read an existing profile. Run 3\u20135 targeted web searches for role, employer, and primary public channel changes. Update the profile in place and add a revision-history entry. |",
     "",
     "All issues also carry `type:people-profile` and a `status:*` label.",
     "",
     "**Issue count per person cycle:** 1 research + 1 draft + 0\u20131 followup =",
-    "**2\u20133 sessions**. The followup phase is skipped when the profile did",
-    "not surface any cross-references worth linking and no companies or",
-    "software products warrant downstream research.",
+    "**2\u20133 sessions** on the initial cycle. `people:refresh` is an",
+    "independent downstream cycle that runs on its own cadence.",
     "",
     "**Shortened paths:**",
     "- Research phase determines the person is out of scope (not",
@@ -5711,14 +6403,17 @@ var peopleProfileAnalystSubAgent = {
     "  with a justification and no downstream issues are created \u2192 **1 session**.",
     "- Short profile with no cross-references and no downstream",
     "  candidates \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-person` skill invocation",
-    "or by extending this rule in their own `agentConfig.rules`.",
+    "defaults by passing paths in the `/profile-person` or `/refresh-person`",
+    "skill invocations, or by extending this rule in their own",
+    "`agentConfig.rules`.",
     "",
     "| Placeholder | Meaning | Default |",
     "|-------------|---------|---------|",
@@ -5740,26 +6435,37 @@ var peopleProfileAnalystSubAgent = {
     "## Refresh Cadence",
     "",
     "Profiles go stale. A person changes jobs, publishes new work, or",
-    "shifts focus. The pipeline supports a configurable refresh cadence:",
-    "",
-    "- **Default cadence:** 180 days from the profile's `date` frontmatter.",
-    "- **Override:** the invoking issue body may specify a `refresh_days: N`",
-    "  field, or the consuming project may set a project-wide default in",
-    "  `docs/src/content/docs/project-context.md`.",
-    "",
-    "When the `/profile-person` skill is invoked for a slug that already",
-    "has a profile:",
-    "",
-    "- If the profile is **younger** than the refresh cadence, the skill",
-    "  exits with a message pointing to the existing profile. Pass",
+    "shifts focus. The pipeline supports a configurable refresh cadence",
+    "so `people:refresh` issues can be filed on a schedule without",
+    "hardcoding the interval:",
+    "",
+    "- **Default staleness threshold:** 180 days from the profile's",
+    "  `date` frontmatter.",
+    "- **Override 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**",
+    "",
+    "When the `/refresh-person` skill is invoked for an existing 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 refresh cadence, the pipeline",
-    "  proceeds in update-in-place mode: Phase 2 edits the existing file,",
-    "  preserves its slug, and bumps the `date` frontmatter.",
+    "- If the profile is **older** than the staleness threshold, the",
+    "  pipeline files a `people:refresh` issue and Phase 4 updates the",
+    "  existing file in place, preserving its slug and bumping the",
+    "  `date` frontmatter.",
+    "",
+    "The same precedence and `force: true` semantics apply when",
+    "`/profile-person` is invoked for a slug that already has a profile:",
+    "a fresh profile short-circuits; a stale profile is updated in place",
+    "by Phase 2 rather than forked under a new slug.",
     "",
     "Refresh mode never changes the profile's role without an explicit",
-    "override in the refresh request \u2014 role changes are material and",
-    "warrant a human review step.",
+    "override in the refresh request (`retype: <role>`) \u2014 role changes",
+    "are material and warrant a human review step.",
     "",
     "---",
     "",
@@ -5768,7 +6474,8 @@ var peopleProfileAnalystSubAgent = {
     "Run this loop exactly once per session. Never start a second issue.",
     "",
     "1. Claim one open `type:people-profile` issue using phase priority:",
-    "   `people:research` > `people:draft` > `people:followup`.",
+    "   `people:research` > `people:draft` > `people:followup` >",
+    "   `people:refresh`.",
     "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 `people:*`",
@@ -5936,6 +6643,11 @@ var peopleProfileAnalystSubAgent = {
     "   <what the profile could not answer; flag anything the followup",
     "   phase should cross-reference>",
     "",
+    "   ## Revision History",
+    "   | Date | Changes |",
+    "   |------|---------|",
+    "   | YYYY-MM-DD | Initial profile |",
+    "",
     "   ## Sources",
     "   - <source URL> \u2014 <date accessed>",
     "   ```",
@@ -6081,12 +6793,87 @@ var peopleProfileAnalystSubAgent = {
     "",
     "---",
     "",
+    "## Phase 4: Refresh (`people:refresh`)",
+    "",
+    "**Goal:** Re-verify an existing profile against a narrow set of facts",
+    "that tend to drift \u2014 current role, current employer, primary public",
+    "channel (email, handle, personal site) \u2014 with a small number of",
+    "targeted web searches, then update the profile in place.",
+    "",
+    "**Budget:** 3\u20135 targeted web searches focused on the narrow delta",
+    "set. Do not redo the full research-phase sweep, do not re-gather the",
+    "full background, and do not rewrite the profile body for facts that",
+    "have not changed.",
+    "",
+    "### 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 3\u20135 targeted searches.** Focus on the narrow delta set:",
+    "   - Current role / title at the current employer",
+    "   - Current employer (has the person changed jobs?)",
+    "   - Primary public channel (personal site URL, primary social",
+    "     handle, speaker inquiry form, public email if listed)",
+    "   - Optional: one search for notable recent public work (a new",
+    "     talk, post, or project) if the profile's Expertise Signals",
+    "     section has no entry from the last 12 months",
+    "",
+    "4. **Update the profile in place.** Edit only the affected sections",
+    "   (typically `## Current Position`, `## Contact Preferences`, and",
+    "   occasionally `## Expertise Signals`). Cite every new claim.",
+    "   Preserve the slug and the original `parent_issue` field. Bump the",
+    "   `date` frontmatter to today's date. Leave untouched sections",
+    "   untouched \u2014 refresh is a narrow delta, not a rewrite.",
+    "",
+    "5. **Do not silently re-type the person.** If the refresh surfaces",
+    "   evidence that the person's primary role has changed (e.g., a",
+    "   customer-contact who now works at your own organization and",
+    "   should become a colleague), flag it in `## Risks / Open Questions`",
+    "   and stop \u2014 do **not** rewrite the `role` frontmatter without an",
+    "   explicit override in the refresh issue body (`retype: <role>`).",
+    "",
+    "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. **Respect privacy.** The narrow delta set is bounded to public",
+    "   professional facts. Never expand the refresh into private contact",
+    "   details, family information, or other non-professional data \u2014",
+    "   even if a search surfaces them. Privacy guardrails from Phase 1",
+    "   apply to every refresh.",
+    "",
+    "8. **Commit and push.** Close the refresh issue with a short comment",
+    "   summarizing the delta (or `no material change`).",
+    "",
+    "---",
+    "",
     "## Output Boundaries",
     "",
     "This agent writes **only** to:",
     "",
     "- `<NOTES_DIR>/` \u2014 research-notes files (Phase 1)",
-    "- `<PROFILES_DIR>/` \u2014 person profiles (Phase 2, updated in Phase 3)",
+    "- `<PROFILES_DIR>/` \u2014 person profiles (Phase 2, updated in Phases",
+    "  3 and 4)",
     "",
     "In Phase 3, this agent also **creates `company:research` and",
     "`software:research` issues** for companies and software products",
@@ -6097,6 +6884,13 @@ var peopleProfileAnalystSubAgent = {
     "which pick up the issues this pipeline creates. Meeting notes",
     "remain link-only across all phases.",
     "",
+    "In Phase 4, this agent only updates an existing profile in place \u2014",
+    "it never forks a new profile under a different slug and never",
+    "enqueues downstream `company:research` or `software:research`",
+    "issues. Cross-references surfaced during a refresh are flagged in",
+    "`## Risks / Open Questions` for a follow-up `people:followup` pass",
+    "to handle.",
+    "",
     "The pipeline produces **person profiles and notes only**. Deeper",
     "research on companies and software products is delegated to",
     "downstream research pipelines via `company:research` and",
@@ -6141,6 +6935,15 @@ var peopleProfileAnalystSubAgent = {
     "  not open `type:requirement` or formal evaluation issues from this",
     "  pipeline. Follow-up research is scoped through `company:research`",
     "  and `software:research` only.",
+    "- **Refresh respects the cadence.** Phase 4 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.",
+    "- **Refresh is narrow, not a rewrite.** Phase 4 re-verifies role,",
+    "  employer, and primary public channel with 3\u20135 targeted searches",
+    "  and updates only the affected sections. It never re-runs the full",
+    "  research-phase sweep and never rewrites sections whose underlying",
+    "  facts have not changed.",
     "- **Refresh, don't fork.** When a profile exists and is past its",
     "  cadence, update in place rather than creating a new slug."
   ].join("\n")
@@ -6219,23 +7022,110 @@ var profilePersonSkill = {
     "  other downstream artifacts itself."
   ].join("\n")
 };
+var refreshPersonSkill = {
+  name: "refresh-person",
+  description: "Kick off a people-profile refresh cycle. Creates a people:refresh issue for an existing profile and dispatches Phase 4 (Refresh) in the people-profile-analyst agent. Refresh re-verifies the profile's narrow delta set (role, employer, primary public channel) with 3\u20135 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: "people-profile-analyst",
+  platforms: { cursor: { exclude: true } },
+  instructions: [
+    "# Refresh Person",
+    "",
+    "Re-verify an existing person profile with a small number of",
+    "targeted web searches and update the profile in place. Creates a",
+    "`people:refresh` issue for the target profile and dispatches",
+    "Phase 4 (Refresh) in the people-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-person <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: <colleague | customer-contact | vendor-contact |",
+    "   partner-contact | industry-expert | connector>` \u2014 explicitly",
+    "   allow Phase 4 to change the profile's `role` when the refresh",
+    "   finds material evidence of a role-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 4 closes the refresh issue with a short comment",
+    "and stops without running any searches.",
+    "",
+    "## Budget",
+    "",
+    "- **3\u20135 targeted web searches** focused on the narrow delta set:",
+    "  current role / title, current employer, primary public channel",
+    "  (personal site, handle, speaker inquiry form, public email).",
+    "- Optional: one search for notable recent public work if the",
+    "  profile has no Expertise Signals entry from the last 12 months.",
+    "",
+    "## Privacy",
+    "",
+    "Privacy guardrails from Phase 1 apply to every refresh. Never",
+    "record private contact details, family information, or other",
+    "non-professional personal data \u2014 even if a search surfaces them.",
+    "",
+    "## Steps",
+    "",
+    "1. Create a `people:refresh` issue with `type:people-profile`,",
+    "   `priority:medium`, and `status:ready`. Body must include the",
+    "   profile path and any overrides.",
+    "2. Execute Phase 4 (Refresh) of the people-profile-analyst agent.",
+    "",
+    "## Output",
+    "",
+    "- The profile is updated in place (affected 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"
+  ].join("\n")
+};
 var peopleProfileBundle = {
   name: "people-profile",
-  description: "People research and profiling pipeline: research, draft profile, followup. Enabled by default; domain-neutral; filesystem-durable between phases. Cross-references existing companies, software, and meeting notes, and Phase 3 (Followup) hands unprofiled, genuinely-relevant companies and software products off to the `company-profile` and `software-profile` bundles via `company:research` and `software:research` issues.",
+  description: "People research and profiling pipeline: research, draft profile, followup, refresh. Enabled by default; domain-neutral; filesystem-durable between phases. Cross-references existing companies, software, and meeting notes, and Phase 3 (Followup) hands unprofiled, genuinely-relevant companies and software products off to the `company-profile` and `software-profile` bundles via `company:research` and `software:research` issues. Phase 4 (Refresh) re-verifies profiles on a configurable staleness cadence.",
   appliesWhen: () => true,
   rules: [
     {
       name: "people-profile-workflow",
-      description: "Describes the 3-phase people-profile pipeline, the people:* label taxonomy, the cross-reference model, and the boundary against downstream research agents.",
+      description: "Describes the 4-phase people-profile pipeline, the people:* label taxonomy, the cross-reference model, the refresh cadence rules, and the boundary against downstream research agents.",
       scope: AGENT_RULE_SCOPE.ALWAYS,
       content: [
         "# People Profile Workflow",
         "",
         "Use `/profile-person <person-name>` to kick off a person",
-        "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 `people:research`, `people:draft`, or",
-        "`people:followup`. All issues carry `type:people-profile`.",
+        "research and profiling pipeline. The pipeline runs in up to 4",
+        "phases \u2014 research, draft, followup, refresh \u2014 each tracked by",
+        "its own GitHub issue labeled `people:research`, `people:draft`,",
+        "`people:followup`, or `people:refresh`. All issues carry",
+        "`type:people-profile`.",
+        "",
+        "One additional user-invocable skill drives the maintenance",
+        "phase independently:",
+        "",
+        "- `/refresh-person <path-to-profile>` \u2014 re-verify an existing",
+        "  profile with 3\u20135 targeted web searches and update it in",
+        "  place (Phase 4, respects a configurable staleness threshold).",
         "",
         "The pipeline produces **person profiles only**. Deeper research",
         "on companies and software products surfaced while profiling is",
@@ -6254,7 +7144,7 @@ var peopleProfileBundle = {
       tags: ["workflow"]
     }
   ],
-  skills: [profilePersonSkill],
+  skills: [profilePersonSkill, refreshPersonSkill],
   subAgents: [peopleProfileAnalystSubAgent],
   labels: [
     {
@@ -6276,6 +7166,11 @@ var peopleProfileBundle = {
       name: "people:followup",
       color: "D4C5F9",
       description: "Phase 3: cross-link the profile to existing companies, software, and meeting notes, and enqueue follow-up research issues for unprofiled companies and software products"
+    },
+    {
+      name: "people:refresh",
+      color: "F9D0C4",
+      description: "Phase 4: re-verify an existing person profile with targeted web searches and update it in place"
     }
   ]
 };