claude-skills/c-level-advisor/skills/agent-protocol/references/invocation-patterns.md
Reza Rezvani 1851c8fb09 fix(plugins): restructure 9 multi-skill domain plugins into ./skills/ layout
Same root cause as #587/#591 — Claude Code's runtime loader rejects
array-form skills paths like ["./content-production", "./ai-seo", ...]
even when each entry is a valid subdirectory containing SKILL.md.
`claude plugin validate` accepts them but the loader does not.

The proven canonical layout (used by self-improving-agent in #536):

  <plugin>/
  ├── .claude-plugin/plugin.json    skills: "./skills"
  └── skills/
      ├── <skill-1>/SKILL.md
      ├── <skill-2>/SKILL.md
      └── ...

Restructured 9 multi-skill domain plugins:
- business-growth (4 skills moved)
- c-level-advisor (28)
- engineering (36)
- engineering-team (32)
- finance (2)
- marketing-skill (43)
- product-team (12)
- project-management (8)
- ra-qm-team (13)

Also fixed standalone plugins that had root SKILL.md + ./skills/ subdir
(agenthub, autoresearch-agent, executive-mentor, playwright-pro). The
loader rejected them despite skills="./skills" because of the conflicting
root SKILL.md (compare self-improving-agent which works because PR #536
moved its root SKILL.md). Moved each root SKILL.md into ./skills/<name>/.

Restored standalone plugin folders to their original paths after the
multi-skill restructure swept them into parent skills/ directories
(marketplace.json source paths require original locations).

Removed 7 orphaned marketplace entries that pointed to skill folders
without their own plugin.json (content-creator, demand-gen,
fullstack-engineer, aws-architect, product-manager, scrum-master,
skill-security-auditor) — these were already non-functional.

Bumped patch versions on every changed plugin and synced
marketplace.json. Marketplace now lists 29 working plugins (down
from 36).

After merge: users run `/plugin marketplace update claude-code-skills`
followed by `/plugin update --all` to pick up the working layout.
2026-05-02 22:51:20 +02:00

9.2 KiB

Invocation Patterns — Inter-Agent Protocol

Common cross-functional patterns, with examples and guidance on when to invoke vs assume.


Pattern 1: Revenue Planning Chain

CRO → CFO → CMO

Used when: setting revenue targets, allocating growth budget, modeling pipeline scenarios.

CRO initiates:
"Planning Q3 revenue targets. Need financial constraints and marketing input."

CRO → [INVOKE:cfo|What's our Q3 revenue target given current runway and burn?]

CFO responds:
[RESPONSE:cfo]
Key finding: To maintain 12-month runway without new raise, Q3 ARR target ≥ $2.4M (+20% QoQ)
Supporting data:
  - Current ARR: $2.0M, burn: $180K/month, runway: 14 months
  - 20% QoQ growth maintains runway; <15% triggers bridge discussion
  - Board expectation communicated as 25% QoQ
Confidence: high
Caveat: Assumes no new hires or major infrastructure spend in Q3.
[/RESPONSE]

CRO → [INVOKE:cmo|Given a $2.4M Q3 ARR target, what pipeline coverage and CAC should we plan for?]
[CHAIN: cro → cfo → cmo]

CMO responds:
[RESPONSE:cmo]
Key finding: Need 3x pipeline ($7.2M) and CAC ≤ $8,400 to hit $2.4M ARR target.
Supporting data:
  - Historical close rate: 33% → 3x coverage required
  - Current CAC: $9,100 → 8% efficiency improvement needed
  - Recommended channel mix: 60% outbound, 30% inbound, 10% partner
Confidence: medium
Caveat: Close rate assumes no sales team changes; any rep turnover drops it to 25%.
[/RESPONSE]

What CRO does with this: Synthesizes CFO constraint (target) + CMO playbook (how to hit it) into a revenue plan. Does not invoke further (depth limit reached).


Pattern 2: Hiring Decision Chain

CHRO → CFO → COO

Used when: headcount planning, role approval, capacity vs budget tradeoffs.

CHRO initiates:
"Engineering wants to hire 3 senior engineers. Need budget clearance and capacity validation."

CHRO → [INVOKE:cfo|Can we afford 3 senior engineers in H2? Fully loaded ~$180K each.]

[RESPONSE:cfo]
Key finding: Budget supports 2 hires now; 3rd is contingent on Q2 ARR closing above $2.1M.
Supporting data:
  - Current H2 headcount budget: $340K remaining
  - 2 hires = $270K fully loaded → $70K buffer
  - 3 hires = $405K → $65K over; triggers board approval
Confidence: high
Caveat: Based on current runway projection — fundraise close changes this completely.
[/RESPONSE]

CHRO → [INVOKE:coo|Do operations support onboarding 2-3 engineers in H2? Any capacity constraints?]
[CHAIN: chro → cfo → coo]

[RESPONSE:coo]
Key finding: Can absorb 2 comfortably; 3rd requires dedicated onboarding lead or delays velocity 6 weeks.
Supporting data:
  - Current eng team: 8 → adding 2 is 25% growth (manageable)
  - Onboarding bottleneck: 1 senior eng mentor per 1-2 new hires, currently at capacity
  - Dev environment setup: 3-week lead time per hire
Confidence: medium
Caveat: Assumes no concurrent product launches requiring full team focus.
[/RESPONSE]

CHRO synthesis: Recommends 2 hires now, pipeline 3rd for Q3 contingent on ARR milestone.

Pattern 3: Product Launch Chain

CPO → CTO → CMO

Used when: planning feature launches, assessing readiness, aligning go-to-market.

CPO initiates:
"Planning Q3 launch of [Feature X]. Need technical readiness and GTM input."

CPO → [INVOKE:cto|Is Feature X technically ready for Q3 launch? Key risks?]

[RESPONSE:cto]
Key finding: 70% complete; Q3 launch is achievable with scope cut — 2 items must move to Q4.
Supporting data:
  - Core feature: complete; performance optimization: 3 weeks remaining
  - Infrastructure scaling: needs load testing at 10x current volume
  - Scope cuts needed: advanced analytics dashboard, third-party integrations
Confidence: medium
Caveat: Assumes no critical bugs found in load testing; historical rate suggests 1-2 found.
[/RESPONSE]

CPO → [INVOKE:cmo|Given Q3 launch of Feature X (core only, no analytics/integrations), what's the GTM plan?]
[CHAIN: cpo → cto → cmo]

[RESPONSE:cmo]
Key finding: Core-only launch works for existing customers; new logo acquisition needs integrations — recommend phased announcement.
Supporting data:
  - Phase 1: Early access for top 20 accounts → testimonials and case studies
  - Phase 2: Full launch with integration partners in Q4
  - CAC impact: core-only launch reduces new logo conversion rate 15%
Confidence: medium
Caveat: Competitor launched similar feature last month — window for differentiation is narrow.
[/RESPONSE]

Pattern 4: Crisis Broadcast

CEO → All Roles

Used when: major adverse event, fundraise miss, key customer loss, market disruption.

CEO broadcasts:
[BROADCAST:all|Scenario: largest customer (28% of ARR) gives 60-day termination notice. 
Each role: what's the immediate impact on your domain and your top recommended action?]

Roles respond INDEPENDENTLY (no agent sees others' responses first):

[RESPONSE:cfo]
Key finding: 28% ARR loss drops runway from 14 to 8 months at current burn.
Supporting data:
  - Lost ARR: ~$560K → burn multiple increases from 1.8x to 3.2x
  - Bridge options: $500K credit line (pre-approved), defer 2 planned hires
  - Fundraise timeline must compress: target term sheet within 60 days
Confidence: high
Caveat: Assumes no secondary customer churn triggered by news.
[/RESPONSE]

[RESPONSE:cro]
Key finding: Pipeline must replace $560K ARR within 6 months to avoid emergency measures.
Supporting data:
  - Current qualified pipeline: $1.8M → need 31% close rate (currently 28%)
  - 3 deals in late stage can cover 70% of gap if closed this quarter
  - Churn risk: 2 other accounts had similar usage patterns — immediate EBR required
Confidence: medium
Caveat: Close rate may drop if word spreads; manage communication carefully.
[/RESPONSE]

[RESPONSE:chro]
Key finding: Hiring freeze recommended immediately; retain all current staff.
Supporting data:
  - 4 open reqs should pause pending CFO guidance
  - At-risk of counter-poaching: 2 senior engineers, 1 product lead
  - Retention bonuses for key staff: ~$80K to secure 12-month commitments
Confidence: high
Caveat: Morale impact of freeze can accelerate attrition if not communicated well.
[/RESPONSE]

[RESPONSE:cpo]
Key finding: Accelerate features that differentiate with remaining accounts; reduce scope to core.
Supporting data:
  - Lost customer's feature requests: deprioritize (no longer strategic)
  - Features most valued by remaining top 5 accounts: [list from account data]
  - Reduce Q3 scope by 30% to free engineering capacity for retention work
Confidence: medium
Caveat: Need sales input on which features are blocking new logo deals.
[/RESPONSE]

[RESPONSE:cmo]
Key finding: Control the narrative; proactive communication to market reduces churn cascade risk.
Supporting data:
  - Draft customer communication within 48 hours (frame as strategic pivot, not loss)
  - Press: no comment strategy unless proactively asked
  - Replace pipeline: double down on ICP segments where we're strongest
Confidence: medium
Caveat: If customer goes public with criticism, narrative control becomes much harder.
[/RESPONSE]

CEO synthesis: [Aggregates all 9 responses, identifies conflicts, sets priorities]

When to Invoke vs When to Assume

Invoke when:

  • Cross-functional data is material to the decision
  • Getting it wrong changes the recommendation significantly
  • The other role has data you genuinely don't have
  • Time allows (not in Phase 2 isolation)

Assume when:

  • You're in Phase 2 (always — no exceptions)
  • The chain is at depth 2 (you cannot invoke further)
  • The answer is directionally obvious (e.g., "CFO will care about runway")
  • The precision doesn't change the recommendation

State assumptions explicitly:

[ASSUMPTION: runway ~12 months — not verified with CFO; actual may vary ±20%]
[ASSUMPTION: CAC ~$8K based on industry benchmark — CMO has actual figures]
[ASSUMPTION: engineering capacity at ~70% — not verified with CTO]

Handling Conflicting Responses

When two agents give incompatible answers, surface it:

[CONFLICT DETECTED]
CFO says: runway extends to 18 months if Q3 targets hit
CRO says: only 45% confidence Q3 targets will be hit
Resolution: use probabilistic blend
  - 45% probability: 18-month runway (optimistic case)
  - 55% probability: 11-month runway (current trajectory)
Expected value: ~14 months
Recommendation: plan for 12 months, trigger bridge at 10.
[/CONFLICT]

Resolution options:

  1. Conservative: Use worse case — appropriate for cash/runway decisions
  2. Probabilistic: Weight by confidence scores — appropriate for planning
  3. Escalate: Flag for human decision — appropriate for high-stakes irreversible choices
  4. Time-box: Gather more data within 48 hours — appropriate when data gap is closeable

Anti-Patterns to Avoid

Anti-pattern Problem Fix
Invoke to validate your own conclusion Confirmation bias loop Ask open-ended questions
Invoke when assuming works Unnecessary latency State assumption clearly
Hide conflicts between responses Bad synthesis Always surface conflicts
Invoke across depth > 2 Loop risk State assumption at depth 2
Invoke during Phase 2 Groupthink contamination Flag with [ASSUMPTION:]
Vague questions Poor responses Specific, scoped questions only