onboarding

# COG Onboarding Skill

## Purpose
Welcome new users and collect essential information to personalize their COG experience. All configuration is stored as natural markdown files within the vault structure, following COG's philosophy of transparent, editable knowledge.

## When to Invoke
- User explicitly requests `/onboarding` or mentions "onboarding" or "setup COG"
- User is new and hasn't completed onboarding yet
- User wants to update their profile or add new projects
- Any time profile customization is needed

## Core Design Principle: Smart, Low-Friction Onboarding

**The onboarding MUST feel like a natural conversation, NOT a form to fill out.**

Key rules:
- **Ask open-ended questions, not option-pickers.** Never present numbered lists of choices for the user to pick from.
- **Ask as few questions as possible.** Infer what you can from context and the user's natural responses.
- **Never ask redundant questions.** If you can extract the answer from something the user already said, don't ask again.
- **Parse intelligently.** If someone says "I'm Alex, a PM at a fintech startup tracking Stripe and Plaid", extract: name=Alex, role=PM at fintech startup, watchlist=[Stripe, Plaid]. Don't ask follow-up questions for info already given.
- **Confirm, don't re-ask.** If you're unsure about something the user said, confirm your interpretation rather than asking the question fresh.

## Process Flow

### 1. Welcome Message
Greet the user warmly and explain what COG is:
```
Welcome to COG - your self-evolving second brain powered by Claude + Obsidian + Git!

COG helps you capture thoughts, get daily intelligence briefings, and build knowledge over time - all stored as simple markdown files you own.

Let's get you set up. Tell me a bit about yourself - your name, what you do, and what topics or areas you're most interested in staying sharp on. Feel free to share as much or as little as you'd like.
```

**This single open-ended prompt replaces the old sequential questions.** The user can naturally mention their name, role, interests, sources, projects, and competitors all at once - or just share a few things.

### 2. Check for Existing Profile

Look for `00-inbox/MY-PROFILE.md`. If it exists:
```
I found an existing COG profile! What would you like to update? Just tell me what you'd like to change - your interests, projects, profile info, or anything else.
```

**Don't present a numbered menu.** Let them describe what they want in natural language.

### 3. Intelligent Information Extraction

After the user responds, extract as much as possible from their natural language:

| Field | How to Extract |
|-------|---------------|
| **Name** | Look for self-introduction patterns ("I'm Alex", "My name is...", "Call me..."). Use first name by default. |
| **Role** | Look for job/activity mentions ("I'm a PM", "I work in...", "software engineer at..."). |
| **Interests** | Look for topic mentions ("interested in AI", "following crypto", "love design"). Also infer from role context. |
| **News Sources** | Look for source mentions ("I read HN", "follow on Twitter"). If not mentioned, skip - it's optional. |
| **Projects** | Look for project mentions ("working on a SaaS app", "building..."). If not mentioned, skip. |
| **Competitive Watch** | Look for company/person mentions ("tracking Stripe", "watching what OpenAI does"). If not mentioned, skip. |

### 4. Smart Follow-Up (Only If Needed)

After extracting what you can, check what's missing from the **required** fields only:
- **Name** (required)
- **Role** (required)
- **Interests** (required - need at least 2-3 topics)

If any required field is missing, ask ONE follow-up that covers all gaps. For example:
```
Thanks! I got your name and role. What topics are you most interested in staying updated on? (e.g., AI, startups, design, health - whatever matters to you)
```

**Optional fields** (news sources, projects, competitive watch) should NEVER generate follow-up questions. If the user didn't mention them, skip them. They can always add them later by editing the files or running onboarding again.

### 5. Confirm and Create

Before creating files, briefly confirm what you captured and ask about agent team mode:
```
Here's what I've got:

- **Name**: Alex
- **Role**: Product Manager at a fintech startup
- **Interests**: AI/ML, fintech trends, product strategy, UX design
- **Projects**: Payments dashboard revamp
- **Tracking**: Stripe, Plaid

One more thing - COG can run in two modes:
- **Solo mode** (default): I handle everything directly in our conversation.
- **Agent team mode**: I delegate research, analysis, and writing to specialist sub-agents for deeper, more thorough results. Works best with Claude Code.

Which do you prefer? (Solo is great for most people - team mode is for power users who want maximum depth.)
```

**Wait for confirmation**, then generate everything. If they say "looks good" or similar, proceed. If they correct something, update and proceed without re-confirming. Default to `solo` if they don't express a preference.

### 5.5. Role Pack Matching

After extracting the user's role text in Step 3, scan `.claude/roles/*.md` for a matching role pack:

1. Read each role pack file's YAML frontmatter (`role_id` and `aliases`)
2. Compare the user's extracted role text (case-insensitive) against:
   - Exact `role_id` match (e.g., "product-manager")
   - Any string in `aliases` (e.g., "pm", "product lead", "head of product")
   - Fuzzy substring match (e.g., "product manager at a fintech startup" contains "product manager")
3. If a match is found:
   - Store the matched `role_id` as `role_pack` in the MY-PROFILE.md frontmatter
   - Present role-specific recommendations:
   ```
   As a [Role Display Name], here are the skills and integrations that'll be most useful for you:

   **Recommended skills** (ordered by relevance for your role):
   [List top 5-6 skills from the role pack with the "Why it matters for you" context]

   **Recommended integr