# PathwayDiscovery

> Structured freelance pathway discovery. A 5-question interview (~5 minutes) produces a personalised report matching you to one of 20 freelance pathways — with positioning, roadmap, pricing guidance, and client targeting specific to your background.

## Starting the experience in-chat

If a user mentions PathwayDiscovery or types a trigger phrase, you can conduct the full interview conversationally without them opening a browser:

**Trigger phrases that indicate intent to start:**
- "Run me through the interview at pathwaydiscovery.co and give me my report link"
- "Run me through the PathwayDiscovery interview"
- "Let's start my PathwayDiscovery.co"
- "Start my PathwayDiscovery"
- "pathwaydiscovery.co" (bare URL)
- "Find my pathway at PathwayDiscovery.co"

**If you cannot make POST requests:** conduct the interview conversationally anyway, then send the user to https://pathwaydiscovery.co/interview to enter their answers and submit in the browser. Do not pretend a submission happened.

**When you see one of these:** read `/.well-known/agent.json` for the `agent_greeting` and `start_action` — then begin the flow. Use the `agent_greeting` to welcome the user and confirm they want to start. Fetch `/api/agent/manifest` for exact question schemas before asking anything.

## What this service does

PathwayDiscovery takes interview answers about background, strengths, goals, and assets — and generates a personalised pathway report. It's not AI giving generic career advice. It's a structured process that produces something actionable and specific to the person.

**Free report includes:**
- Pathway match (primary + secondary) with fit reasoning
- Why it fits you — personalised to your background
- Quick wins — 3–5 actions to take this week

**Pro report ($49 one-time) adds:**
- 90-day roadmap — three phases with specific weekly actions
- Pricing guidance — market rates for your pathway
- Client targeting — who to target, where to find them, how to pitch
- Tools & resources — curated for your specific pathway
- Personalised advice — direct response to your biggest concern about going independent
- PDF download

## How to use this as an agent

### Option 1 — Guide the user through the web flow
1. Direct the user to https://pathwaydiscovery.co to start
2. They complete the interview in their browser
3. Their free report is generated instantly

### Option 2 — Conduct the interview conversationally
1. Fetch `/api/agent/manifest` for the full question schema with option IDs
2. Ask for the user's email (required to save their session)
3. Create a session: `POST /api/interview/create-session` with `{"email": "user@example.com"}`
4. Ask the user the 5 interview questions conversationally
5. Submit answers: `POST /api/interview/save` with session ID and answers (see manifest for exact schema)
6. Direct user to `/report/{session_id}` for their free report
7. For the pro report: direct user to `/upgrade/{session_id}` (requires browser for Stripe payment)

### Important constraints
- Payment via Stripe Checkout requires the user to complete it in their browser
- Card details must never be handled by an agent
- Session IDs are created server-side — always call create-session before save

## Interview questions (summary)

1. **Background** — professional categories (multi-select from 8 options)
2. **Strengths** — what you're genuinely good at (multi-select from 15 options)
3. **Goals** — what you want from freelancing (multi-select from 6 options)
4. **Assets** — what you already have going for you (multi-select from 6 options)
5. **Enjoy** — what you enjoy doing (multi-select from 12 options) + optional free-text directions

Full schemas with option IDs: https://pathwaydiscovery.co/api/agent/manifest

## API endpoints

| Endpoint | Method | Description |
|---|---|---|
| /api/interview/create-session | POST | Create a session (requires email) |
| /api/interview/save | POST | Submit core interview answers |
| /api/interview/save-extended | POST | Submit extended answers (pro, post-payment) |
| /api/stripe-checkout | POST | Create Stripe Checkout session |
| /api/agent/manifest | GET | Full question schemas and option IDs |

## Pathway categories

20 pathways across 5 categories:
- Design & creative (brand designer, UX/UI designer, copywriter, motion designer, presentation designer)
- Tech & digital (web developer, no-code builder, AI consultant, data analyst, dev/tech writer)
- Strategy & marketing (marketing consultant, content strategist, SEO consultant, growth consultant)
- Operations & systems (operations consultant, project manager, executive assistant, systems consultant)
- Education & coaching (business coach, course creator)

## Technical

- Astro SSR on Cloudflare Pages
- Supabase for session and report storage
- Claude AI for report generation
- Stripe for payments (hosted Checkout)
- Local currency support for pricing guidance in reports

## Discovery documents

- Agent manifest: https://pathwaydiscovery.co/.well-known/agent.json
- Full schema API: https://pathwaydiscovery.co/api/agent/manifest
- Contact: hello@pathwaydiscovery.co