Premium: Interactive AI-guided profile setup wizard #77

New issue

Open

opened 2026-04-10 22:20:14 -07:00 by pyr0ball · 0 comments

pyr0ball commented

2026-04-10 22:20:14 -07:00

Owner

Context: Blank-form onboarding is a known friction point, especially for ND users who struggle with open-ended fields. A conversational setup flow removes that barrier and ensures the profile is populated with enough signal for quality AI generation from the start.

Scope:

Conversational interview flow accessible from onboarding and from Settings
LLM conducts a structured interview: recent role, writing voice, mission preferences, job search goals
LLM synthesizes natural-language answers into structured YAML profile fields
Graceful handling of partial answers (user can skip or return later)
Tier gate: Paid tier (or BYOK-unlockable); graceful degradation to manual form fields on Free

Out of scope: Ongoing AI coaching or post-setup re-interviews (separate feature); resume parsing (handled by existing import flow, though output can seed the wizard).

Acceptance criteria:

User can enter the wizard from the onboarding sequence and from the Settings profile page
Completing the wizard populates the same profile fields as manual entry (no divergent schema)
Free/BYOK users see the manual form; Paid users are offered the wizard as the default path
Wizard output passes existing profile validation without manual correction in the common case

Related: circuitforge-plans/peregrine/ — no existing design doc; scope this before implementation

**Context:** Blank-form onboarding is a known friction point, especially for ND users who struggle with open-ended fields. A conversational setup flow removes that barrier and ensures the profile is populated with enough signal for quality AI generation from the start. **Scope:** - [ ] Conversational interview flow accessible from onboarding and from Settings - [ ] LLM conducts a structured interview: recent role, writing voice, mission preferences, job search goals - [ ] LLM synthesizes natural-language answers into structured YAML profile fields - [ ] Graceful handling of partial answers (user can skip or return later) - [ ] Tier gate: Paid tier (or BYOK-unlockable); graceful degradation to manual form fields on Free **Out of scope:** Ongoing AI coaching or post-setup re-interviews (separate feature); resume parsing (handled by existing import flow, though output can seed the wizard). **Acceptance criteria:** - [ ] User can enter the wizard from the onboarding sequence and from the Settings profile page - [ ] Completing the wizard populates the same profile fields as manual entry (no divergent schema) - [ ] Free/BYOK users see the manual form; Paid users are offered the wizard as the default path - [ ] Wizard output passes existing profile validation without manual correction in the common case **Related:** `circuitforge-plans/peregrine/` — no existing design doc; scope this before implementation