@codedrifters/configulator 0.0.215 → 0.0.217

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/lib/index.js CHANGED
@@ -1704,7 +1704,7 @@ var bcmWriterBundle = {
1704
1704
  // src/agent/bundles/company-profile.ts
1705
1705
  var companyProfileAnalystSubAgent = {
1706
1706
  name: "company-profile-analyst",
1707
- description: "Researches an external company (competitor, vendor, partner, customer, etc.) from public sources and produces a structured markdown profile. Optionally enqueues follow-up people and software research tasks. One company per session, tracked by company:* GitHub issue labels.",
1707
+ 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.",
1708
1708
  model: AGENT_MODEL.POWERFUL,
1709
1709
  maxTurns: 80,
1710
1710
  platforms: { cursor: { exclude: true } },
@@ -1747,7 +1747,10 @@ var companyProfileAnalystSubAgent = {
1747
1747
  "6. **Follow-up, don't widen scope.** If the session turns up adjacent",
1748
1748
  " research questions (a key person worth profiling, a product worth",
1749
1749
  " evaluating), emit a follow-up issue rather than expanding the",
1750
- " profile beyond its scope.",
1750
+ " profile beyond its scope. Notable people are handed off to the",
1751
+ " `people-profile` bundle via `people:research` issues; software",
1752
+ " products are handed off to the `software-profile` bundle via",
1753
+ " `software:research` issues.",
1751
1754
  "",
1752
1755
  "---",
1753
1756
  "",
@@ -1818,6 +1821,8 @@ var companyProfileAnalystSubAgent = {
1818
1821
  "| `<PROFILES_DIR>` | Final company profile files | `<COMPANY_ROOT>/profiles/` |",
1819
1822
  "| `<NOTES_DIR>` | Research-notes files from Phase 1 | `<COMPANY_ROOT>/notes/` |",
1820
1823
  "| `<COMPANY_SLUG>` | Short kebab-case slug identifying the company | derived from the company name |",
1824
+ "| `<PEOPLE_PROFILES_DIR>` | Where existing people profiles live (for duplicate detection during followup) | `docs/people/profiles/` |",
1825
+ "| `<SOFTWARE_PROFILES_DIR>` | Where existing software profiles live (for duplicate detection during followup) | `docs/software/profiles/` |",
1821
1826
  "",
1822
1827
  "If `docs/project-context.md` specifies a different company-research",
1823
1828
  "tree (for example by reusing the research-pipeline deliverables",
@@ -1999,30 +2004,91 @@ var companyProfileAnalystSubAgent = {
1999
2004
  "## Phase 3: Followup (`company:followup`)",
2000
2005
  "",
2001
2006
  "**Goal:** Create downstream research issues for the people and",
2002
- "products surfaced in the profile.",
2007
+ "software products surfaced in the profile. Hand the candidates off to",
2008
+ "the `people-profile` and `software-profile` bundles so they can be",
2009
+ "researched independently.",
2003
2010
  "",
2004
2011
  "**Budget:** No new research. Read the profile, enqueue issues, close",
2005
- "the phase.",
2012
+ "the phase. Markdown cross-references in the profile's",
2013
+ "`## Follow-up Candidates` section are preserved \u2014 issue creation is",
2014
+ "**additive** on top of the existing notes-only behavior.",
2006
2015
  "",
2007
2016
  "### Steps",
2008
2017
  "",
2009
2018
  "1. **Read the profile file** referenced in the issue body.",
2010
2019
  "",
2011
- "2. **Enqueue people-profile issues** for each entry under",
2012
- " `Follow-up Candidates > People to profile`. Use the consuming",
2013
- " project's people-research pipeline if one exists; otherwise, open",
2014
- " a generic `type:research` issue describing what to learn about the",
2015
- " person and linking back to the company profile.",
2016
- "",
2017
- "3. **Enqueue software-evaluation issues** for each entry under",
2018
- " `Follow-up Candidates > Products / software to evaluate`. Again,",
2019
- " use a project-specific pipeline if configured, otherwise a generic",
2020
- " `type:research` issue.",
2021
- "",
2022
- "4. **Cross-link** \u2014 update the profile's `## Follow-up Candidates`",
2023
- " section so each entry references its newly-created issue number.",
2024
- "",
2025
- "5. **Commit and push** (if the profile was updated). Close the",
2020
+ "2. **Enqueue a `people:research` issue per candidate** under",
2021
+ " `Follow-up Candidates > People to profile` that is worth",
2022
+ " downstream research. Each issue must carry:",
2023
+ "",
2024
+ " - `type:people-profile`",
2025
+ " - `people:research`",
2026
+ " - `priority:medium`",
2027
+ " - `status:ready`",
2028
+ "",
2029
+ " The issue body must include:",
2030
+ " - A **discovery source** line naming this company profile",
2031
+ " (`Discovered while profiling: <company name>`)",
2032
+ " - A link to the company profile path (`Company profile: <PROFILES_DIR>/<COMPANY_SLUG>.md`)",
2033
+ " - Enough identifying metadata \u2014 full name, role/title, and",
2034
+ " employing company \u2014 that the `people-profile-analyst` agent can",
2035
+ " begin research without revisiting this company profile",
2036
+ "",
2037
+ "3. **Enqueue a `software:research` issue per candidate** under",
2038
+ " `Follow-up Candidates > Products / software to evaluate` that is",
2039
+ " worth downstream research. Each issue must carry:",
2040
+ "",
2041
+ " - `type:software-profile`",
2042
+ " - `software:research`",
2043
+ " - `priority:medium`",
2044
+ " - `status:ready`",
2045
+ "",
2046
+ " The issue body must include:",
2047
+ " - A **discovery source** line naming this company profile",
2048
+ " (`Discovered while profiling: <company name>`)",
2049
+ " - A link to the company profile path (`Company profile: <PROFILES_DIR>/<COMPANY_SLUG>.md`)",
2050
+ " - Enough identifying metadata \u2014 product name and vendor (usually",
2051
+ " this company if it builds the product, otherwise the upstream",
2052
+ " vendor) \u2014 that the `software-profile-analyst` agent can begin",
2053
+ " research without revisiting this company profile",
2054
+ "",
2055
+ "4. **Avoid duplicates.** Before opening a `people:research` or",
2056
+ " `software:research` issue, verify no existing profile covers the",
2057
+ " candidate:",
2058
+ "",
2059
+ " - People: check `<PEOPLE_PROFILES_DIR>/` for a matching profile",
2060
+ " file (by derived slug or by searching the directory for the",
2061
+ " person's name). If a profile exists, reuse it as a cross-reference",
2062
+ " only \u2014 **do not** open a new `people:research` issue.",
2063
+ " - Software: check `<SOFTWARE_PROFILES_DIR>/` the same way. If a",
2064
+ " profile exists, reuse it as a cross-reference only \u2014 **do not**",
2065
+ " open a new `software:research` issue.",
2066
+ " - Also scan open issues carrying the matching `people:research` or",
2067
+ " `software:research` label so this phase never re-opens research",
2068
+ " that is already queued.",
2069
+ "",
2070
+ "5. **Exercise restraint.** Only create downstream issues for people",
2071
+ " and software products that are **genuinely relevant** to the",
2072
+ " framing of this profile \u2014 executives, founders, and decision-makers",
2073
+ " for people; products the company builds or materially depends on",
2074
+ " for software. Do **not** open issues for every name mentioned in",
2075
+ " passing, every SaaS tool listed in a job ad, or every tangential",
2076
+ " partner. When in doubt, leave the candidate as a markdown",
2077
+ " cross-reference in the profile and skip the downstream issue.",
2078
+ "",
2079
+ "6. **Assume the peers are present.** This pipeline assumes the",
2080
+ " `people-profile` and `software-profile` bundles are enabled in the",
2081
+ " consuming project. If a consuming project has disabled one of",
2082
+ " them, flag the followup issue with `status:needs-attention` and",
2083
+ " list the candidates that could not be routed \u2014 never invent an",
2084
+ " alternative label taxonomy.",
2085
+ "",
2086
+ "7. **Cross-link** \u2014 update the profile's `## Follow-up Candidates`",
2087
+ " section so each entry references its newly-created issue number",
2088
+ " (or the existing profile path, for candidates that were skipped",
2089
+ " because a profile already exists).",
2090
+ "",
2091
+ "8. **Commit and push** (if the profile was updated). Close the",
2026
2092
  " followup issue.",
2027
2093
  "",
2028
2094
  "---",
@@ -2034,9 +2100,17 @@ var companyProfileAnalystSubAgent = {
2034
2100
  "- `<NOTES_DIR>/` \u2014 research-notes files (Phase 1)",
2035
2101
  "- `<PROFILES_DIR>/` \u2014 company profiles (Phase 2, updated in Phase 3)",
2036
2102
  "",
2037
- "The pipeline produces **profiles and notes only**. Deeper research on",
2038
- "people or products is delegated to downstream research pipelines via",
2039
- "follow-up issues \u2014 this agent never writes person profiles, product",
2103
+ "In Phase 3, this agent also **creates `people:research` and",
2104
+ "`software:research` issues** for people and software products",
2105
+ "surfaced in the profile. It never writes the downstream profiles",
2106
+ "themselves \u2014 those are the responsibility of the",
2107
+ "`people-profile-analyst` and `software-profile-analyst` agents, which",
2108
+ "pick up the issues this pipeline creates.",
2109
+ "",
2110
+ "The pipeline produces **company profiles and notes only**. Deeper",
2111
+ "research on people or products is delegated to downstream research",
2112
+ "pipelines via `people:research` and `software:research` issues \u2014 this",
2113
+ "agent never writes person profiles, software profiles, product",
2040
2114
  "evaluations, or comparative analyses itself. Keep this boundary clean",
2041
2115
  "so the company-profile pipeline stays generic.",
2042
2116
  "",
@@ -2052,10 +2126,23 @@ var companyProfileAnalystSubAgent = {
2052
2126
  "- **No assumed competition.** Never call a company a competitor unless",
2053
2127
  " the invoking issue body or the consuming project's configuration",
2054
2128
  " says so.",
2055
- "- **Produce profiles, not downstream work.** Do not open",
2056
- " `type:requirement` or formal evaluation issues from this pipeline.",
2057
- " Follow-up work is scoped through `company:followup` or delegated to",
2058
- " downstream research agents."
2129
+ "- **Delegate, don't duplicate.** People and software products",
2130
+ " surfaced during profiling are handed off to the `people-profile`",
2131
+ " and `software-profile` bundles via `people:research` and",
2132
+ " `software:research` issues in Phase 3 \u2014 never inlined as person or",
2133
+ " software profiles in this pipeline.",
2134
+ "- **Check before enqueueing.** Before opening a `people:research` or",
2135
+ " `software:research` issue, verify no existing profile or open",
2136
+ " research issue already covers the candidate. Reuse existing",
2137
+ " profiles as cross-references rather than re-queuing research.",
2138
+ "- **Restrain the queue.** Only enqueue downstream research for people",
2139
+ " and products that are genuinely relevant to the framing of this",
2140
+ " profile. Do not open issues for every name or product mentioned in",
2141
+ " passing.",
2142
+ "- **Produce profiles, not requirement or evaluation documents.** Do",
2143
+ " not open `type:requirement` or formal evaluation issues from this",
2144
+ " pipeline. Follow-up research is scoped through `people:research`",
2145
+ " and `software:research` only."
2059
2146
  ].join("\n")
2060
2147
  };
2061
2148
  var profileCompanySkill = {
@@ -2107,15 +2194,18 @@ var profileCompanySkill = {
2107
2194
  "",
2108
2195
  "- A research-notes file under the project's notes directory",
2109
2196
  "- A single company profile under the profiles directory",
2110
- "- Optional follow-up research issues for key people and products",
2111
- " surfaced in the profile",
2112
- "- This pipeline produces **profiles only** \u2014 it does not write person",
2113
- " profiles, product evaluations, or comparative analyses itself."
2197
+ "- `people:research` issues for notable people surfaced in the profile",
2198
+ " (handed off to the `people-profile` bundle)",
2199
+ "- `software:research` issues for software products surfaced in the",
2200
+ " profile (handed off to the `software-profile` bundle)",
2201
+ "- This pipeline produces **company profiles only** \u2014 it does not",
2202
+ " write person profiles, software profiles, product evaluations, or",
2203
+ " comparative analyses itself."
2114
2204
  ].join("\n")
2115
2205
  };
2116
2206
  var companyProfileBundle = {
2117
2207
  name: "company-profile",
2118
- description: "Company research and profiling pipeline: research, draft profile, followup. Enabled by default; domain-neutral; filesystem-durable between phases.",
2208
+ 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.",
2119
2209
  appliesWhen: () => true,
2120
2210
  rules: [
2121
2211
  {
@@ -2132,8 +2222,10 @@ var companyProfileBundle = {
2132
2222
  "`company:followup`. All issues carry `type:company-profile`.",
2133
2223
  "",
2134
2224
  "The pipeline produces **company profiles only**. Deeper research",
2135
- "on people or products surfaced in a profile is delegated to",
2136
- "downstream research pipelines via `company:followup` issues.",
2225
+ "on notable people and software products surfaced while profiling",
2226
+ "is delegated to the `people-profile` and `software-profile`",
2227
+ "bundles via `people:research` and `software:research` issues",
2228
+ "opened during Phase 3 (Followup).",
2137
2229
  "",
2138
2230
  "See the `company-profile-analyst` agent definition for full",
2139
2231
  "workflow details, default paths, the company-type taxonomy, and",
@@ -4447,7 +4539,7 @@ var orchestratorBundle = {
4447
4539
  // src/agent/bundles/people-profile.ts
4448
4540
  var peopleProfileAnalystSubAgent = {
4449
4541
  name: "people-profile-analyst",
4450
- 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. One person per session, tracked by people:* GitHub issue labels.",
4542
+ 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.",
4451
4543
  model: AGENT_MODEL.POWERFUL,
4452
4544
  maxTurns: 80,
4453
4545
  platforms: { cursor: { exclude: true } },
@@ -4497,8 +4589,16 @@ var peopleProfileAnalystSubAgent = {
4497
4589
  "7. **Cross-reference, don't duplicate.** When the profile mentions a",
4498
4590
  " company, software product, or meeting already tracked by the",
4499
4591
  " consuming project, link to the existing artifact rather than",
4500
- " duplicating its content. Do not create downstream research",
4501
- " issues for these cross-references \u2014 only link.",
4592
+ " duplicating its content.",
4593
+ "8. **Follow-up, don't widen scope.** If the session turns up adjacent",
4594
+ " research questions (a significant employer worth profiling, a",
4595
+ " software product the person created or leads), emit a follow-up",
4596
+ " issue rather than expanding the profile beyond its scope.",
4597
+ " Companies are handed off to the `company-profile` bundle via",
4598
+ " `company:research` issues; software products are handed off to",
4599
+ " the `software-profile` bundle via `software:research` issues.",
4600
+ " Meeting notes remain link-only \u2014 this agent never creates",
4601
+ " meeting-research issues.",
4502
4602
  "",
4503
4603
  "---",
4504
4604
  "",
@@ -4526,13 +4626,13 @@ var peopleProfileAnalystSubAgent = {
4526
4626
  "## State Machine Overview",
4527
4627
  "",
4528
4628
  "```",
4529
- "\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\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",
4530
- "\u2502 1. RESEARCH \u2502\u2500\u2500\u2500\u2500\u25B6\u2502 2. DRAFT PROFILE \u2502\u2500\u2500\u2500\u2500\u25B6\u2502 3. FOLLOWUP \u2502",
4531
- "\u2502 Collect public \u2502 \u2502 Write the structured \u2502 \u2502 Cross-link the \u2502",
4532
- "\u2502 sources into a \u2502 \u2502 markdown profile to \u2502 \u2502 profile to existing\u2502",
4533
- "\u2502 bounded notes \u2502 \u2502 the configured path \u2502 \u2502 companies, software\u2502",
4534
- "\u2502 file \u2502 \u2502 \u2502 \u2502 and meeting notes \u2502",
4535
- "\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",
4629
+ "\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\u2500\u2500\u2500\u2510 \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510",
4630
+ "\u2502 1. RESEARCH \u2502\u2500\u2500\u2500\u2500\u25B6\u2502 2. DRAFT PROFILE \u2502\u2500\u2500\u2500\u2500\u25B6\u2502 3. FOLLOWUP \u2502",
4631
+ "\u2502 Collect public \u2502 \u2502 Write the structured \u2502 \u2502 Cross-link existing\u2502",
4632
+ "\u2502 sources into a \u2502 \u2502 markdown profile to \u2502 \u2502 artifacts; enqueue \u2502",
4633
+ "\u2502 bounded notes \u2502 \u2502 the configured path \u2502 \u2502 company/software \u2502",
4634
+ "\u2502 file \u2502 \u2502 \u2502 \u2502 research issues \u2502",
4635
+ "\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",
4536
4636
  "```",
4537
4637
  "",
4538
4638
  "**Issue labels encode the phase:**",
@@ -4541,19 +4641,21 @@ var peopleProfileAnalystSubAgent = {
4541
4641
  "|-------|-------|-------------|",
4542
4642
  "| `people:research` | 1. Research | Gather public sources. Write a bounded research-notes file. Create the draft issue. |",
4543
4643
  "| `people:draft` | 2. Draft | Read the research notes. Write the structured profile to `<PROFILES_DIR>`. Create the followup issue if warranted. |",
4544
- "| `people:followup` | 3. Followup | Read the profile. Update cross-references to existing companies, software, and meeting notes. No new downstream issues. |",
4644
+ "| `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. |",
4545
4645
  "",
4546
4646
  "All issues also carry `type:people-profile` and a `status:*` label.",
4547
4647
  "",
4548
4648
  "**Issue count per person cycle:** 1 research + 1 draft + 0\u20131 followup =",
4549
4649
  "**2\u20133 sessions**. The followup phase is skipped when the profile did",
4550
- "not surface any cross-references worth linking.",
4650
+ "not surface any cross-references worth linking and no companies or",
4651
+ "software products warrant downstream research.",
4551
4652
  "",
4552
4653
  "**Shortened paths:**",
4553
4654
  "- Research phase determines the person is out of scope (not",
4554
4655
  " relevant, insufficient public material) \u2192 research issue closes",
4555
4656
  " with a justification and no downstream issues are created \u2192 **1 session**.",
4556
- "- Short profile with no cross-references needed \u2192 **2 sessions**.",
4657
+ "- Short profile with no cross-references and no downstream",
4658
+ " candidates \u2192 **2 sessions**.",
4557
4659
  "",
4558
4660
  "---",
4559
4661
  "",
@@ -4569,8 +4671,8 @@ var peopleProfileAnalystSubAgent = {
4569
4671
  "| `<PROFILES_DIR>` | Final person profile files | `<PEOPLE_ROOT>/profiles/` |",
4570
4672
  "| `<NOTES_DIR>` | Research-notes files from Phase 1 | `<PEOPLE_ROOT>/notes/` |",
4571
4673
  "| `<PERSON_SLUG>` | Short kebab-case slug identifying the person | derived from the person's name |",
4572
- "| `<COMPANIES_DIR>` | Where existing company profiles live (for cross-references) | `docs/companies/profiles/` |",
4573
- "| `<SOFTWARE_DIR>` | Where existing software profiles live (for cross-references) | `docs/software/profiles/` |",
4674
+ "| `<COMPANIES_DIR>` | Where existing company profiles live (for cross-references and duplicate detection during followup) | `docs/companies/profiles/` |",
4675
+ "| `<SOFTWARE_DIR>` | Where existing software profiles live (for cross-references and duplicate detection during followup) | `docs/software/profiles/` |",
4574
4676
  "| `<MEETINGS_DIR>` | Where meeting notes live (for cross-references) | `docs/meetings/` |",
4575
4677
  "",
4576
4678
  "If `docs/project-context.md` specifies a different people-research",
@@ -4784,11 +4886,13 @@ var peopleProfileAnalystSubAgent = {
4784
4886
  " ```",
4785
4887
  "",
4786
4888
  "4. **Decide whether a followup issue is warranted.** Create a",
4787
- " `people:followup` issue (depending on this draft issue) only if",
4788
- " the profile's Candidate Cross-References lists at least one",
4789
- " company, software product, or meeting already tracked by the",
4790
- " consuming project. Otherwise, note in the draft issue's closing",
4791
- " comment that no followup is needed.",
4889
+ " `people:followup` issue (depending on this draft issue) if the",
4890
+ " profile's Candidate Cross-References lists at least one company,",
4891
+ " software product, or meeting \u2014 whether or not the entity is",
4892
+ " already profiled. The followup phase links what exists and",
4893
+ " enqueues downstream research for what doesn't. Only skip the",
4894
+ " followup when the profile surfaced no cross-reference candidates",
4895
+ " at all; note this in the draft issue's closing comment.",
4792
4896
  "",
4793
4897
  "5. **Commit and push** the profile file. Close the draft issue.",
4794
4898
  "",
@@ -4798,11 +4902,17 @@ var peopleProfileAnalystSubAgent = {
4798
4902
  "",
4799
4903
  "**Goal:** Populate the profile's `## Cross-References` section with",
4800
4904
  "links to existing artifacts \u2014 companies, software, meetings \u2014 that",
4801
- "the consuming project already tracks.",
4802
- "",
4803
- "**Budget:** No new web searches. No new downstream research issues.",
4804
- "Read the candidate cross-references, resolve them against the",
4805
- "configured directories, update the profile.",
4905
+ "the consuming project already tracks, **and** enqueue downstream",
4906
+ "`company:research` and `software:research` issues for unprofiled,",
4907
+ "genuinely-relevant companies and software products surfaced in the",
4908
+ "profile. Hand the candidates off to the `company-profile` and",
4909
+ "`software-profile` bundles so they can be researched independently.",
4910
+ "",
4911
+ "**Budget:** No new web searches. Read the candidate cross-references,",
4912
+ "resolve them against the configured directories, update the profile,",
4913
+ "and enqueue downstream research issues where warranted. Markdown",
4914
+ "cross-references in the profile are preserved \u2014 issue creation is",
4915
+ "**additive** on top of the existing cross-reference behavior.",
4806
4916
  "",
4807
4917
  "### Steps",
4808
4918
  "",
@@ -4811,24 +4921,108 @@ var peopleProfileAnalystSubAgent = {
4811
4921
  "2. **Resolve company cross-references.** For each company named in",
4812
4922
  " the profile's research notes or body text, look for a matching",
4813
4923
  " file under `<COMPANIES_DIR>/`. If found, link it under",
4814
- " `## Cross-References > Companies`. If not found, leave a TODO",
4815
- " comment naming the company \u2014 the invoking project's team decides",
4816
- " whether to kick off a separate company-profile pipeline.",
4924
+ " `## Cross-References > Companies` and do **not** open a",
4925
+ " `company:research` issue for it \u2014 the profile already exists.",
4817
4926
  "",
4818
4927
  "3. **Resolve software cross-references.** Same pattern against",
4819
- " `<SOFTWARE_DIR>/`. Link what matches; leave TODOs for what",
4820
- " doesn't.",
4928
+ " `<SOFTWARE_DIR>/`. If found, link under `## Cross-References >",
4929
+ " Software` and do **not** open a `software:research` issue.",
4821
4930
  "",
4822
4931
  "4. **Resolve meeting cross-references.** For meetings the person",
4823
4932
  " participated in, look for a matching file under `<MEETINGS_DIR>/`",
4824
- " by date or slug. Link matches; leave TODOs otherwise.",
4825
- "",
4826
- "5. **Do not open downstream issues.** This pipeline emits no",
4827
- " `company:research`, `research:scope`, or similar issues. Cross-",
4828
- " references are link-only; downstream research is a separate",
4829
- " human decision.",
4830
- "",
4831
- "6. **Commit and push** the updated profile. Close the followup issue.",
4933
+ " by date or slug. Link matches; leave TODOs otherwise. Meeting",
4934
+ " notes are **always link-only** \u2014 this agent never opens",
4935
+ " meeting-research issues.",
4936
+ "",
4937
+ "5. **Enqueue a `company:research` issue per unprofiled, genuinely-",
4938
+ " relevant company.** For each company named in the profile that",
4939
+ " has no matching file under `<COMPANIES_DIR>/`, decide whether it",
4940
+ " warrants a downstream company profile (see restraint guidance",
4941
+ " below). If so, open an issue carrying:",
4942
+ "",
4943
+ " - `type:company-profile`",
4944
+ " - `company:research`",
4945
+ " - `priority:medium`",
4946
+ " - `status:ready`",
4947
+ "",
4948
+ " The issue body must include:",
4949
+ " - A **discovery source** line naming this person profile",
4950
+ " (`Discovered while profiling: <person name>`)",
4951
+ " - A link to the person profile path (`Person profile: <PROFILES_DIR>/<PERSON_SLUG>.md`)",
4952
+ " - Enough identifying metadata \u2014 company name and primary domain/",
4953
+ " website \u2014 that the `company-profile-analyst` agent can begin",
4954
+ " research without revisiting this person profile",
4955
+ "",
4956
+ "6. **Enqueue a `software:research` issue per unprofiled software",
4957
+ " product the person has primary attribution for.** For each",
4958
+ " software product named in the profile with no matching file under",
4959
+ " `<SOFTWARE_DIR>/`, decide whether it warrants a downstream",
4960
+ " software profile (see restraint guidance below). If so, open an",
4961
+ " issue carrying:",
4962
+ "",
4963
+ " - `type:software-profile`",
4964
+ " - `software:research`",
4965
+ " - `priority:medium`",
4966
+ " - `status:ready`",
4967
+ "",
4968
+ " The issue body must include:",
4969
+ " - A **discovery source** line naming this person profile",
4970
+ " (`Discovered while profiling: <person name>`)",
4971
+ " - A link to the person profile path (`Person profile: <PROFILES_DIR>/<PERSON_SLUG>.md`)",
4972
+ " - Enough identifying metadata \u2014 product name and vendor (the",
4973
+ " company that builds or maintains the product) \u2014 that the",
4974
+ " `software-profile-analyst` agent can begin research without",
4975
+ " revisiting this person profile",
4976
+ "",
4977
+ "7. **Avoid duplicates.** Before opening a `company:research` or",
4978
+ " `software:research` issue, verify no existing profile or open",
4979
+ " research issue already covers the candidate:",
4980
+ "",
4981
+ " - Companies: check `<COMPANIES_DIR>/` for a matching profile",
4982
+ " file (by derived slug or by searching the directory for the",
4983
+ " company's name). If a profile exists, reuse it as a cross-",
4984
+ " reference only \u2014 **do not** open a new `company:research` issue.",
4985
+ " - Software: check `<SOFTWARE_DIR>/` the same way. If a profile",
4986
+ " exists, reuse it as a cross-reference only \u2014 **do not** open a",
4987
+ " new `software:research` issue.",
4988
+ " - Also scan open issues carrying the matching `company:research`",
4989
+ " or `software:research` label so this phase never re-opens",
4990
+ " research that is already queued.",
4991
+ "",
4992
+ "8. **Exercise restraint.** Only create downstream issues for",
4993
+ " entities **genuinely relevant** to the person's professional",
4994
+ " identity:",
4995
+ "",
4996
+ " - **Companies:** open an issue for the person's current",
4997
+ " employer, significant past employers (roles of real tenure or",
4998
+ " leadership influence), companies where they sit on the board",
4999
+ " or act as an advisor, and companies they co-founded. Do **not**",
5000
+ " open an issue for every company on their LinkedIn, short",
5001
+ " consulting engagements, or employers tangential to the framing",
5002
+ " of this profile.",
5003
+ " - **Software:** open an issue only for products where the person",
5004
+ " has **primary attribution** \u2014 creator, maintainer, lead PM,",
5005
+ " founding engineer, or otherwise materially influenced the",
5006
+ " product. Do **not** open an issue for software the person",
5007
+ " merely uses, endorses in passing, or lists in a stack. When",
5008
+ " in doubt, leave the candidate as a markdown cross-reference",
5009
+ " and skip the downstream issue.",
5010
+ "",
5011
+ "9. **Assume the peers are present.** This pipeline assumes the",
5012
+ " `company-profile` and `software-profile` bundles are enabled in",
5013
+ " the consuming project. If a consuming project has disabled one",
5014
+ " of them, flag the followup issue with `status:needs-attention`",
5015
+ " and list the candidates that could not be routed \u2014 never invent",
5016
+ " an alternative label taxonomy.",
5017
+ "",
5018
+ "10. **Cross-link** \u2014 update the profile's `## Cross-References`",
5019
+ " section so each company or software entry references either",
5020
+ " the linked profile path (for existing profiles) or the newly-",
5021
+ " created downstream issue number (for candidates that were",
5022
+ " enqueued for research).",
5023
+ "",
5024
+ "11. **Commit and push** the updated profile. Close the followup",
5025
+ " issue.",
4832
5026
  "",
4833
5027
  "---",
4834
5028
  "",
@@ -4839,12 +5033,22 @@ var peopleProfileAnalystSubAgent = {
4839
5033
  "- `<NOTES_DIR>/` \u2014 research-notes files (Phase 1)",
4840
5034
  "- `<PROFILES_DIR>/` \u2014 person profiles (Phase 2, updated in Phase 3)",
4841
5035
  "",
4842
- "The pipeline produces **profiles and notes only**. It does not",
4843
- "create new companies, software evaluations, meeting notes, or any",
4844
- "other downstream artifacts \u2014 it only links to those that already",
4845
- "exist under the configured cross-reference directories. Keep this",
4846
- "boundary clean so the people-profile pipeline stays generic and",
4847
- "cheap to run.",
5036
+ "In Phase 3, this agent also **creates `company:research` and",
5037
+ "`software:research` issues** for companies and software products",
5038
+ "surfaced in the profile that are not already tracked under",
5039
+ "`<COMPANIES_DIR>/` or `<SOFTWARE_DIR>/`. It never writes the",
5040
+ "downstream profiles themselves \u2014 those are the responsibility of the",
5041
+ "`company-profile-analyst` and `software-profile-analyst` agents,",
5042
+ "which pick up the issues this pipeline creates. Meeting notes",
5043
+ "remain link-only across all phases.",
5044
+ "",
5045
+ "The pipeline produces **person profiles and notes only**. Deeper",
5046
+ "research on companies and software products is delegated to",
5047
+ "downstream research pipelines via `company:research` and",
5048
+ "`software:research` issues \u2014 this agent never writes company",
5049
+ "profiles, software profiles, product evaluations, or comparative",
5050
+ "analyses itself. Keep this boundary clean so the people-profile",
5051
+ "pipeline stays generic.",
4848
5052
  "",
4849
5053
  "---",
4850
5054
  "",
@@ -4860,15 +5064,35 @@ var peopleProfileAnalystSubAgent = {
4860
5064
  " encountered in a public source.",
4861
5065
  "- **Cross-reference, don't duplicate.** Link to existing company,",
4862
5066
  " software, and meeting artifacts rather than re-describing them.",
4863
- "- **No downstream issue creation.** Phase 3 emits no new research,",
4864
- " profile, or requirement issues. Only link.",
5067
+ "- **Delegate, don't duplicate.** Unprofiled companies and software",
5068
+ " products surfaced during profiling are handed off to the",
5069
+ " `company-profile` and `software-profile` bundles via",
5070
+ " `company:research` and `software:research` issues in Phase 3 \u2014",
5071
+ " never inlined as company or software profiles in this pipeline.",
5072
+ "- **Check before enqueueing.** Before opening a `company:research`",
5073
+ " or `software:research` issue, verify no existing profile or open",
5074
+ " research issue already covers the candidate. Reuse existing",
5075
+ " profiles as cross-references rather than re-queuing research.",
5076
+ "- **Restrain the queue.** Only enqueue downstream research for",
5077
+ " companies that are a current employer, significant past employer,",
5078
+ " board/advisor role, or co-founded venture \u2014 not every company on",
5079
+ " the person's r\xE9sum\xE9. Only enqueue software research for products",
5080
+ " the person has **primary attribution** for (creator, maintainer,",
5081
+ " lead PM), not products they merely use.",
5082
+ "- **Meetings stay link-only.** Phase 3 never opens meeting-research",
5083
+ " or any other meeting-related issues. Meetings are cross-",
5084
+ " referenced only.",
5085
+ "- **Produce profiles, not requirement or evaluation documents.** Do",
5086
+ " not open `type:requirement` or formal evaluation issues from this",
5087
+ " pipeline. Follow-up research is scoped through `company:research`",
5088
+ " and `software:research` only.",
4865
5089
  "- **Refresh, don't fork.** When a profile exists and is past its",
4866
5090
  " cadence, update in place rather than creating a new slug."
4867
5091
  ].join("\n")
4868
5092
  };
4869
5093
  var profilePersonSkill = {
4870
5094
  name: "profile-person",
4871
- description: "Kick off a people-profile pipeline. Creates a people:research issue for the given person and dispatches Phase 1 (Research) in the people-profile-analyst agent.",
5095
+ description: "Kick off a people-profile pipeline. Creates a people:research issue for the given person and dispatches Phase 1 (Research) in the people-profile-analyst agent. Phase 3 (Followup) enqueues downstream `company:research` and `software:research` issues for unprofiled, genuinely-relevant entities surfaced in the profile.",
4872
5096
  disableModelInvocation: true,
4873
5097
  userInvocable: true,
4874
5098
  context: "fork",
@@ -4930,13 +5154,19 @@ var profilePersonSkill = {
4930
5154
  "- A single person profile under the profiles directory",
4931
5155
  "- Cross-references to existing companies, software, and meetings",
4932
5156
  " tracked elsewhere in the project",
4933
- "- This pipeline produces **profiles only** \u2014 it does not create",
4934
- " companies, software, meetings, or any other downstream artifacts."
5157
+ "- `company:research` issues for unprofiled companies surfaced in",
5158
+ " the profile (handed off to the `company-profile` bundle)",
5159
+ "- `software:research` issues for software products the person has",
5160
+ " primary attribution for (handed off to the `software-profile`",
5161
+ " bundle)",
5162
+ "- This pipeline produces **person profiles only** \u2014 it does not",
5163
+ " write company profiles, software profiles, meeting notes, or any",
5164
+ " other downstream artifacts itself."
4935
5165
  ].join("\n")
4936
5166
  };
4937
5167
  var peopleProfileBundle = {
4938
5168
  name: "people-profile",
4939
- 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 without creating new downstream issues.",
5169
+ 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.",
4940
5170
  appliesWhen: () => true,
4941
5171
  rules: [
4942
5172
  {
@@ -4952,10 +5182,12 @@ var peopleProfileBundle = {
4952
5182
  "GitHub issue labeled `people:research`, `people:draft`, or",
4953
5183
  "`people:followup`. All issues carry `type:people-profile`.",
4954
5184
  "",
4955
- "The pipeline produces **person profiles only**. Cross-references",
4956
- "to companies, software products, and meeting notes are link-only",
4957
- "\u2014 the followup phase never creates new downstream research,",
4958
- "profile, or requirement issues.",
5185
+ "The pipeline produces **person profiles only**. Deeper research",
5186
+ "on companies and software products surfaced while profiling is",
5187
+ "delegated to the `company-profile` and `software-profile`",
5188
+ "bundles via `company:research` and `software:research` issues",
5189
+ "opened during Phase 3 (Followup). Meeting notes remain link-",
5190
+ "only \u2014 the pipeline never creates meeting-research issues.",
4959
5191
  "",
4960
5192
  "See the `people-profile-analyst` agent definition for full",
4961
5193
  "workflow details, default paths, the person-role taxonomy, the",
@@ -4988,7 +5220,7 @@ var peopleProfileBundle = {
4988
5220
  {
4989
5221
  name: "people:followup",
4990
5222
  color: "D4C5F9",
4991
- description: "Phase 3: cross-link the profile to existing companies, software, and meeting notes"
5223
+ 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"
4992
5224
  }
4993
5225
  ]
4994
5226
  };