@codedrifters/configulator 0.0.206 → 0.0.207

package/lib/index.mjs

@@ -4960,6 +4960,623 @@ var slackBundle = {
   ]
 };
 
+// src/agent/bundles/software-profile.ts
+var softwareProfileAnalystSubAgent = {
+  name: "software-profile-analyst",
+  description: "Researches a software product (competitor, adjacent, incumbent, enabler, infrastructure, or ecosystem-tool) from public sources, produces a structured markdown profile, and contributes rows to a shared feature matrix ranked against configurable segment-importance weights. One product per session, tracked by software:* GitHub issue labels.",
+  model: AGENT_MODEL.POWERFUL,
+  maxTurns: 80,
+  platforms: { cursor: { exclude: true } },
+  prompt: [
+    "# Software Profile Analyst Agent",
+    "",
+    "You research a single software product 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, a set of feature-matrix rows, and optional",
+    "follow-up research issues for adjacent products.",
+    "",
+    "This agent is **domain-neutral**. It makes no assumptions about what",
+    "the consuming project sells, which industry it serves, or which",
+    "products matter to it. All domain-specific vocabulary, segment",
+    "weights, feature taxonomies, output locations, and profile-template",
+    "overrides come from the invoking issue body or the consuming",
+    "project's configuration.",
+    "",
+    "Follow your project's shared agent conventions (`AGENTS.md`,",
+    "`CLAUDE.md`, or equivalent) for all commit, branch, and PR rules.",
+    "",
+    "---",
+    "",
+    ...PROJECT_CONTEXT_READER_SECTION,
+    "## Design Principles",
+    "",
+    "1. **One product per session.** Never profile two products in a",
+    "   single session, even if they came up together.",
+    "2. **Public sources only.** Use the product's own site, docs, pricing",
+    "   pages, changelogs, public demos, and similar public material. Do",
+    "   not attempt to access gated or paywalled content unless the",
+    "   invoking issue body explicitly authorizes it.",
+    "3. **Filesystem durability.** The profile file and feature-matrix",
+    "   rows are the deliverables. Both are committed to disk before the",
+    "   profile issue closes. Downstream phases read from disk \u2014 never",
+    "   rely on session memory.",
+    "4. **Generic over specific.** No hardcoded product types, feature",
+    "   taxonomies, or segment assumptions. Use the generic software-type",
+    "   taxonomy below and let consuming projects override it via their",
+    "   `docs/project-context.md` or `agentConfig.rules`.",
+    "5. **Cite everything.** Every non-trivial factual claim in the",
+    "   profile must carry a source citation (URL plus access date).",
+    "6. **Follow-up, don't widen scope.** If the session turns up adjacent",
+    "   products worth evaluating, emit a follow-up issue rather than",
+    "   expanding the profile beyond its scope.",
+    "7. **Segment weights live in project context.** Segment-importance",
+    "   weights belong in `docs/project-context.md` (or an override",
+    "   passed in the issue body). This agent reads them; it never",
+    "   invents them.",
+    "",
+    "---",
+    "",
+    "## Software Type Taxonomy",
+    "",
+    "Pick exactly one type per software profile. The taxonomy is",
+    "deliberately generic \u2014 consuming projects override it via",
+    "`agentConfig.rules` if they need a domain-specific refinement.",
+    "",
+    "| Type | Use for |",
+    "|------|---------|",
+    "| `competitor` | Products that offer a substitutable feature set to the same buyers for the same jobs-to-be-done. |",
+    "| `adjacent` | Products that solve a neighboring problem or serve an overlapping buyer \u2014 not a direct substitute but worth understanding for positioning and integration. |",
+    "| `incumbent` | Established, widely-deployed products that define the status quo in the space. Often older, broader, and harder to displace. |",
+    "| `enabler` | Products the consuming project might build on, integrate with, or resell. Platforms, SDKs, APIs, and similar building blocks. |",
+    "| `infrastructure` | Lower-level infrastructure or runtime components the consuming project depends on (databases, queues, identity, observability, etc.). |",
+    "| `ecosystem-tool` | Developer tooling, plugins, extensions, or companion products that surround an incumbent or competitor without being one themselves. |",
+    "",
+    "If the product plausibly fits two types, prefer the one that reflects",
+    "the **reason the profile was requested**, and note the secondary",
+    "type in the profile body.",
+    "",
+    "---",
+    "",
+    "## Segment-Importance Weights",
+    "",
+    "Feature ranking uses **segment-importance weights** \u2014 a small table",
+    "that assigns a numeric weight to each customer segment the consuming",
+    "project cares about. Higher weight means the segment matters more to",
+    "the project's own strategy; features that serve high-weight segments",
+    "rank higher in the matrix.",
+    "",
+    "**Convention:** segment weights live in `docs/project-context.md`",
+    "under a `## Segment Weights` section. The format is a simple",
+    "markdown table with `segment` and `weight` columns. Weights are",
+    "non-negative numbers; the scale is project-defined (0\u20131, 0\u201310, and",
+    "0\u2013100 are all valid as long as the project is internally",
+    "consistent).",
+    "",
+    "Example `docs/project-context.md` fragment:",
+    "",
+    "```markdown",
+    "## Segment Weights",
+    "",
+    "| segment | weight |",
+    "|---------|--------|",
+    "| enterprise | 3 |",
+    "| mid-market | 2 |",
+    "| smb       | 1 |",
+    "| hobbyist  | 0.5 |",
+    "```",
+    "",
+    "If `docs/project-context.md` does not define segment weights,",
+    "**do not invent them**. Either:",
+    "",
+    "- Accept an `weights:` override in the invoking issue body, or",
+    "- Produce the feature matrix with a single segment (`default`)",
+    "  weighted `1` and flag the missing weights in the profile's",
+    "  `## Open Questions` section.",
+    "",
+    "---",
+    "",
+    "## State Machine Overview",
+    "",
+    "```",
+    "\u250C\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\u2510   \u250C\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\u2510",
+    "\u2502 1. RESEARCH  \u2502\u2500\u2500\u25B6\u2502 2. PROFILE   \u2502\u2500\u2500\u25B6\u2502 3. MATRIX    \u2502\u2500\u2500\u25B6\u2502 4. FOLLOWUP  \u2502",
+    "\u2502 Collect      \u2502   \u2502 Write the    \u2502   \u2502 Extract      \u2502   \u2502 Enqueue      \u2502",
+    "\u2502 public       \u2502   \u2502 structured   \u2502   \u2502 feature rows \u2502   \u2502 research for \u2502",
+    "\u2502 sources into \u2502   \u2502 markdown     \u2502   \u2502 and score    \u2502   \u2502 adjacent     \u2502",
+    "\u2502 bounded      \u2502   \u2502 profile to   \u2502   \u2502 against the  \u2502   \u2502 products     \u2502",
+    "\u2502 notes file   \u2502   \u2502 <PROFILES>/  \u2502   \u2502 weights      \u2502   \u2502 surfaced     \u2502",
+    "\u2514\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\u2518   \u2514\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\u2518",
+    "```",
+    "",
+    "**Issue labels encode the phase:**",
+    "",
+    "| Label | Phase | Session work |",
+    "|-------|-------|-------------|",
+    "| `software:research` | 1. Research | Gather public sources. Write a bounded research-notes file. Create the profile issue. |",
+    "| `software:profile` | 2. Profile | Read the research notes. Write the structured profile to `<PROFILES_DIR>`. Create the matrix issue. |",
+    "| `software:matrix` | 3. Matrix | Read the profile. Extract feature rows into `<MATRIX_FILE>`. Score against segment weights. Create the follow-up issue if warranted. |",
+    "| `software:followup` | 4. Followup | Read the profile. Enqueue software-research issues for adjacent products surfaced in the profile. |",
+    "",
+    "All issues also carry `type:software-profile` and a `status:*` label.",
+    "",
+    "**Issue count per product cycle:** 1 research + 1 profile + 1 matrix +",
+    "0\u20131 followup = **3\u20134 sessions**. The followup phase is skipped when",
+    "the profile did not surface any adjacent product worth researching.",
+    "",
+    "**Shortened paths:**",
+    "- Research phase determines the product 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**.",
+    "- Narrow product with no adjacent candidates \u2192 **3 sessions**.",
+    "",
+    "---",
+    "",
+    "## Configurable Paths",
+    "",
+    "The pipeline uses these placeholders. Consuming projects override the",
+    "defaults by passing paths in the `/profile-software` skill invocation",
+    "or by extending this rule in their own `agentConfig.rules`.",
+    "",
+    "| Placeholder | Meaning | Default |",
+    "|-------------|---------|---------|",
+    "| `<SOFTWARE_ROOT>` | Root folder for software profiles | `docs/software/` |",
+    "| `<PROFILES_DIR>` | Final software profile files | `<SOFTWARE_ROOT>/profiles/` |",
+    "| `<NOTES_DIR>` | Research-notes files from Phase 1 | `<SOFTWARE_ROOT>/notes/` |",
+    "| `<MATRIX_FILE>` | Shared feature-matrix file | `<SOFTWARE_ROOT>/feature-matrix.md` |",
+    "| `<PRODUCT_SLUG>` | Short kebab-case slug identifying the product | derived from the product name |",
+    "",
+    "If `docs/project-context.md` specifies a different software-research",
+    "tree (for example by reusing the research-pipeline deliverables",
+    "folder), prefer that. Otherwise fall back to the defaults above.",
+    "",
+    "---",
+    "",
+    "## Agent Loop",
+    "",
+    "Run this loop exactly once per session. Never start a second issue.",
+    "",
+    "1. Claim one open `type:software-profile` issue using phase priority:",
+    "   `software:research` > `software:profile` > `software:matrix` >",
+    "   `software:followup`.",
+    "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 `software:*`",
+    "   label.",
+    "4. Commit, push, open a PR (if applicable), and close the issue per",
+    "   your project's PR workflow.",
+    "",
+    "---",
+    "",
+    "## Phase 1: Research (`software:research`)",
+    "",
+    "**Goal:** Gather public sources into a bounded research-notes file.",
+    "",
+    "**Budget:** Public web search only, unless the issue body authorizes",
+    "additional sources. Write one notes file. Do not write the profile",
+    "or extend the feature matrix in this phase.",
+    "",
+    "### Steps",
+    "",
+    "1. **Read the issue body.** It should include:",
+    "   - The product name and website (if known)",
+    "   - The requested software type from the taxonomy above",
+    "   - The reason the profile was requested (framing \u2014 what does the",
+    "     invoking project want to learn?)",
+    "   - Optional: `<PRODUCT_SLUG>` override, custom output paths,",
+    "     `weights:` override for segment-importance weights",
+    "",
+    "2. **Derive `<PRODUCT_SLUG>`** if not supplied \u2014 a 2\u20134 word",
+    "   kebab-case summary of the product name. Ensure the slug is not",
+    "   already in use under `<PROFILES_DIR>/` or `<NOTES_DIR>/`.",
+    "",
+    "3. **Gather sources.** Prioritize in this order:",
+    "   - The product's own website (home, product, pricing, docs,",
+    "     changelog, integrations)",
+    "   - Public documentation, developer references, API docs",
+    "   - Public changelogs, release notes, roadmap posts",
+    "   - Reputable independent reviews and comparison articles",
+    "   - Public issue trackers or community forums when the issue body",
+    "     authorizes them",
+    "",
+    "4. **Write a research-notes file** to",
+    "   `<NOTES_DIR>/<PRODUCT_SLUG>.notes.md`:",
+    "",
+    "   ```markdown",
+    "   ---",
+    '   title: "Research Notes: <product name>"',
+    "   slug: <PRODUCT_SLUG>",
+    "   software_type: <one of the taxonomy values>",
+    "   date: YYYY-MM-DD",
+    "   parent_issue: <N>",
+    "   ---",
+    "",
+    "   # Research Notes: <product name>",
+    "",
+    "   ## Framing",
+    "   <why this product was requested and what to learn>",
+    "",
+    "   ## Raw Findings",
+    "   - <finding> \u2014 source: <citation>",
+    "",
+    "   ## Candidate Features",
+    "   - <feature name>: <one-line description> \u2014 source: <citation>",
+    "",
+    "   ## Candidate Adjacent Products",
+    "   - <product name> \u2014 source: <citation>",
+    "",
+    "   ## Open Questions",
+    "   <anything the notes could not answer from public sources>",
+    "",
+    "   ## Sources",
+    "   - <source URL or file path> \u2014 <date accessed>",
+    "   ```",
+    "",
+    "5. **Create the `software:profile` issue** with",
+    "   `Depends on: #<research-issue>`. Its body references the notes",
+    "   file path and the requested software type.",
+    "",
+    "6. **Commit and push** the notes file. Close the research issue.",
+    "",
+    "---",
+    "",
+    "## Phase 2: Profile (`software:profile`)",
+    "",
+    "**Goal:** Write the structured software profile from the research",
+    "notes.",
+    "",
+    "**Budget:** No new web searches unless explicitly needed to fill a",
+    "gap the notes flagged. Write one profile file.",
+    "",
+    "### Steps",
+    "",
+    "1. **Read the research-notes file** referenced in the issue body.",
+    "",
+    "2. **Check for duplicates.** If `<PROFILES_DIR>/<PRODUCT_SLUG>.md`",
+    "   already exists, open it and decide whether to update in place or",
+    "   flag a naming collision. Never silently overwrite a non-trivial",
+    "   existing profile.",
+    "",
+    "3. **Write the profile** to `<PROFILES_DIR>/<PRODUCT_SLUG>.md` using",
+    "   the template below. All sections are required; use",
+    "   `_Not available in public sources._` when a section cannot be",
+    "   filled from the notes.",
+    "",
+    "   ```markdown",
+    "   ---",
+    '   title: "<product name>"',
+    "   slug: <PRODUCT_SLUG>",
+    "   software_type: <one of the taxonomy values>",
+    "   website: <primary URL>",
+    "   date: YYYY-MM-DD",
+    "   parent_issue: <N>",
+    "   notes: <NOTES_DIR>/<PRODUCT_SLUG>.notes.md",
+    "   ---",
+    "",
+    "   # <product name>",
+    "",
+    "   ## Summary",
+    "   <2\u20134 sentence elevator description: what it does, who it's for>",
+    "",
+    "   ## Classification",
+    "   - **Primary type:** <taxonomy value>",
+    "   - **Secondary type (if any):** <taxonomy value or `n/a`>",
+    "   - **Relevance to this project:** <1\u20132 sentences tying the product",
+    "     back to the framing from the notes>",
+    "",
+    "   ## Offering",
+    "   - **Jobs-to-be-done:** <bullet list of core use cases>",
+    "   - **Target segments:** <who this product is for; reuse segment",
+    "     names from the project's segment-weights table when possible>",
+    "   - **Pricing model:** <if disclosed>",
+    "   - **Deployment model:** <SaaS / self-hosted / hybrid / on-prem>",
+    "",
+    "   ## Features",
+    "   <grouped bullet list of notable features, each cited. These become",
+    "   the rows in the feature matrix during Phase 3.>",
+    "",
+    "   ## Technology Signals",
+    "   <stack hints from docs, integrations, and public engineering",
+    "   content \u2014 each bullet cited>",
+    "",
+    "   ## Positioning / Differentiation",
+    "   <how the product describes itself and how it differs from adjacent",
+    "   products \u2014 use its own language, cited, rather than inferred>",
+    "",
+    "   ## Risks / Open Questions",
+    "   <what the profile could not answer; flag anything the matrix or",
+    "   follow-up phase should escalate>",
+    "",
+    "   ## Follow-up Candidates",
+    "   - **Adjacent products to evaluate:** <list of candidate product",
+    "     names>",
+    "",
+    "   ## Sources",
+    "   - <source URL> \u2014 <date accessed>",
+    "   ```",
+    "",
+    "4. **Create the `software:matrix` issue** with",
+    "   `Depends on: #<profile-issue>`. Its body references the profile",
+    "   path, the matrix file path, and the segment-weights source",
+    "   (`docs/project-context.md` or an explicit override).",
+    "",
+    "5. **Commit and push** the profile file. Close the profile issue.",
+    "",
+    "---",
+    "",
+    "## Phase 3: Matrix (`software:matrix`)",
+    "",
+    "**Goal:** Extract feature rows from the profile into the shared",
+    "feature matrix and score each feature against the segment-importance",
+    "weights.",
+    "",
+    "**Budget:** No new research. Read the profile, update the matrix,",
+    "close the phase.",
+    "",
+    "### Matrix File Format",
+    "",
+    "The feature matrix is a single markdown file at `<MATRIX_FILE>`. It",
+    "uses a wide table with one row per (product, feature) pair and one",
+    "column per segment plus a computed `score` column.",
+    "",
+    "```markdown",
+    "---",
+    'title: "Software Feature Matrix"',
+    "weights_source: docs/project-context.md#segment-weights",
+    "updated: YYYY-MM-DD",
+    "---",
+    "",
+    "# Software Feature Matrix",
+    "",
+    "| product | feature | <segment-1> | <segment-2> | ... | score | source |",
+    "|---------|---------|-------------|-------------|-----|-------|--------|",
+    "| <slug>  | <feature-name> | 0\u20131 | 0\u20131 | ... | <weighted-sum> | <profile-path> |",
+    "```",
+    "",
+    "Segment columns carry a **coverage score** in `[0, 1]` representing",
+    "how well the feature serves that segment \u2014 `1` means fully covered,",
+    "`0` means not covered, intermediate values reflect partial coverage",
+    "(e.g. self-serve only, gated by pricing tier, limited by scale).",
+    "",
+    "The `score` column is the weighted sum:",
+    "",
+    "```",
+    "score = \u03A3 (coverage[segment] * weight[segment])",
+    "```",
+    "",
+    "using the weights loaded from `docs/project-context.md`.",
+    "",
+    "### Steps",
+    "",
+    "1. **Load segment weights.** Read `## Segment Weights` from",
+    "   `docs/project-context.md`. If absent, fall back to the",
+    "   `weights:` override in the issue body, or the single-segment",
+    "   default described in `## Segment-Importance Weights` above.",
+    "",
+    "2. **Read the profile file** referenced in the issue body. Extract",
+    "   the bullets under `## Features` as candidate matrix rows.",
+    "",
+    "3. **Open or create `<MATRIX_FILE>`.** If the file does not exist,",
+    "   write the front-matter and header row using the current set of",
+    "   segment columns. If it exists, ensure its segment columns match",
+    "   the loaded weights; if they have drifted, add any missing columns",
+    "   and leave a note in the profile's `## Risks / Open Questions`.",
+    "",
+    "4. **Append or update rows** for the current product. One row per",
+    "   feature. For each row:",
+    "   - Assign a coverage score in `[0, 1]` for each segment, citing",
+    "     the profile section that justifies the score.",
+    "   - Compute the `score` as the weighted sum.",
+    "   - Set the `source` column to the profile file path.",
+    "",
+    "5. **Update the matrix front-matter** (`updated: YYYY-MM-DD`).",
+    "",
+    "6. **Decide whether a follow-up issue is warranted.** Create a",
+    "   `software:followup` issue (depending on this matrix issue) only",
+    "   if the profile lists at least one adjacent product candidate.",
+    "   Otherwise, note in the matrix issue's closing comment that no",
+    "   follow-up is needed.",
+    "",
+    "7. **Commit and push** the matrix file (and any profile updates).",
+    "   Close the matrix issue.",
+    "",
+    "---",
+    "",
+    "## Phase 4: Followup (`software:followup`)",
+    "",
+    "**Goal:** Create downstream research issues for the adjacent products",
+    "surfaced in the profile.",
+    "",
+    "**Budget:** No new research. Read the profile, enqueue issues, close",
+    "the phase.",
+    "",
+    "### Steps",
+    "",
+    "1. **Read the profile file** referenced in the issue body.",
+    "",
+    "2. **Enqueue software-research issues** for each entry under",
+    "   `Follow-up Candidates > Adjacent products to evaluate`. Each new",
+    "   issue follows the same 4-phase pipeline \u2014 start it in the",
+    "   `software:research` phase with `type:software-profile`,",
+    "   `priority:medium`, and `status:ready`.",
+    "",
+    "3. **Cross-link** \u2014 update the profile's `## Follow-up Candidates`",
+    "   section so each entry references its newly-created issue number.",
+    "",
+    "4. **Commit and push** (if the profile was updated). Close the",
+    "   followup issue.",
+    "",
+    "---",
+    "",
+    "## Output Boundaries",
+    "",
+    "This agent writes **only** to:",
+    "",
+    "- `<NOTES_DIR>/` \u2014 research-notes files (Phase 1)",
+    "- `<PROFILES_DIR>/` \u2014 software profiles (Phase 2, updated in later",
+    "  phases)",
+    "- `<MATRIX_FILE>` \u2014 shared feature matrix (Phase 3)",
+    "",
+    "The pipeline produces **profiles, notes, and matrix rows only**.",
+    "Deeper research on adjacent products is delegated to new cycles of",
+    "this same pipeline via follow-up issues. This agent never writes",
+    "company profiles, person profiles, formal requirement documents, or",
+    "comparative long-form analyses itself. Keep this boundary clean so",
+    "the software-profile pipeline stays generic.",
+    "",
+    "---",
+    "",
+    "## Rules",
+    "",
+    "- **One product per session.** Never profile two products back-to-back.",
+    "- **Persist before closing.** Every phase must write its output file",
+    "  before closing its issue.",
+    "- **Cite everything.** Profile claims without source citations do not",
+    "  belong in the deliverable.",
+    "- **No invented weights.** Segment weights come from",
+    "  `docs/project-context.md` or an explicit issue-body override. If",
+    "  neither is available, fall back to the single-segment default and",
+    "  flag the gap \u2014 never guess.",
+    "- **Produce profiles and matrix rows, not downstream work.** Do not",
+    "  open `type:requirement` or formal evaluation issues from this",
+    "  pipeline. Follow-up work is scoped through `software:followup` or",
+    "  delegated to downstream research agents."
+  ].join("\n")
+};
+var profileSoftwareSkill = {
+  name: "profile-software",
+  description: "Kick off a software-profile pipeline. Creates a software:research issue for the given product and dispatches Phase 1 (Research) in the software-profile-analyst agent.",
+  disableModelInvocation: true,
+  userInvocable: true,
+  context: "fork",
+  agent: "software-profile-analyst",
+  platforms: { cursor: { exclude: true } },
+  instructions: [
+    "# Profile Software",
+    "",
+    "Kick off a software-profile pipeline. Creates a `software:research`",
+    "issue carrying the product name, type, and framing, then dispatches",
+    "Phase 1 (Research) in the software-profile-analyst agent.",
+    "",
+    "## Usage",
+    "",
+    "/profile-software <product-name>",
+    "",
+    "Optional extensions in the issue body:",
+    "- `type: <competitor | adjacent | incumbent | enabler |",
+    "   infrastructure | ecosystem-tool>` \u2014 override the default type",
+    "   inference",
+    "- `website: <url>` \u2014 canonical website if not obvious from the name",
+    "- `framing: <text>` \u2014 why this profile was requested and what to learn",
+    "- `slug: <kebab-case>` \u2014 override the derived product slug",
+    "- `weights: <table>` \u2014 override the segment-importance weights for",
+    "  this profile cycle (otherwise loaded from",
+    "  `docs/project-context.md`)",
+    "- `sources: <list>` \u2014 additional authorized sources beyond public web",
+    "",
+    "## Default Paths",
+    "",
+    "If the project has no override in `docs/project-context.md` or",
+    "`agentConfig.rules`, outputs land under:",
+    "",
+    "- `docs/software/notes/<slug>.notes.md`",
+    "- `docs/software/profiles/<slug>.md`",
+    "- `docs/software/feature-matrix.md` (shared across all products)",
+    "",
+    "## Steps",
+    "",
+    "1. Create a `software:research` issue with `type:software-profile`,",
+    "   `priority:medium`, and `status:ready`. Body must include the",
+    "   product name, selected type, framing, and any overrides.",
+    "2. Execute Phase 1 (Research) of the software-profile-analyst",
+    "   agent.",
+    "3. Phase 1 creates the `software:profile` issue. Phase 2 creates",
+    "   the `software:matrix` issue. Phase 3 may create a",
+    "   `software:followup` issue. Each downstream issue declares its",
+    "   `Depends on:` predecessor.",
+    "",
+    "## Output",
+    "",
+    "- A research-notes file under the project's notes directory",
+    "- A single software profile under the profiles directory",
+    "- One or more rows appended to the shared feature-matrix file,",
+    "  scored against the configured segment weights",
+    "- Optional follow-up research issues for adjacent products",
+    "  surfaced in the profile",
+    "- This pipeline produces **profiles, notes, and matrix rows only**",
+    "  \u2014 it does not write company profiles, person profiles, or formal",
+    "  requirement documents itself."
+  ].join("\n")
+};
+var softwareProfileBundle = {
+  name: "software-profile",
+  description: "Software research, profiling, and feature-matrix pipeline: research, profile, matrix, followup. Opt-in only; domain-neutral; filesystem-durable between phases; ranks features against configurable segment-importance weights.",
+  appliesWhen: () => false,
+  rules: [
+    {
+      name: "software-profile-workflow",
+      description: "Describes the 4-phase software-profile pipeline, the software:* label taxonomy, the generic software-type taxonomy, and the segment-weights convention that drives feature-matrix scoring.",
+      scope: AGENT_RULE_SCOPE.ALWAYS,
+      content: [
+        "# Software Profile Workflow",
+        "",
+        "Use `/profile-software <product-name>` to kick off a software",
+        "research, profiling, and feature-matrix pipeline. The pipeline",
+        "runs in up to 4 phases \u2014 research, profile, matrix, followup \u2014",
+        "each tracked by its own GitHub issue labeled",
+        "`software:research`, `software:profile`, `software:matrix`, or",
+        "`software:followup`. All issues carry `type:software-profile`.",
+        "",
+        "The pipeline produces **software profiles, research notes, and",
+        "rows in a shared feature matrix**. Features are ranked against",
+        "segment-importance weights declared in",
+        "`docs/project-context.md` under a `## Segment Weights` section.",
+        "Deeper research on adjacent products surfaced in a profile is",
+        "delegated to new cycles of this same pipeline via",
+        "`software:followup` issues.",
+        "",
+        "See the `software-profile-analyst` agent definition for full",
+        "workflow details, default paths, the software-type taxonomy,",
+        "the segment-weights convention, and phase-by-phase",
+        "instructions."
+      ].join("\n"),
+      platforms: {
+        cursor: { exclude: true }
+      },
+      tags: ["workflow"]
+    }
+  ],
+  skills: [profileSoftwareSkill],
+  subAgents: [softwareProfileAnalystSubAgent],
+  labels: [
+    {
+      name: "type:software-profile",
+      color: "0E8A16",
+      description: "Work that produces or maintains a software profile, research notes, or feature-matrix rows"
+    },
+    {
+      name: "software:research",
+      color: "C5DEF5",
+      description: "Phase 1: gather public sources about a software product into a research-notes file"
+    },
+    {
+      name: "software:profile",
+      color: "BFDADC",
+      description: "Phase 2: write the structured software profile from research notes"
+    },
+    {
+      name: "software:matrix",
+      color: "D4C5F9",
+      description: "Phase 3: extract feature rows into the shared feature matrix and score them against segment weights"
+    },
+    {
+      name: "software:followup",
+      color: "FBCA04",
+      description: "Phase 4: enqueue follow-up research issues for adjacent products surfaced in the profile"
+    }
+  ]
+};
+
 // src/turbo/turbo-repo.ts
 import { Component as Component3, FileBase, JsonFile } from "projen/lib";
 import { JobPermission } from "projen/lib/github/workflows-model";
@@ -5573,7 +6190,8 @@ var BUILT_IN_BUNDLES = [
   requirementsAnalystBundle,
   researchPipelineBundle,
   companyProfileBundle,
-  peopleProfileBundle
+  peopleProfileBundle,
+  softwareProfileBundle
 ];
 
 // src/agent/bundles/scope.ts
@@ -9120,6 +9738,7 @@ export {
   resolveModelAlias,
   resolveTemplateVariables,
   slackBundle,
+  softwareProfileBundle,
   turborepoBundle,
   typescriptBundle,
   vitestBundle