setup

name: setup description: Initial setup for the family planner. Interviews the planner one question at a time to create a planner profile, add family members, and seed event sources. Run once to get started. user-invocable: true

Setup

Purpose

Walk the user through first-time setup of the family planner. By the end, you will have created:

• ./planner.md — the main planner profile
• One or more files in ./profiles/ — family member profiles
• ./sources/sources.md — at least a starter list of event sources

Behavior

• Ask one question at a time. Wait for the answer before continuing.
• Be warm and conversational — this is a setup wizard, not a form.
• Use answers to inform later questions (e.g. if they mention young kids, ask about nap schedules when building profiles).
• If any setup files already exist, read them first and skip questions already answered. Offer to update instead.

Interview Flow

Phase 1 — Planner Profile

Work through these naturally, not as a rigid list:

1. Name — "Let's get started. What's your name?"
2. Location — city and neighborhood or region (this becomes the default search area)
3. How far are you willing to travel? — e.g. within 15 min, within 30 min, open to day trips
4. Budget range — free only, low-cost, no limit, or a rough per-outing budget
5. When do you typically plan? — Friday evenings, Saturday mornings, spontaneous, etc.
6. Any recurring commitments to work around? — sports practice, nap times, standing obligations
7. What does a great weekend look like for your family?

Once you have enough, save ./planner.md (format below) before moving to Phase 2.

Phase 2 — Family Members

Transition naturally: "Now let's set up profiles for your family so we can personalize recommendations."

For each family member, run the same interview as the add-family-member skill:

• Name, role, age
• Interests and activity preferences
• Things to avoid
• Constraints
• Favorite past activities

Ask "Who's in your family?" to get the full list first, then work through each person one at a time. Save each to ./profiles/<first-name-lowercase>.md as you go.

Phase 3 — Sources

Transition: "Last step — let's find some good sources for local events."

1. Offer to auto-research sources based on their location: "Want me to find some good event sites for [location], or do you have favorites you'd like to add?"
2. If researching: search for 5–8 locally relevant event and activity sources. Present them and let the user approve.
3. If they have URLs: collect them one at a time and add each.
4. Save all approved sources to ./sources/sources.md.

Wrap Up

Once all three phases are done:

• Summarize what was created (files written, family members added, sources saved)
• Let them know they can run /weekend-planner to generate their first plan
• Offer to add more family members or sources anytime with /add-family-member or /add-source

Planner Profile Format

Save to ./planner.md:

# Planner Profile

**Name:** [name]
**Location:** [city, neighborhood or region]
**Max Travel Distance:** [e.g. 30 minutes, open to day trips]
**Budget:** [e.g. free–$50 per outing, no limit]
**Planning Window:** [e.g. Friday evening for the weekend ahead]

## Great Weekend
[A sentence or two in their words describing what a great weekend looks like]

## Recurring Commitments
- [commitment 1]
- [commitment 2]

## Notes
[Anything else relevant to planning]

Omit any section with nothing to say.