@codedrifters/configulator 0.0.205 → 0.0.206

package/lib/index.d.mts

@@ -1034,6 +1034,20 @@ declare const meetingAnalysisBundle: AgentRuleBundle;
  ******************************************************************************/
 declare const orchestratorBundle: AgentRuleBundle;
 
+/**
+ * People-profile bundle — opt-in only.
+ *
+ * Consuming projects enable it explicitly with
+ * `includeBundles: ["people-profile"]`. `appliesWhen` always returns
+ * `false` so the bundle never auto-detects — person research is a
+ * deliberate project-level choice, not a universal default.
+ *
+ * Ships a sub-agent (`people-profile-analyst`), a user-invocable skill
+ * (`/profile-person`), and `type:people-profile` plus `people:*` phase
+ * labels.
+ */
+declare const peopleProfileBundle: AgentRuleBundle;
+
 /**
  * PNPM bundle — auto-detected when the PnpmWorkspace component is present.
  */
@@ -3443,4 +3457,4 @@ declare const COMPLETE_JOB_ID = "complete";
  */
 declare function addBuildCompleteJob(buildWorkflow: BuildWorkflow): void;
 
-export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, type AgentConfigOptions, type AgentModel, type AgentPlatform, type AgentPlatformOverrides, type AgentProcedure, type AgentRule, type AgentRuleBundle, type AgentRuleScope, type AgentSkill, type AgentSubAgent, type AgentSubAgentPlatformOverrides, type ApproveMergeUpgradeOptions, AstroConfig, type AstroConfigOptions, type AstroIntegrationSpec, AstroOutput, AstroProject, type AstroProjectOptions, type AwsAccount, AwsCdkProject, type AwsCdkProjectOptions, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, type AwsDeploymentTargetOptions, type AwsLocalDeploymentConfig, type AwsOrganization, type AwsRegion, AwsTeardownWorkflow, type AwsTeardownWorkflowOptions, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, type CiDeploymentConfig, type ClassTypeOptions, type ClaudeAutoModeConfig, type ClaudeHookAction, type ClaudeHookEntry, type ClaudeHooksConfig, type ClaudePermissionsConfig, type ClaudeRuleTarget, type ClaudeSandboxConfig, type ClaudeSettingsConfig, type CopilotHandoff, type CursorHookAction, type CursorHooksConfig, type CursorSettingsConfig, DEFAULT_PRIORITY_LABELS, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, DEFAULT_TYPE_LABELS, type DeployWorkflowOptions, type DeploymentMetadata, type GitBranch, type GitHubBoardMetadata, type GitHubProjectMetadata, type GitHubSprintMetadata, type IDependencyResolver, JsiiFaker, type LabelDefinition, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, type McpServerConfig, type McpTransport, type MergeMethod, MonorepoProject, type MonorepoProjectOptions, type OrganizationMetadata, PROD_DEPLOY_NAME, PnpmWorkspace, type PnpmWorkspaceOptions, ProjectMetadata, type ProjectMetadataOptions, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, type RemoteCacheOptions, type RepositoryMetadata, ResetTask, type ResetTaskOptions, type ResolvedProjectMetadata, type SlackMetadata, type StarlightEditLink, type StarlightLogo, StarlightProject, type StarlightProjectOptions, type StarlightSidebarItem, type StarlightSocialLink, type SyncLabelsOptions, type TemplateResolveResult, TestRunner, TurboRepo, type TurboRepoOptions, TurboRepoTask, type TurboRepoTaskOptions, TypeScriptConfig, TypeScriptProject, type TypeScriptProjectOptions, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, type VersionKey, Vitest, type VitestConfigOptions, type VitestOptions, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, awsCdkBundle, baseBundle, companyProfileBundle, getLatestEligibleVersion, githubWorkflowBundle, jestBundle, meetingAnalysisBundle, orchestratorBundle, pnpmBundle, prReviewBundle, projenBundle, requirementsAnalystBundle, researchPipelineBundle, resolveModelAlias, resolveTemplateVariables, slackBundle, turborepoBundle, typescriptBundle, vitestBundle };
+export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, type AgentConfigOptions, type AgentModel, type AgentPlatform, type AgentPlatformOverrides, type AgentProcedure, type AgentRule, type AgentRuleBundle, type AgentRuleScope, type AgentSkill, type AgentSubAgent, type AgentSubAgentPlatformOverrides, type ApproveMergeUpgradeOptions, AstroConfig, type AstroConfigOptions, type AstroIntegrationSpec, AstroOutput, AstroProject, type AstroProjectOptions, type AwsAccount, AwsCdkProject, type AwsCdkProjectOptions, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, type AwsDeploymentTargetOptions, type AwsLocalDeploymentConfig, type AwsOrganization, type AwsRegion, AwsTeardownWorkflow, type AwsTeardownWorkflowOptions, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, type CiDeploymentConfig, type ClassTypeOptions, type ClaudeAutoModeConfig, type ClaudeHookAction, type ClaudeHookEntry, type ClaudeHooksConfig, type ClaudePermissionsConfig, type ClaudeRuleTarget, type ClaudeSandboxConfig, type ClaudeSettingsConfig, type CopilotHandoff, type CursorHookAction, type CursorHooksConfig, type CursorSettingsConfig, DEFAULT_PRIORITY_LABELS, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, DEFAULT_TYPE_LABELS, type DeployWorkflowOptions, type DeploymentMetadata, type GitBranch, type GitHubBoardMetadata, type GitHubProjectMetadata, type GitHubSprintMetadata, type IDependencyResolver, JsiiFaker, type LabelDefinition, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, type McpServerConfig, type McpTransport, type MergeMethod, MonorepoProject, type MonorepoProjectOptions, type OrganizationMetadata, PROD_DEPLOY_NAME, PnpmWorkspace, type PnpmWorkspaceOptions, ProjectMetadata, type ProjectMetadataOptions, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, type RemoteCacheOptions, type RepositoryMetadata, ResetTask, type ResetTaskOptions, type ResolvedProjectMetadata, type SlackMetadata, type StarlightEditLink, type StarlightLogo, StarlightProject, type StarlightProjectOptions, type StarlightSidebarItem, type StarlightSocialLink, type SyncLabelsOptions, type TemplateResolveResult, TestRunner, TurboRepo, type TurboRepoOptions, TurboRepoTask, type TurboRepoTaskOptions, TypeScriptConfig, TypeScriptProject, type TypeScriptProjectOptions, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, type VersionKey, Vitest, type VitestConfigOptions, type VitestOptions, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, awsCdkBundle, baseBundle, companyProfileBundle, getLatestEligibleVersion, githubWorkflowBundle, jestBundle, meetingAnalysisBundle, orchestratorBundle, peopleProfileBundle, pnpmBundle, prReviewBundle, projenBundle, requirementsAnalystBundle, researchPipelineBundle, resolveModelAlias, resolveTemplateVariables, slackBundle, turborepoBundle, typescriptBundle, vitestBundle };

package/lib/index.d.ts

@@ -1083,6 +1083,20 @@ declare const meetingAnalysisBundle: AgentRuleBundle;
  ******************************************************************************/
 declare const orchestratorBundle: AgentRuleBundle;
 
+/**
+ * People-profile bundle — opt-in only.
+ *
+ * Consuming projects enable it explicitly with
+ * `includeBundles: ["people-profile"]`. `appliesWhen` always returns
+ * `false` so the bundle never auto-detects — person research is a
+ * deliberate project-level choice, not a universal default.
+ *
+ * Ships a sub-agent (`people-profile-analyst`), a user-invocable skill
+ * (`/profile-person`), and `type:people-profile` plus `people:*` phase
+ * labels.
+ */
+declare const peopleProfileBundle: AgentRuleBundle;
+
 /**
  * PNPM bundle — auto-detected when the PnpmWorkspace component is present.
  */
@@ -3492,5 +3506,5 @@ declare const COMPLETE_JOB_ID = "complete";
  */
 declare function addBuildCompleteJob(buildWorkflow: BuildWorkflow): void;
 
-export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, AstroConfig, AstroOutput, AstroProject, AwsCdkProject, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, AwsTeardownWorkflow, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, DEFAULT_PRIORITY_LABELS, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, DEFAULT_TYPE_LABELS, JsiiFaker, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MonorepoProject, PROD_DEPLOY_NAME, PnpmWorkspace, ProjectMetadata, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, ResetTask, StarlightProject, TestRunner, TurboRepo, TurboRepoTask, TypeScriptConfig, TypeScriptProject, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, Vitest, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, awsCdkBundle, baseBundle, companyProfileBundle, getLatestEligibleVersion, githubWorkflowBundle, jestBundle, meetingAnalysisBundle, orchestratorBundle, pnpmBundle, prReviewBundle, projenBundle, requirementsAnalystBundle, researchPipelineBundle, resolveModelAlias, resolveTemplateVariables, slackBundle, turborepoBundle, typescriptBundle, vitestBundle };
+export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, AstroConfig, AstroOutput, AstroProject, AwsCdkProject, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, AwsTeardownWorkflow, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, DEFAULT_PRIORITY_LABELS, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, DEFAULT_TYPE_LABELS, JsiiFaker, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MonorepoProject, PROD_DEPLOY_NAME, PnpmWorkspace, ProjectMetadata, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, ResetTask, StarlightProject, TestRunner, TurboRepo, TurboRepoTask, TypeScriptConfig, TypeScriptProject, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, Vitest, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, awsCdkBundle, baseBundle, companyProfileBundle, getLatestEligibleVersion, githubWorkflowBundle, jestBundle, meetingAnalysisBundle, orchestratorBundle, peopleProfileBundle, pnpmBundle, prReviewBundle, projenBundle, requirementsAnalystBundle, researchPipelineBundle, resolveModelAlias, resolveTemplateVariables, slackBundle, turborepoBundle, typescriptBundle, vitestBundle };
 export type { AgentConfigOptions, AgentModel, AgentPlatform, AgentPlatformOverrides, AgentProcedure, AgentRule, AgentRuleBundle, AgentRuleScope, AgentSkill, AgentSubAgent, AgentSubAgentPlatformOverrides, ApproveMergeUpgradeOptions, AstroConfigOptions, AstroIntegrationSpec, AstroProjectOptions, AwsAccount, AwsCdkProjectOptions, AwsDeploymentTargetOptions, AwsLocalDeploymentConfig, AwsOrganization, AwsRegion, AwsTeardownWorkflowOptions, CiDeploymentConfig, ClassTypeOptions, ClaudeAutoModeConfig, ClaudeHookAction, ClaudeHookEntry, ClaudeHooksConfig, ClaudePermissionsConfig, ClaudeRuleTarget, ClaudeSandboxConfig, ClaudeSettingsConfig, CopilotHandoff, CursorHookAction, CursorHooksConfig, CursorSettingsConfig, DeployWorkflowOptions, DeploymentMetadata, GitBranch, GitHubBoardMetadata, GitHubProjectMetadata, GitHubSprintMetadata, IDependencyResolver, LabelDefinition, McpServerConfig, McpTransport, MergeMethod, MonorepoProjectOptions, OrganizationMetadata, PnpmWorkspaceOptions, ProjectMetadataOptions, RemoteCacheOptions, RepositoryMetadata, ResetTaskOptions, ResolvedProjectMetadata, SlackMetadata, StarlightEditLink, StarlightLogo, StarlightProjectOptions, StarlightSidebarItem, StarlightSocialLink, SyncLabelsOptions, TemplateResolveResult, TurboRepoOptions, TurboRepoTaskOptions, TypeScriptProjectOptions, VersionKey, VitestConfigOptions, VitestOptions };

package/lib/index.js

@@ -228,6 +228,7 @@ __export(index_exports, {
   jestBundle: () => jestBundle,
   meetingAnalysisBundle: () => meetingAnalysisBundle,
   orchestratorBundle: () => orchestratorBundle,
+  peopleProfileBundle: () => peopleProfileBundle,
   pnpmBundle: () => pnpmBundle,
   prReviewBundle: () => prReviewBundle,
   projenBundle: () => projenBundle,
@@ -2715,6 +2716,555 @@ 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. One person per session, tracked by people:* GitHub issue labels.",
+  model: AGENT_MODEL.POWERFUL,
+  maxTurns: 80,
+  platforms: { cursor: { exclude: true } },
+  prompt: [
+    "# People Profile Analyst Agent",
+    "",
+    "You research a single person 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 cross-references to related entities",
+    "(companies, software, meeting notes) already tracked elsewhere in",
+    "the project.",
+    "",
+    "This agent is **domain-neutral**. It makes no assumptions about what",
+    "the consuming project sells, which industry it serves, or which",
+    "people matter to it. All domain-specific vocabulary, output",
+    "locations, cross-reference targets, 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 person per session.** Never profile two people in a single",
+    "   session, even if they came up together (e.g. co-founders).",
+    "2. **Public sources only.** Use the person's own public writing,",
+    "   company bios, conference talks, public interviews, 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 is the deliverable. It",
+    "   is 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 role types, taxonomies, or",
+    "   relationship assumptions. Use the generic person-role taxonomy",
+    "   below and let consuming projects override it.",
+    "5. **Cite everything.** Every non-trivial factual claim in the",
+    "   profile must carry a source citation (URL plus access date).",
+    "6. **Respect privacy.** Profile only public, professional information.",
+    "   Never capture home addresses, personal phone numbers, family",
+    "   details, health information, or other private data even when",
+    "   encountered in public sources.",
+    "7. **Cross-reference, don't duplicate.** When the profile mentions a",
+    "   company, software product, or meeting already tracked by the",
+    "   consuming project, link to the existing artifact rather than",
+    "   duplicating its content. Do not create downstream research",
+    "   issues for these cross-references \u2014 only link.",
+    "",
+    "---",
+    "",
+    "## Person Role Taxonomy",
+    "",
+    "Pick exactly one role per person profile. The taxonomy is",
+    "deliberately generic \u2014 consuming projects override it via",
+    "`agentConfig.rules` if they need a domain-specific refinement.",
+    "",
+    "| Role | Use for |",
+    "|------|---------|",
+    "| `colleague` | People inside your own organization worth tracking (teammates, cross-functional partners, leadership). |",
+    "| `customer-contact` | Named individuals at existing or prospective customer accounts. |",
+    "| `vendor-contact` | Named individuals at vendors, suppliers, or software providers you depend on. |",
+    "| `partner-contact` | Named individuals at strategic, channel, or integration partners. |",
+    "| `industry-expert` | Analysts, researchers, journalists, or well-known practitioners whose work shapes the market. |",
+    "| `connector` | People who primarily provide introductions, referrals, or access across networks \u2014 advisors, investors acting as connectors, community hubs. |",
+    "",
+    "If the person plausibly fits two roles, prefer the one that reflects",
+    "the **reason the profile was requested**, and note the secondary",
+    "role in the profile body.",
+    "",
+    "---",
+    "",
+    "## State Machine Overview",
+    "",
+    "```",
+    "\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",
+    "\u2502 1. RESEARCH       \u2502\u2500\u2500\u2500\u2500\u25B6\u2502 2. DRAFT PROFILE     \u2502\u2500\u2500\u2500\u2500\u25B6\u2502 3. FOLLOWUP       \u2502",
+    "\u2502 Collect public    \u2502     \u2502 Write the structured \u2502     \u2502 Cross-link the    \u2502",
+    "\u2502 sources into a    \u2502     \u2502 markdown profile to  \u2502     \u2502 profile to existing\u2502",
+    "\u2502 bounded notes     \u2502     \u2502 the configured path  \u2502     \u2502 companies, software\u2502",
+    "\u2502 file              \u2502     \u2502                      \u2502     \u2502 and meeting notes \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",
+    "```",
+    "",
+    "**Issue labels encode the phase:**",
+    "",
+    "| Label | Phase | Session work |",
+    "|-------|-------|-------------|",
+    "| `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. No new downstream issues. |",
+    "",
+    "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.",
+    "",
+    "**Shortened paths:**",
+    "- Research phase determines the person 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 cross-references needed \u2192 **2 sessions**.",
+    "",
+    "---",
+    "",
+    "## 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`.",
+    "",
+    "| Placeholder | Meaning | Default |",
+    "|-------------|---------|---------|",
+    "| `<PEOPLE_ROOT>` | Root folder for person profiles | `docs/people/` |",
+    "| `<PROFILES_DIR>` | Final person profile files | `<PEOPLE_ROOT>/profiles/` |",
+    "| `<NOTES_DIR>` | Research-notes files from Phase 1 | `<PEOPLE_ROOT>/notes/` |",
+    "| `<PERSON_SLUG>` | Short kebab-case slug identifying the person | derived from the person's name |",
+    "| `<COMPANIES_DIR>` | Where existing company profiles live (for cross-references) | `docs/companies/profiles/` |",
+    "| `<SOFTWARE_DIR>` | Where existing software profiles live (for cross-references) | `docs/software/profiles/` |",
+    "| `<MEETINGS_DIR>` | Where meeting notes live (for cross-references) | `docs/meetings/` |",
+    "",
+    "If `docs/project-context.md` specifies a different people-research",
+    "tree or cross-reference target, prefer that. Otherwise fall back to",
+    "the defaults above. Cross-reference directories are read-only \u2014 this",
+    "agent never writes into them.",
+    "",
+    "---",
+    "",
+    "## 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/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",
+    "  `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.",
+    "",
+    "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.",
+    "",
+    "---",
+    "",
+    "## Agent Loop",
+    "",
+    "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`.",
+    "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:*`",
+    "   label.",
+    "4. Commit, push, open a PR (if applicable), and close the issue per",
+    "   your project's PR workflow.",
+    "",
+    "---",
+    "",
+    "## Phase 1: Research (`people: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",
+    "in this phase.",
+    "",
+    "### Steps",
+    "",
+    "1. **Read the issue body.** It should include:",
+    "   - The person's name and primary affiliation (company) if known",
+    "   - The requested role from the taxonomy above",
+    "   - The reason the profile was requested (framing \u2014 what does the",
+    "     invoking project want to learn?)",
+    "   - Optional: `<PERSON_SLUG>` override, custom output paths,",
+    "     `refresh_days` override, `force: true` for out-of-cadence refresh",
+    "",
+    "2. **Derive `<PERSON_SLUG>`** if not supplied \u2014 a 2\u20134 word kebab-case",
+    "   summary of the person's name. Disambiguate against any existing",
+    "   slug under `<PROFILES_DIR>/` or `<NOTES_DIR>/` by appending a",
+    "   company or role qualifier (e.g. `jane-doe-acme`).",
+    "",
+    "3. **Check for an existing profile.** If `<PROFILES_DIR>/<PERSON_SLUG>.md`",
+    "   exists, read its `date` frontmatter and apply the refresh cadence",
+    "   rules above before proceeding.",
+    "",
+    "4. **Gather sources.** Prioritize in this order:",
+    "   - The person's own public writing (personal site, blog, newsletter)",
+    "   - Their current employer's bio / leadership page",
+    "   - Public conference talks, podcast appearances, and interviews",
+    "   - Public directories that the invoking issue body authorizes",
+    "     (LinkedIn, GitHub, company profiles, Crunchbase)",
+    "   - Public contributions (open-source repos, published papers)",
+    "",
+    "5. **Write a research-notes file** to",
+    "   `<NOTES_DIR>/<PERSON_SLUG>.notes.md`:",
+    "",
+    "   ```markdown",
+    "   ---",
+    '   title: "Research Notes: <person name>"',
+    "   slug: <PERSON_SLUG>",
+    "   role: <one of the taxonomy values>",
+    "   primary_company: <company name if known>",
+    "   date: YYYY-MM-DD",
+    "   parent_issue: <N>",
+    "   ---",
+    "",
+    "   # Research Notes: <person name>",
+    "",
+    "   ## Framing",
+    "   <why this person was requested and what to learn>",
+    "",
+    "   ## Raw Findings",
+    "   - <finding> \u2014 source: <citation>",
+    "",
+    "   ## Candidate Cross-References",
+    "   - **Companies mentioned:** <list of company names>",
+    "   - **Software mentioned:** <list of product names>",
+    "   - **Meetings mentioned:** <list of meeting identifiers>",
+    "",
+    "   ## Open Questions",
+    "   <anything the notes could not answer from public sources>",
+    "",
+    "   ## Sources",
+    "   - <source URL or file path> \u2014 <date accessed>",
+    "   ```",
+    "",
+    "6. **Create the `people:draft` issue** with `Depends on: #<research-issue>`.",
+    "   Its body references the notes file path, the requested role, and",
+    "   any refresh-mode flags.",
+    "",
+    "7. **Commit and push** the notes file. Close the research issue.",
+    "",
+    "---",
+    "",
+    "## Phase 2: Draft Profile (`people:draft`)",
+    "",
+    "**Goal:** Write the structured person 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 / refresh.** If `<PROFILES_DIR>/<PERSON_SLUG>.md`",
+    "   already exists:",
+    "   - In refresh mode, open the existing file and update in place,",
+    "     preserving the slug and bumping the `date` frontmatter.",
+    "   - Otherwise, flag a naming collision and stop \u2014 never silently",
+    "     overwrite a non-trivial existing profile.",
+    "",
+    "3. **Write the profile** to `<PROFILES_DIR>/<PERSON_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: "<person name>"',
+    "   slug: <PERSON_SLUG>",
+    "   role: <one of the taxonomy values>",
+    "   primary_company: <company name>",
+    "   date: YYYY-MM-DD",
+    "   refresh_days: <N, default 180>",
+    "   parent_issue: <N>",
+    "   notes: <NOTES_DIR>/<PERSON_SLUG>.notes.md",
+    "   ---",
+    "",
+    "   # <person name>",
+    "",
+    "   ## Summary",
+    "   <2\u20134 sentence elevator description: who they are, what they do,",
+    "   why they matter to this project>",
+    "",
+    "   ## Classification",
+    "   - **Primary role:** <taxonomy value>",
+    "   - **Secondary role (if any):** <taxonomy value or `n/a`>",
+    "   - **Relevance to this project:** <1\u20132 sentences tying the person",
+    "     back to the framing from the notes>",
+    "",
+    "   ## Current Position",
+    "   - **Company:** <primary company \u2014 link to company profile if tracked>",
+    "   - **Title:** <current title>",
+    "   - **Tenure:** <since YYYY, if known>",
+    "   - **Focus areas:** <what they work on day-to-day>",
+    "",
+    "   ## Background",
+    "   - **Prior roles:** <short reverse-chronological list>",
+    "   - **Education / credentials:** <if publicly disclosed>",
+    "   - **Notable contributions:** <open-source, publications, talks>",
+    "",
+    "   ## Expertise Signals",
+    "   <topics they write or speak about \u2014 each bullet cited to a public",
+    "   source>",
+    "",
+    "   ## Positioning / Point of View",
+    "   <how they describe their own work and views \u2014 use their own",
+    "   language, cited, rather than inferred>",
+    "",
+    "   ## Cross-References",
+    "   - **Companies:** <links to `<COMPANIES_DIR>/*.md` for companies",
+    "     already tracked by this project>",
+    "   - **Software:** <links to `<SOFTWARE_DIR>/*.md` for software",
+    "     already tracked by this project>",
+    "   - **Meetings:** <links to `<MEETINGS_DIR>/*.md` for meeting notes",
+    "     this person participated in>",
+    "",
+    "   ## Contact Preferences",
+    "   <public channels only \u2014 company email if listed, social handles,",
+    "   speaker inquiry forms. Never private contact info.>",
+    "",
+    "   ## Risks / Open Questions",
+    "   <what the profile could not answer; flag anything the followup",
+    "   phase should cross-reference>",
+    "",
+    "   ## Sources",
+    "   - <source URL> \u2014 <date accessed>",
+    "   ```",
+    "",
+    "4. **Decide whether a followup issue is warranted.** Create a",
+    "   `people:followup` issue (depending on this draft issue) only if",
+    "   the profile's Candidate Cross-References lists at least one",
+    "   company, software product, or meeting already tracked by the",
+    "   consuming project. Otherwise, note in the draft issue's closing",
+    "   comment that no followup is needed.",
+    "",
+    "5. **Commit and push** the profile file. Close the draft issue.",
+    "",
+    "---",
+    "",
+    "## Phase 3: Followup (`people:followup`)",
+    "",
+    "**Goal:** Populate the profile's `## Cross-References` section with",
+    "links to existing artifacts \u2014 companies, software, meetings \u2014 that",
+    "the consuming project already tracks.",
+    "",
+    "**Budget:** No new web searches. No new downstream research issues.",
+    "Read the candidate cross-references, resolve them against the",
+    "configured directories, update the profile.",
+    "",
+    "### Steps",
+    "",
+    "1. **Read the profile file** referenced in the issue body.",
+    "",
+    "2. **Resolve company cross-references.** For each company named in",
+    "   the profile's research notes or body text, look for a matching",
+    "   file under `<COMPANIES_DIR>/`. If found, link it under",
+    "   `## Cross-References > Companies`. If not found, leave a TODO",
+    "   comment naming the company \u2014 the invoking project's team decides",
+    "   whether to kick off a separate company-profile pipeline.",
+    "",
+    "3. **Resolve software cross-references.** Same pattern against",
+    "   `<SOFTWARE_DIR>/`. Link what matches; leave TODOs for what",
+    "   doesn't.",
+    "",
+    "4. **Resolve meeting cross-references.** For meetings the person",
+    "   participated in, look for a matching file under `<MEETINGS_DIR>/`",
+    "   by date or slug. Link matches; leave TODOs otherwise.",
+    "",
+    "5. **Do not open downstream issues.** This pipeline emits no",
+    "   `company:research`, `research:scope`, or similar issues. Cross-",
+    "   references are link-only; downstream research is a separate",
+    "   human decision.",
+    "",
+    "6. **Commit and push** the updated profile. Close the followup issue.",
+    "",
+    "---",
+    "",
+    "## 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)",
+    "",
+    "The pipeline produces **profiles and notes only**. It does not",
+    "create new companies, software evaluations, meeting notes, or any",
+    "other downstream artifacts \u2014 it only links to those that already",
+    "exist under the configured cross-reference directories. Keep this",
+    "boundary clean so the people-profile pipeline stays generic and",
+    "cheap to run.",
+    "",
+    "---",
+    "",
+    "## Rules",
+    "",
+    "- **One person per session.** Never profile two people 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.",
+    "- **Respect privacy.** Never record private contact details, family",
+    "  information, or other non-professional personal data, even when",
+    "  encountered in a public source.",
+    "- **Cross-reference, don't duplicate.** Link to existing company,",
+    "  software, and meeting artifacts rather than re-describing them.",
+    "- **No downstream issue creation.** Phase 3 emits no new research,",
+    "  profile, or requirement issues. Only link.",
+    "- **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 profilePersonSkill = {
+  name: "profile-person",
+  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.",
+  disableModelInvocation: true,
+  userInvocable: true,
+  context: "fork",
+  agent: "people-profile-analyst",
+  platforms: { cursor: { exclude: true } },
+  instructions: [
+    "# Profile Person",
+    "",
+    "Kick off a people-profile pipeline. Creates a `people:research`",
+    "issue carrying the person's name, role, primary affiliation, and",
+    "framing, then dispatches Phase 1 (Research) in the",
+    "people-profile-analyst agent.",
+    "",
+    "## Usage",
+    "",
+    "/profile-person <person-name>",
+    "",
+    "Optional extensions in the issue body:",
+    "- `role: <colleague | customer-contact | vendor-contact |",
+    "   partner-contact | industry-expert | connector>` \u2014 override the",
+    "   default role inference",
+    "- `company: <name>` \u2014 primary company affiliation 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 person slug",
+    "- `refresh_days: <N>` \u2014 override the default 180-day refresh cadence",
+    "- `force: true` \u2014 refresh even if the profile is younger than the",
+    "   cadence window",
+    "- `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/people/notes/<slug>.notes.md`",
+    "- `docs/people/profiles/<slug>.md`",
+    "",
+    "Cross-references are resolved against:",
+    "",
+    "- `docs/companies/profiles/`",
+    "- `docs/software/profiles/`",
+    "- `docs/meetings/`",
+    "",
+    "## Steps",
+    "",
+    "1. Create a `people:research` issue with `type:people-profile`,",
+    "   `priority:medium`, and `status:ready`. Body must include the",
+    "   person's name, selected role, primary company, framing, and any",
+    "   overrides.",
+    "2. Execute Phase 1 (Research) of the people-profile-analyst agent.",
+    "3. Phase 1 creates the `people:draft` issue. Phase 2 may create a",
+    "   `people:followup` issue. Each downstream issue declares its",
+    "   `Depends on:` predecessor.",
+    "",
+    "## Output",
+    "",
+    "- A research-notes file under the project's notes directory",
+    "- A single person profile under the profiles directory",
+    "- Cross-references to existing companies, software, and meetings",
+    "  tracked elsewhere in the project",
+    "- This pipeline produces **profiles only** \u2014 it does not create",
+    "  companies, software, meetings, or any other downstream artifacts."
+  ].join("\n")
+};
+var peopleProfileBundle = {
+  name: "people-profile",
+  description: "People research and profiling pipeline: research, draft profile, followup. Opt-in only; domain-neutral; filesystem-durable between phases; cross-references existing companies, software, and meeting notes without creating new downstream issues.",
+  appliesWhen: () => false,
+  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.",
+      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`.",
+        "",
+        "The pipeline produces **person profiles only**. Cross-references",
+        "to companies, software products, and meeting notes are link-only",
+        "\u2014 the followup phase never creates new downstream research,",
+        "profile, or requirement issues.",
+        "",
+        "See the `people-profile-analyst` agent definition for full",
+        "workflow details, default paths, the person-role taxonomy, the",
+        "refresh cadence rules, and phase-by-phase instructions."
+      ].join("\n"),
+      platforms: {
+        cursor: { exclude: true }
+      },
+      tags: ["workflow"]
+    }
+  ],
+  skills: [profilePersonSkill],
+  subAgents: [peopleProfileAnalystSubAgent],
+  labels: [
+    {
+      name: "type:people-profile",
+      color: "0E8A16",
+      description: "Work that produces or maintains a person profile or its research notes"
+    },
+    {
+      name: "people:research",
+      color: "C5DEF5",
+      description: "Phase 1: gather public sources about a person into a research-notes file"
+    },
+    {
+      name: "people:draft",
+      color: "BFDADC",
+      description: "Phase 2: write the structured person profile from research notes"
+    },
+    {
+      name: "people:followup",
+      color: "D4C5F9",
+      description: "Phase 3: cross-link the profile to existing companies, software, and meeting notes"
+    }
+  ]
+};
+
 // src/pnpm/pnpm-workspace.ts
 var import_path = require("path");
 var import_projen = require("projen");
@@ -5093,7 +5643,8 @@ var BUILT_IN_BUNDLES = [
   prReviewBundle,
   requirementsAnalystBundle,
   researchPipelineBundle,
-  companyProfileBundle
+  companyProfileBundle,
+  peopleProfileBundle
 ];
 
 // src/agent/bundles/scope.ts
@@ -8619,6 +9170,7 @@ var TypeScriptConfig = class extends import_projen22.Component {
   jestBundle,
   meetingAnalysisBundle,
   orchestratorBundle,
+  peopleProfileBundle,
   pnpmBundle,
   prReviewBundle,
   projenBundle,