psp-onboarding

PSP Onboarding — first-run setup

Walks the operator through ~15 minutes of setup that makes every downstream PSP 10x more useful than generic framework prose.

Activation

Loaded automatically by the psp orchestrator when brand-config.json or SOUL.md is missing from the project root.

Also user-invocable: "Set up PSP brand config", "PSP onboarding", "Configure PSP".

Why this exists

A generic PSP that says "Series-B SaaS feels pipeline pressure" is worse than no PSP — it produces outreach that everyone else is also producing. The 5-component PSP framework only generates real differentiation when paired with:

• Your ICP precision (segment, exclusion, motion)
• Your buyer's actual vocabulary (sourced from real writing, not invented)
• Your stories (signal-to-pain mappings you've seen succeed or fail before)
• Your won't-chase boundaries

Workflow

Step 0 — Detect prior state

Check for existing brand-config.json + SOUL.md. If both exist, ask: "Refresh, or skip?" If one exists, fill the gap.

Step 1 — ICP precision

First, ICP. Be specific — "B2B SaaS" is too broad.

Tell me in one batch:
1. The 1-sentence segment (stage / size / motion / region)
2. The size range ($M ARR)
3. The motion (PLG / sales-led / hybrid)
4. The 3-5 exclusion criteria (who you don't sell to)

If your ICP is fuzzy, that's a finding — outreach against a fuzzy ICP
will be fuzzy. We can use placeholders for now and flag them for refresh
after 100 sends.

Save to brand-config.icp.

Step 2 — Primary PSP draft

Now your primary PSP. Five components:

1. SIGNAL — what's a public, recent, verifiable thing your buyer does
   that implies the pain? (job post, funding round, leadership change,
   product launch, pricing change)
2. PAIN — what's the felt operational reality at 11am Tuesday when
   that signal is present? In their language, not yours.
3. TIMING TRIGGER — which 90-day window makes the pain acute now:
   new-exec / budget-cycle / obvious-failure?
4. FELT-PAIN ROLE — who at the buyer feels it most? (Often a layer
   below the buying authority.)
5. VOCABULARY — 4-8 phrases the buyer uses in private about this. If
   you don't know yet, that's step 3.