<!-- carta:plugin-version --> <carta-plugin>carta-investors:6.71.0</carta-plugin>

carta-portfolio-analytics-routing — Portfolio Analytics Router (mirror)

Plugin root in reference files. Reference files write the plugin root as a CLAUDE_PLUGIN_ROOT variable in braces. Bash does not set that variable, so never run it as written: replace it with the literal plugin root ${CLAUDE_PLUGIN_ROOT}, keep every quote, and keep the command on one line.

Routes to the Portfolio Analytics App, Schedule of Investments, Co-Investor Lookup, or Performance Benchmarks. SOI and Benchmarks execute inline from a content mirror of their specialist skill; the Portfolio Analytics App and Co-Investor Lookup dispatch the specialist directly via the Skill tool. See execution modes in Architecture Notes below. The remaining Portfolio Analytics capability (Loan Dashboard) is internal-stage today and will be wired into this router as it reaches general availability for external users.

Scope note: This router covers the Portfolio Analytics skills available to external customers today. Loan Dashboard exists as an internal-stage skill but is not yet GA for external users — see Future routes below.

---

Route Map

Intent	Skill
Interactive portfolio-company analytics console (KPIs, valuations, cap tables)	carta-investors:carta-portfolio-analytics-app (dispatched)
View fund holdings — Schedule of Investments (SOI)	references/soi.md
Who co-invested alongside us in portfolio companies	carta-investors:carta-co-investors (dispatched)
Benchmark a fund's performance against peer cohorts	references/benchmarks.md

---

Customer Intent Framework

Use this as the semantic layer when Step 1 signal phrases don't produce an exact match.

What the customer is trying to do	Typical phrasing	Route
Explore the whole portfolio interactively / track company KPIs over time	"show me the portfolio analytics app for Great Basin Capital", "open the KPI dashboard", "portfolio analytics for Acme Ventures", "track ARR across my portfolio companies", "launch the analytics console"	app
View fund holdings / portfolio breakdown	"show me the SOI", "what companies is the fund invested in", "portfolio breakdown for our flagship fund", "what does Fund III hold right now"	soi
Fund-of-funds look-through	"what does our LP interest in Fund X actually hold", "look through to the underlying portfolio", "who else holds Acme via our fund investments"	soi (look-through is a conditional addition inside the SOI route — see references/soi.md Step 2b)
Find who else invested alongside us	"show me my co-investors", "who co-invested with us in Acme", "who else participated in the Series B for TechCorp", "co-invest analysis by stage"	co-investors
Benchmark fund performance against peers	"run performance benchmarks for Fund I", "how does our fund compare to peers", "how does Fund II stack up against vintage 2019 peers", "are we top-quartile for our vintage"	benchmarks

---

Step 1 — Parse Intent [Deterministic]

Respond immediately without extended reasoning.

STOP rows — handle before routing:

Message signals	Action
"run my valuations", "do my marks", "quarterly marks", "fair value", "batch valuations", "close my quarter", "update the EV", "autopilot valuation", "goal seek", "waterfall", "exit scenario"	Stop. Portfolio valuations are handled separately. Tell the user: "Portfolio marks and valuations are handled by a different skill set — try /carta-valuations-routing or say 'run my valuations'."
"K-1", "capital call notice", "distribution notice", "LP documents", "LP quarterly report", "AGM deck", "tear sheet"	Stop. LP reporting is handled separately. Tell the user: "LP documents and reporting live in a separate skill set — try /carta-lp-reporting-routing or say 'show me my LP documents'."
"comparable companies", "comp set", "GPC comps", "select comps", "find comps", "add comparables", "update the comp set", "trading comps", "browse comps", "add ticker", "industry comparables"	Stop. Comparable company selection is handled by the Portfolio Valuations skill set. Tell the user: "Comparable company selection lives in the Portfolio Valuations skill — try /carta-valuations-routing or say 'update my comp set'."
"SPA audit", "SPA coverage", "missing SPAs", "Form ADV", "regulatory AUM"	Stop. SPA audit and Form ADV are handled separately. Tell the user: "SPA audit and Form ADV live in a separate skill set — try /carta-compliance-routing."

Route rows — classify and proceed to Step 2.5:

Message signals	Route
"portfolio analytics app", "analytics app", "the microapp", "micro-app", "portfolio analytics dashboard", "analytics dashboard", "KPI dashboard", "company KPIs", "KPI pivot", "track KPIs", "operating KPIs", "portfolio console", "analytics console", "portfolio analytics for [firm name]", "analytics for [firm name]"	app → proceed directly to Step 3 (Step 2.5 does not apply to this route — see its note)
"SOI", "schedule of investments", "fund holdings", "what is the fund invested in", "what companies is the fund in", "portfolio breakdown", "portfolio companies", "fund portfolio view", "investments by stage", "portfolio list", "what has [fund] invested in", "show me the portfolio", "fund of funds", "FoF", "fund-of-funds", "look-through", "look through to underlying funds", "underlying fund holdings"	soi → proceed to Step 2.5
"co-investor", "coinvestor", "co-invest", "who co-invested", "who else invested", "co-investors by stage", "co-investors by round", "co-invest analysis", "who are our co-investors", "co-investors on Aumni", "which funds invest alongside us"	co-investors → proceed to Step 2.5
"performance benchmark", "fund benchmark", "peer comparison", "percentile ranking", "IRR vs peers", "TVPI benchmark", "net IRR benchmark", "how does our fund compare", "how does Fund [X] stack up", "fund performance vs cohort", "vintage year benchmark", "benchmark cohort", "peer benchmark"	benchmarks → proceed to Step 2.5

Precedence when app and another row both match: a message that names the app, a dashboard, a console, or KPIs alongside a broader signal ("show me the portfolio analytics app" contains the SOI signal "show me the portfolio") routes to app. The word "app" / "dashboard" / "console" / "KPI" is the tiebreaker — the user is asking for the interactive surface, not a one-off table.

If exactly one route matches: proceed to Step 2.5 (or straight to Step 3 for app). If zero or multiple routes match: proceed to Step 2.

---

Step 2 — Clarify Intent [Interactive]

Fire only if Step 1 returned no clear match.

If the user said anything at all: reason over it before asking. Present the menu only if you've genuinely worked through every signal and still can't determine intent.

Ambiguous phrase	Signal that tips the balance
"fund performance" alone	"vs peers" / "benchmark" / "cohort" / "percentile" → benchmarks; "company-level performance" / "individual portco" → may not be portfolio analytics — ask
"portfolio" alone	"what's in the portfolio" / "portfolio breakdown" / "holdings" → soi; "portfolio dashboard" → ask — could mean the interactive app, SOI, or (not-yet-active) loan portfolio
"loans" / "loan portfolio"	Not yet GA externally — see Future routes below; do not route
"analytics" alone (bare noun)	Ask — too broad to route without more context
"KPIs" / "metrics" for one company vs the portfolio	Either way → app — the console covers single-company deep-dives (Company page) and portfolio-wide pivots alike

If you need to ask, present once:

Which Portfolio Analytics capability can I help with?

1. Schedule of Investments (SOI) — fund holdings and portfolio breakdown
2. Co-investor lookup — who else invested in our portfolio companies
3. Performance benchmarks — fund IRR/TVPI vs peer cohorts
4. Portfolio analytics app — interactive console for company KPIs, valuations, cap tables, and benchmarking across the whole portfolio
5. Something else — Describe what you need and I'll point you in the right direction

User picks	Action
Option 1 — SOI	Proceed to Step 2.5
Option 2 — Co-investor lookup	Proceed to Step 2.5
Option 3 — Performance benchmarks	Proceed to Step 2.5
Option 4 — Portfolio analytics app	Proceed directly to Step 3 (Step 2.5 does not apply)
Option 5 — Something else	Respond: "I specialize in fund holdings (SOI), co-investor lookups, performance benchmarks, and the interactive portfolio analytics app. Tell me what you're trying to do and I'll point you to the right Carta workflow." Then stop.

Out-of-scope

Topic	Suggestion
Portfolio valuations, quarterly marks, EV updates	/carta-valuations-routing
Comparable company selection, comp sets	/carta-valuations-routing
SPA audit, Form ADV, regulatory AUM	/carta-compliance-routing
LP documents, K-1, LP reporting, AGM decks, tear sheets	/carta-lp-reporting-routing
Cap table ownership, equity management, 409A	Carta cap table tools
Wants Carta's Fund Admin team to do something	carta-fund-admin-requests

---

Step 2.5 — Fund Admin access preflight [Active proxy gate]

The app route skips this step entirely — proceed straight to Step 3. The Portfolio Analytics App works for Data Collection–only firms with no Fund Admin product (its KPI data comes from COMPANY_FINANCIALS; Fund Admin data is an enrichment, not a requirement), so an FA reachability probe would false-block exactly those firms. The app skill does its own firm resolution and degrades gracefully when Fund Admin data is absent.

If the Carta MCP server is not connected (noMcp environment), skip this step and proceed to Step 3.

Otherwise:

1. Call welcome to establish session identity (skip if already called this session).
2. Run exactly one proxy probe: read_tool({"name": "fa__list__entities", "arguments": {}}). You get exactly one attempt at this probe — do not retry it, do not vary the call, and do not substitute a different tool to route around a failure.

Branch on the result:

Result	Action
Returns a list (even empty)	Fund Admin data is reachable — proceed to Step 3
Errors with a permission/entitlement signal (403, "not entitled", "no access", firm not found)	Surface the access message below and stop — do not proceed to Step 3
Errors for any other reason (timeout, connection drop, malformed response)	Proceed to Step 3 anyway — let the matched route's mirrored logic surface the specific error. Do not false-block on a transient failure.

If access is not confirmed, surface this message and stop:

This workflow requires Fund Admin access, which your firm doesn't appear to have enabled. Reach out to your Carta account manager or contact Carta Support to request access.

Important — this is a proxy, not a real entitlement check. See Architecture Notes §"Fund Admin access preflight" for the full rationale — there is no Carta MCP command today that exposes real SKU/entitlement data (SOI's own Step 3 discover call is for MCP UUID-form tool disambiguation only, not an entitlement gate), so this substitutes a cheap reachability probe. It cannot distinguish specific FA sub-products, so false negatives/positives are possible.

---

Step 3 — Route [Deterministic]

Mechanical rule — no exceptions: the very first content block of your very first turn after a route match, before any tool call (including list_contexts, welcome, or any firm-lookup call the matched route's own Step 1 would otherwise make first) and before any internal reasoning about what the user still needs to provide, must be plain text output containing exactly:

Routing to [Display Name].

Do not combine this turn with a tool call. Do not decide the announcement is unnecessary because you can already tell the matched route will need to ask a clarifying question (e.g. "which firm?"). That clarifying question — and every other step of the matched route's own workflow, including its own "Announce" step if it has one — happens in the next turn, after this one, never instead of it or merged into the same turn as a tool call.

Then hand the run off. Two routes read a reference file; two dispatch a skill. Use the exact action for the matched route:

Route	Display Name	Action
app	Portfolio Analytics App	Skill('carta-investors:carta-portfolio-analytics-app')
soi	Schedule of Investments	Read ${CLAUDE_PLUGIN_ROOT}/skills/carta-portfolio-analytics-routing/references/soi.md
co-investors	Co-Investor Lookup	Skill('carta-investors:carta-co-investors')
benchmarks	Performance Benchmarks	Read ${CLAUDE_PLUGIN_ROOT}/skills/carta-portfolio-analytics-routing/references/benchmarks.md

For the two Read routes: follow the matched file's instructions exactly, starting from its own Step 1/Workflow entry point with the user's original message as context. Each reference file resolves its own internal script and data paths independently (see Architecture Notes) — do not rewrite them.

For the two dispatched routes (app, co-investors): dispatch the skill and let it run its own workflow from its own entry point. Do not read a reference file for these routes — there isn't one, and references/ holds no copy of either workflow. Do not re-implement any part of them here, and do not pre-collect their inputs (firm, fund, date range) on their behalf; each asks for what it needs (the app's own Step 0 prompts for the Investment Firm Account when the message doesn't name one). If a dispatch fails because the skill is unavailable, say so plainly and stop — do not fall back to writing the analysis or building the dashboard yourself.

Do not summarize what the target skill will do beyond the announcement itself. Do not add any other output before the routing announcement.

---

If Something Goes Wrong

Situation	Response
User asks about portfolio valuations or marks	Out of scope — see STOP rows, redirect to /carta-valuations-routing
User asks about comparable company selection or comp sets	Out of scope — see STOP rows, redirect to /carta-valuations-routing
User asks about LP documents, K-1s, or LP reporting	Out of scope — see STOP rows, redirect to /carta-lp-reporting-routing
User asks about SPA audit, Form ADV, or regulatory filings	Out of scope — see STOP rows, redirect to /carta-compliance-routing
User asks about cap table, equity grants, or 409A	Out of scope — redirect to the cap table skills
User asks about a loan dashboard, loan portfolio, or draw balances	Not yet GA externally — see Future routes below

---

Architecture Notes

Orchestrator pattern

This skill is the sole external-facing entry point for the Portfolio Analytics theme. It classifies intent, resolves ambiguity via AskUserQuestion, and then either executes a route inline from references/<route>.md or dispatches the specialist skill. Loan Dashboard will be wired in as it reaches GA for external users.

Execution modes — mirror vs dispatch

Mode	Routes	How the route runs
Mirror	soi, benchmarks	references/<route>.md holds a copy of the specialist's SKILL.md body, plus real copies of any scripts it runs under references/<route>/. Runs inside this skill's turn, under this skill's allowed-tools.
Dispatch	app, co-investors	Skill('carta-investors:carta-portfolio-analytics-app') / Skill('carta-investors:carta-co-investors'). The specialist runs under its own frontmatter and owns its whole workflow. No reference file exists for these routes.

Dispatch is the preferred mode. A mirror is a copy, so it can drift from its specialist, and keeping it honest costs either a declarable codemod (tests/carta-investors/mirror_sync.py) or a human merge. Dispatch has nothing to drift and nothing to re-mirror. It also keeps this router's allowed-tools minimal: a dispatched skill brings its own tools, so carta-co-investors' render-script Bash(uv run …) grant, Bash(tee *), skill_checkpoint, and carta-portfolio-analytics-app's script/serve Bash grants are deliberately not duplicated here.

The remaining two routes are mirrors only because their specialists are publish: false, so the publish pipeline strips them and there would be nothing for a dispatch to reach. Convert either one to dispatch by publishing it.

Scope decision (as of v2.3.0)

The Portfolio Analytics App, SOI, Co-Investor Lookup, and Performance Benchmarks are GA for external users. carta-co-investors and carta-portfolio-analytics-app carry publish: true — both dispatch routes depend on it. Strip either skill from the published plugin and its route dead-ends for external users, since the dispatch has no skill to reach. tests/carta-investors/test_router_mirror_parity.py guards this. carta-soi and carta-performance-benchmarks stay publish: false; their mirrors are what reach external users. Loan Dashboard (carta-investors:carta-loan-dashboard) has a version field but no publish field — internal-stage today — and is documented below as a future route, not an active one.

Structural patterns

This router follows the same 6 patterns established in carta-valuations-routing and carta-compliance-routing (the reference routing skills), extended to three active mirrored routes instead of one:

Pattern	Applied here
Step 1 [Deterministic] + "Respond immediately"	No over-reasoning on signal classification; STOP rows short-circuit valuations/LP-reporting/comps/compliance/FoF before route classification
Step 2 AskUserQuestion	SOI (1) / Co-investors (2) / Benchmarks (3) / App (4) / Something else (5) — four active routes, same shape as the single-route pattern in valuations-routing and compliance-routing, just with more options
Customer Intent Framework	All four active routes; loans documented separately below
Explicit skip logic	Match → Step 2.5 (app → straight to Step 3); no match → Step 2
Step 2.5 (active proxy gate)	welcome + one fa__list__entities probe — not a real entitlement check (see below), but no longer purely passive. Skipped for app, which supports Data Collection–only firms with no Fund Admin
Step 3 [Deterministic]	Mirror read for soi/benchmarks, Skill() dispatch for app/co-investors

Fund Admin access preflight — proxy, not a real SKU check

Step 2.5 was upgraded from a passive welcome-only check to an active proxy gate — same change, same rationale, as carta-compliance-routing and carta-lp-reporting-routing. Research into carta/carta-web's eshares/iam/models.py confirmed there is no single "FA" SKU — Fund Admin access is a family of ~23 ProductCode values fed by fund-admin's own products_fundproductaccess table via an internal gRPC call, cached in carta-web's EntityProductAccess model. That model is not exposed through the Carta MCP gateway — there is no search_tools-style command this router can call the way carta-valuations-routing calls search_tools({"query": "waterfall modeling"}). (SOI's own tool-discovery in Step 3 is unrelated — it disambiguates the MCP's UUID-form tool prefix, not an entitlement check.)

Absent a real entitlement command, Step 2.5 substitutes a cheap proxy: one fa__list__entities call. This only proves FUND_ADMIN.* data is reachable — it cannot tell which FA sub-products are actually enabled, so it can produce false negatives (transient failure on an entitled firm) or false positives (base FA present, but the specific feature a route needs isn't). The one-attempt cap follows the sub-agent safety pattern in the marketplace root CLAUDE.md — capped rather than left to retry loop.

Replace this the moment a real entitlement check exists — file a request for an MCP command surfacing EntityProductAccess for the current firm context; that's Carta MCP team work, not something fixable from the skill side.

Specialists are unchanged

references/soi.md and references/benchmarks.md are content mirrors of carta-investors:carta-soi and carta-investors:carta-performance-benchmarks's own SKILL.md bodies. carta-investors:carta-co-investors has no reference file at all — it is dispatched.

• soi.md is not re-mirrorable by copy-paste. When re-mirroring, rewrite both of its Step 4b paths — the find pattern and the ${CLAUDE_PLUGIN_ROOT} fallback — to this router's own references/soi/ copy. carta-soi's body points them at skills/carta-soi/, which the publish pipeline strips. Its Step 2b Read path needs the same treatment: rewrite skills/carta-soi/references/lookthrough.md to skills/carta-portfolio-analytics-routing/references/soi/lookthrough.md. render-artifact.py, artifact.html, and lookthrough.md need no rewrite of their own contents — the script probes both template offsets and lookthrough.md has no internal paths — so those three files stay byte-identical across both locations and re-mirror with cp. Keep them that way.
• carta-performance-benchmarks is entirely self-contained SQL/logic with no sub-references or scripts at all.
• carta-co-investors needs no re-mirroring at all — dispatch reaches the specialist itself, and it resolves its own scripts and canonical-investors.json exactly as it does when the picker invokes it directly.
• carta-portfolio-analytics-app needs no re-mirroring either — same reason: dispatch reaches the specialist, which resolves its own scripts/, app/, and webapp/ assets via ${CLAUDE_PLUGIN_ROOT} exactly as it does when the picker invokes it directly.

None of the three specialists had its workflow modified. carta-investors:carta-performance-benchmarks had only its description softened (see "Picker de-tune" below) — same precedent carta-compliance-routing used for carta-form-adv (PR #11162) and carta-lp-reporting-routing used for carta-download-tearsheet (PR #11953). All three remain directly invocable by name, with their existing test coverage in tests/carta-investors/skill-triggers.test.yaml untouched.

Maintenance cost — read before editing carta-soi or carta-performance-benchmarks: a mirror is a copy, not a shared source, so any change to those two bodies must be re-applied to the matching references/<route>.md. tests/carta-investors/test_router_mirror_parity.py enforces this where the transform is declarable and otherwise requires the divergence be declared with a reason. carta-co-investors is exempt — dispatch has nothing to keep in sync, which is the reason to prefer it. When promoting a future route, reach for dispatch first and fall back to a mirror only if the specialist must stay publish: false.

Picker de-tune — carta-performance-benchmarks: its trigger-phrase-rich description was stripped down to a one-line redirect ("For performance benchmark requests, use carta-portfolio-analytics-routing instead"), following the same pattern documented under "How to promote a future route to active" § Mirror + de-tune below. It keeps publish: true and all its tools — this only changes picker precedence for ambiguous natural-language prompts and remains fully invocable directly by name. Added version: 1.0.0 — the skill had no prior version: field, matching the WARN default the frontmatter validator recommends rather than fabricating a bump from a nonexistent prior release.

Known limitation — carta-soi, carta-co-investors, and carta-portfolio-analytics-app: because these specialists still have trigger-phrase-rich descriptions and remain standalone invocable skills, specific prompts ("show me the SOI", "portfolio analytics for Acme Ventures") can still win the skill picker directly and bypass this router. This is a known, accepted limitation — and for the two dispatched routes (co-investors, app) it is harmless, since the picker and the router both end up running the same skill. See the failing: true trigger tests in carta-portfolio-analytics-routing.test.yaml and carta-portfolio-analytics-routing-triggers.test.yaml for the two remaining un-de-tuned routes; the former benchmarks picker test is now a hard assertion, matching PR #11953's approach for tear sheets. Routing logic (STOP rows, disambiguation, inline execution) is fully verified by the inject-mode tests in carta-portfolio-analytics-routing.test.yaml, which force the router to run regardless of picker behavior.

References layout

carta-portfolio-analytics-routing/
├── SKILL.md                 ← this file (sole registered skill)
└── references/
    ├── soi.md                ← mirror of carta-soi/SKILL.md — ACTIVE
    ├── soi/                  ← copies of carta-soi's script + template (see below)
    │   ├── artifact.html
    │   ├── lookthrough.md    ← copy of carta-soi/references/lookthrough.md (fund-of-funds look-through)
    │   └── scripts/render-artifact.py
    │                         (no app or co-investors file — those routes are dispatched, see Step 3)
    ├── benchmarks.md         ← mirror of carta-performance-benchmarks/SKILL.md — ACTIVE
    ├── loan-dashboard.md     ← mirror of carta-loan-dashboard/SKILL.md — NOT YET WIRED (future route)
    └── loan-dashboard/
        └── artifact_template.html   ← copy of carta-loan-dashboard/references/artifact_template.html, used only by the Step 7e fallback path (see below)

soi/ holds real copies of carta-soi's script and template: the publish pipeline strips the whole directory of any publish: false skill, so a published route must not reference skills/carta-soi/. soi.md points at those copies; benchmarks.md needs none (self-contained SQL). The two dispatched routes need no copies for the opposite reason — carta-co-investors and carta-portfolio-analytics-app are publish: true, so their skill directories (scripts, app assets and all) survive publish and the dispatched skill runs them in place. Those publish flags are load-bearing: flipping either back to false silently breaks its route in the published plugin, since the dispatch would have no skill to reach. loan-dashboard.md is different again: its primary render path ($SKILL_DIR/references/artifact_template.html, Step 7c) also resolves correctly with no rewrite, since $SKILL_DIR is probed by literal name (carta-loan-dashboard) same as the others — but its fallback path (Step 7e) calls read_skill(file_path="references/artifact_template.html"), a tool that resolves relative to whichever skill is currently executing. Mirrored verbatim, that call would resolve to this router's own references/, not carta-loan-dashboard's — so the fallback needed a real asset copy into references/loan-dashboard/ and a rewritten path. Check every source skill's tool calls individually; Read/absolute-path/$SKILL_DIR-probe calls behave differently from read_skill's implicit-relative resolution, and a skill can mix both (as this one does).

None of the routes below are dispatched from Step 3 and none have Step 1 route rows — promoting them is wiring work only, per "How to promote a future route to active" below, not a re-mirroring job.

Route dispatched

Route	Reference file	Status
app	— (dispatched)	GA — external users, Skill('carta-investors:carta-portfolio-analytics-app')
soi	references/soi.md	GA — external users, executed inline (mirror of carta-investors:carta-soi)
co-investors	— (dispatched)	GA — external users, Skill('carta-investors:carta-co-investors')
benchmarks	references/benchmarks.md	GA — external users, executed inline (mirror of carta-investors:carta-performance-benchmarks)
loan-dashboard	references/loan-dashboard.md	Mirror built, not wired — internal-stage, awaiting GA

How to promote a future route to active

1. Confirm the underlying skill is GA for external users.
2. Decide dispatch mechanism. Try direct dispatch first — it is the only mode with no drift surface:
   • Direct dispatch (this router's pattern for co-investors) — Step 3 calls Skill('carta-investors:carta-<skill>') with no references/ copy at all. The specialist runs under its own frontmatter, so do not copy its tools into this router's allowed-tools; Skill alone is enough. Requires the backing skill be publish: true, or the publish pipeline strips it and the dispatch dead-ends for external users — add the route to DISPATCHED in tests/carta-investors/mirror_sync.py so a later publish: false fails CI instead of shipping. Still inherits picker-competition risk if the skill's own description is trigger-phrase-rich.
   • Mirror (this router's pattern for soi and benchmarks) — copy the backing skill's SKILL.md body verbatim into references/<route>.md. Check first whether the source skill has any Read ${CLAUDE_PLUGIN_ROOT}/skills/<source>/... calls or relative references/ links that assume they're being read from the source skill's own directory — if so, rewrite those paths into a references/<route>/ sub-directory (as carta-compliance-routing did for form-adv); if the source skill resolves its own paths dynamically or via literal skill-anchored strings (as all three routes here do), no rewrite is needed. Does not require touching the backing skill's frontmatter or publish flag, so its existing test coverage stays intact. Cost: the mirror can drift from the source if the backing skill changes later — there's no auto-sync, re-mirror by hand on every meaningful change.
   • Mirror + de-tune (carta-valuations-routing's pattern for waterfall) — mirror as above, and set the backing skill to publish: false plus soften its description. Eliminates picker competition, but changes the skill's public availability and can break existing tests that assert direct-picker behavior. Get explicit sign-off before doing this to any currently-public skill.
3. Add its signal phrases to the Step 1 Route rows table and the Customer Intent Framework.
4. Add it as an option in Step 2's AskUserQuestion (existing active routes keep their numbers; new route gets the next number; "Something else" moves to last).
5. Add a Read ${CLAUDE_PLUGIN_ROOT}/skills/carta-portfolio-analytics-routing/references/<route>.md row to the Step 3 table (mirror/mirror+de-tune) or the bare skill name (direct dispatch).
6. MINOR bump the version and add verdict tests — both inject-mode (routing logic) and plugin-mode (picker behavior, expect failing: true if the backing skill still wins the picker on its own).

---

Future routes — not yet active

Loan Dashboard

• Status: Internal stage — has a version field (1.0.0) but no publish field. Not GA for external users.
• Mirror status: Already built at references/loan-dashboard.md — one call rewritten (the Step 7e read_skill fallback, see References layout above) plus a real copy of artifact_template.html into references/loan-dashboard/. Every Bash pattern it needs (carta workspace cache, uv run, test -d/-f, find, mkdir -p) and Artifact are already in this router's allowed-tools (added for carta-soi's own artifact calls). Only read_skill is missing — add it at promotion time.
• Signals: "loan dashboard", "loan portfolio", "show my loans", "loan overview", "draw balance", "drawn balance", "undrawn", "credit facility", "outstanding loans", "loan commitments", "borrower portfolio", "loan KPIs", "loan exposure"
• CTA until GA: "The loan portfolio dashboard is coming to external users soon. Reach out to your Carta account manager or contact Carta Support to request early access."
• Skill when live: carta-investors:carta-loan-dashboard
• Dispatch mechanism to use: Mirror already built — promote via Read references/loan-dashboard.md once the tool grants above are added.
• Disambiguation to carry forward: "loan portfolio" / "loans I've made" / "draw balance" → Loan Dashboard (once live); "my LP portfolio" / "LP investments" → out of scope, suggest /carta-lp-reporting-routing (do not confuse loan portfolio with LP portfolio — these are different products, "loan" vs "LP").