+
+ {MASCOT_EMOJI}
+
One more thing.
@@ -266,8 +349,8 @@ function FunnelPersonaQuizComponent({
color={TypographyColor.Secondary}
className="max-w-md"
>
- Tick any of these that describe you. They tune your feed beyond
- your persona.
+ Tick any of these that describe you. They tune your feed beyond your
+ persona.
{modifiers.map((modifier) => {
@@ -318,35 +401,50 @@ function FunnelPersonaQuizComponent({
- {selectedModifierIds.length === 0 ? 'None of these โ continue' : 'Continue โ'}
+ {selectedModifierIds.length === 0
+ ? 'None of these โ continue'
+ : 'Continue โ'}
);
}
if (phase === 'reveal' && result) {
- const { persona, modifiers: selectedIds } = result;
- const appliedModifiers = modifiers.filter((m) =>
- selectedIds.includes(m.id),
- );
+ const { persona } = result;
return (
-
-
- {persona.emoji}
-
+
+
+
+ {persona.emoji}
+
+
{persona.name}
@@ -354,30 +452,20 @@ function FunnelPersonaQuizComponent({
{persona.tagline}
- {appliedModifiers.length > 0 && (
-
- {appliedModifiers.map((modifier) => (
-
- {modifier.emoji}
-
- {modifier.label}
-
-
- ))}
-
- )}
-
+
{cta || "Yes, that's me!"}
@@ -396,14 +484,27 @@ function FunnelPersonaQuizComponent({
}
return (
-
+
{MASCOT_EMOJI}
-
+
{questionText}
-
-
answer(1)}
+
+
- Yes
-
- answer(0.5)}
- >
- Not sure
-
- answer(0)}
- >
- No
-
+ handleAnswer(1)}
+ >
+ Yes
+
+ handleAnswer(0.5)}
+ >
+ Not sure
+
+ handleAnswer(0)}
+ >
+ No
+
+
+ {isThinking && (
+
+
+ )}
diff --git a/packages/shared/src/features/onboarding/steps/persona/usePersonaQuiz.ts b/packages/shared/src/features/onboarding/steps/persona/usePersonaQuiz.ts
index 937c27ce965..42123300206 100644
--- a/packages/shared/src/features/onboarding/steps/persona/usePersonaQuiz.ts
+++ b/packages/shared/src/features/onboarding/steps/persona/usePersonaQuiz.ts
@@ -8,12 +8,7 @@ import {
updateBelief,
} from './engine';
import type { DeveloperPersona, PersonaModifier } from './data';
-import {
- MODIFIERS,
- PERSONAS,
- PERSONA_ENGINE_CONFIG,
- QUESTIONS,
-} from './data';
+import { MODIFIERS, PERSONAS, PERSONA_ENGINE_CONFIG, QUESTIONS } from './data';
export type PersonaQuizPhase =
| 'intro'
@@ -27,6 +22,12 @@ export type PersonaQuizPhase =
/** UI-only pause so the belief shift feels deliberate; not a game tunable. */
const THINKING_DURATION_MS = 450;
+const ANSWER_LABELS: Record
= {
+ 0: 'no',
+ 0.5: 'not sure',
+ 1: 'yes',
+};
+
const {
confidenceThreshold,
tiebreakThreshold,
@@ -69,8 +70,8 @@ export interface PersonaQuizState {
chooseTiebreak: (personaId: string) => void;
pickManually: () => void;
selectPersona: (personaId: string) => void;
+ confirmPersona: () => void;
toggleModifier: (modifierId: string) => void;
- confirmModifiers: () => void;
restart: () => void;
}
@@ -84,30 +85,38 @@ export const usePersonaQuiz = (): PersonaQuizState => {
const [resultIndex, setResultIndex] = useState(null);
const [isManual, setIsManual] = useState(false);
const [selectedModifierIds, setSelectedModifierIds] = useState([]);
- /** True once the user has confirmed (or skipped) the modifier screen. */
- const [modifiersConfirmed, setModifiersConfirmed] = useState(false);
const askedRef = useRef>(new Set());
const excludedGroupsRef = useRef>(new Set());
+ const answerLogRef = useRef<
+ Array<{ id: string; text: string; answer: string }>
+ >([]);
const thinkingTimeout = useRef>();
- const goToModifiers = useCallback(
- (index: number, nextBelief: number[]) => {
- setResultIndex(index);
- setTiebreak(null);
- setBelief(nextBelief);
- setSelectedModifierIds([]);
- setModifiersConfirmed(false);
- setPhase('modifiers');
- },
- [],
- );
-
- /** Reveal the final persona (called after modifiers are confirmed). */
- const reveal = useCallback(() => {
+ // Quiz paths land on the reveal first, so the user can approve Patchy's
+ // guess before the modifiers screen.
+ const revealGuess = useCallback((index: number, nextBelief: number[]) => {
+ setResultIndex(index);
+ setTiebreak(null);
+ setBelief(nextBelief);
+ setSelectedModifierIds([]);
setPhase('reveal');
}, []);
+ // Manual selection skips straight to the modifiers screen.
+ const goToModifiers = useCallback((index: number, nextBelief: number[]) => {
+ setResultIndex(index);
+ setTiebreak(null);
+ setBelief(nextBelief);
+ setSelectedModifierIds([]);
+ setPhase('modifiers');
+ }, []);
+
+ // Approve Patchy's guess from the reveal screen.
+ const confirmPersona = useCallback(() => {
+ setPhase('modifiers');
+ }, []);
+
const finish = useCallback(
(nextBelief: number[]) => {
const ranked = rankBelief(nextBelief);
@@ -120,13 +129,13 @@ export const usePersonaQuiz = (): PersonaQuizState => {
top.belief >= tiebreakThreshold &&
top.belief - runnerUp.belief >= tiebreakMargin
) {
- goToModifiers(top.index, nextBelief);
+ revealGuess(top.index, nextBelief);
return;
}
// 2. Belief is too diffuse: fall back to the generalist.
if (top.belief < fallbackFloor) {
- goToModifiers(FALLBACK_PERSONA_INDEX, nextBelief);
+ revealGuess(FALLBACK_PERSONA_INDEX, nextBelief);
return;
}
@@ -150,9 +159,9 @@ export const usePersonaQuiz = (): PersonaQuizState => {
return;
}
- goToModifiers(top.index, nextBelief);
+ revealGuess(top.index, nextBelief);
},
- [goToModifiers],
+ [revealGuess],
);
const advance = useCallback(
@@ -195,6 +204,7 @@ export const usePersonaQuiz = (): PersonaQuizState => {
const start = useCallback(() => {
askedRef.current = new Set();
excludedGroupsRef.current = new Set();
+ answerLogRef.current = [];
const fresh = initialBelief();
setBelief(fresh);
setResultIndex(null);
@@ -202,7 +212,6 @@ export const usePersonaQuiz = (): PersonaQuizState => {
setIsThinking(false);
setIsManual(false);
setSelectedModifierIds([]);
- setModifiersConfirmed(false);
setQuestionsShown(0);
setPhase('playing');
advance(fresh, 0);
@@ -219,6 +228,15 @@ export const usePersonaQuiz = (): PersonaQuizState => {
setBelief(nextBelief);
setIsThinking(true);
+ answerLogRef.current.push({
+ id: `q${currentQuestion}`,
+ text: question.text,
+ answer: ANSWER_LABELS[value],
+ });
+ // Debug aid: full answer history with question ids.
+ // eslint-disable-next-line no-console
+ console.log('[persona-quiz] answers', answerLogRef.current);
+
if (value === 1 && question.exclusiveGroup) {
excludedGroupsRef.current.add(question.exclusiveGroup);
}
@@ -231,7 +249,7 @@ export const usePersonaQuiz = (): PersonaQuizState => {
(persona) => persona.id === question.lockPersonaId,
);
if (lockIndex >= 0) {
- goToModifiers(lockIndex, nextBelief);
+ revealGuess(lockIndex, nextBelief);
return;
}
}
@@ -239,14 +257,7 @@ export const usePersonaQuiz = (): PersonaQuizState => {
advance(nextBelief, questionsShown);
}, THINKING_DURATION_MS);
},
- [
- advance,
- belief,
- currentQuestion,
- goToModifiers,
- isThinking,
- questionsShown,
- ],
+ [advance, belief, currentQuestion, revealGuess, isThinking, questionsShown],
);
const chooseTiebreak = useCallback(
@@ -255,9 +266,9 @@ export const usePersonaQuiz = (): PersonaQuizState => {
if (index < 0) {
return;
}
- goToModifiers(index, belief);
+ revealGuess(index, belief);
},
- [belief, goToModifiers],
+ [belief, revealGuess],
);
const pickManually = useCallback(() => {
@@ -265,7 +276,6 @@ export const usePersonaQuiz = (): PersonaQuizState => {
setTiebreak(null);
setIsManual(false);
setSelectedModifierIds([]);
- setModifiersConfirmed(false);
setPhase('picker');
}, []);
@@ -290,11 +300,6 @@ export const usePersonaQuiz = (): PersonaQuizState => {
});
}, []);
- const confirmModifiers = useCallback(() => {
- setModifiersConfirmed(true);
- reveal();
- }, [reveal]);
-
const restart = useCallback(() => {
if (thinkingTimeout.current) {
clearTimeout(thinkingTimeout.current);
@@ -308,9 +313,9 @@ export const usePersonaQuiz = (): PersonaQuizState => {
setResultIndex(null);
setIsManual(false);
setSelectedModifierIds([]);
- setModifiersConfirmed(false);
askedRef.current = new Set();
excludedGroupsRef.current = new Set();
+ answerLogRef.current = [];
}, []);
const tiebreakPersonas = useMemo(() => {
@@ -334,9 +339,9 @@ export const usePersonaQuiz = (): PersonaQuizState => {
return {
persona: PERSONAS[resultIndex],
confidence: belief[resultIndex],
- modifiers: modifiersConfirmed ? selectedModifierIds : [],
+ modifiers: selectedModifierIds,
};
- }, [belief, modifiersConfirmed, resultIndex, selectedModifierIds]);
+ }, [belief, resultIndex, selectedModifierIds]);
return {
phase,
@@ -359,8 +364,8 @@ export const usePersonaQuiz = (): PersonaQuizState => {
chooseTiebreak,
pickManually,
selectPersona,
+ confirmPersona,
toggleModifier,
- confirmModifiers,
restart,
};
};
diff --git a/packages/shared/src/features/onboarding/types/funnel.ts b/packages/shared/src/features/onboarding/types/funnel.ts
index b61a1e295d5..83a64dbbc20 100644
--- a/packages/shared/src/features/onboarding/types/funnel.ts
+++ b/packages/shared/src/features/onboarding/types/funnel.ts
@@ -390,6 +390,7 @@ export interface FunnelStepPersonaQuiz
confidence?: number;
questions: number;
manual: boolean;
+ modifiers: string[];
}>;
}
From c2a6382d6eae4edf0296abcd37988b4f2ae838a2 Mon Sep 17 00:00:00 2001
From: Ido Shamun <1993245+idoshamun@users.noreply.github.com>
Date: Thu, 4 Jun 2026 12:23:14 +0300
Subject: [PATCH 13/15] chore(onboarding): fix prettier formatting in persona
data/engine
---
.../features/onboarding/steps/persona/data.ts | 222 +++++++++++++-----
.../onboarding/steps/persona/engine.ts | 5 +-
2 files changed, 164 insertions(+), 63 deletions(-)
diff --git a/packages/shared/src/features/onboarding/steps/persona/data.ts b/packages/shared/src/features/onboarding/steps/persona/data.ts
index 66ccc795aa4..8d0fcc4a967 100644
--- a/packages/shared/src/features/onboarding/steps/persona/data.ts
+++ b/packages/shared/src/features/onboarding/steps/persona/data.ts
@@ -49,96 +49,84 @@ export const PERSONAS: DeveloperPersona[] = [
name: 'Full-Stack Web Developer',
emoji: 'โ๏ธ',
color: '#06b6d4',
- tagline:
- "React, TypeScript, Node, the works. You ship product.",
+ tagline: 'React, TypeScript, Node, the works. You ship product.',
},
{
id: 'frontend-specialist',
name: 'Frontend Specialist',
emoji: '๐จ',
color: '#ec4899',
- tagline:
- "Deep in the framework wars. You sweat the details.",
+ tagline: 'Deep in the framework wars. You sweat the details.',
},
{
id: 'ai-specialist',
name: 'AI Specialist',
emoji: '๐ค',
color: '#22c55e',
- tagline:
- "You live in Claude, agents, and RAG pipelines. AI is your work.",
+ tagline: 'You live in Claude, agents, and RAG pipelines. AI is your work.',
},
{
id: 'backend-developer',
name: 'Backend Developer',
emoji: '๐ ๏ธ',
color: '#3b82f6',
- tagline:
- "SQL, APIs, queues, databases. You make the data move.",
+ tagline: 'SQL, APIs, queues, databases. You make the data move.',
},
{
id: 'software-architect',
name: 'Software Architect',
emoji: '๐๏ธ',
color: '#14b8a6',
- tagline:
- "Microservices, distributed systems, scale. You draw the boxes.",
+ tagline: 'Microservices, distributed systems, scale. You draw the boxes.',
},
{
id: 'systems-programmer',
name: 'Systems Programmer',
emoji: 'โก',
color: '#f97316',
- tagline:
- "Go, Rust, C++. Memory matters. Performance matters.",
+ tagline: 'Go, Rust, C++. Memory matters. Performance matters.',
},
{
id: 'devops-engineer',
name: 'DevOps Engineer',
emoji: '๐ณ',
color: '#0ea5e9',
- tagline:
- "Kubernetes, CI/CD, observability. You keep prod alive.",
+ tagline: 'Kubernetes, CI/CD, observability. You keep prod alive.',
},
{
id: 'php-developer',
name: 'PHP Developer',
emoji: '๐',
color: '#777bb3',
- tagline:
- "Laravel, Symfony, WordPress. The web's quiet workhorse.",
+ tagline: "Laravel, Symfony, WordPress. The web's quiet workhorse.",
},
{
id: 'security-engineer',
name: 'Security Engineer',
emoji: '๐ก๏ธ',
color: '#dc2626',
- tagline:
- "CVEs, authentication, attack surface. You find the bugs first.",
+ tagline: 'CVEs, authentication, attack surface. You find the bugs first.',
},
{
id: 'dotnet-developer',
name: '.NET Developer',
emoji: '๐ฆ',
color: '#512bd4',
- tagline:
- "C#, ASP.NET, Blazor. The Microsoft stack done right.",
+ tagline: 'C#, ASP.NET, Blazor. The Microsoft stack done right.',
},
{
id: 'game-developer',
name: 'Game Developer',
emoji: '๐ฎ',
color: '#a855f7',
- tagline:
- "Unity, Unreal, Godot. You ship frames per second.",
+ tagline: 'Unity, Unreal, Godot. You ship frames per second.',
},
{
id: 'mobile-developer',
name: 'Mobile Developer',
emoji: '๐ฑ',
color: '#f43f5e',
- tagline:
- "iOS, Android, Flutter. The app store is your stage.",
+ tagline: 'iOS, Android, Flutter. The app store is your stage.',
},
{
id: 'tech-strategist',
@@ -146,30 +134,98 @@ export const PERSONAS: DeveloperPersona[] = [
emoji: '๐ผ',
color: '#64748b',
tagline:
- "Product, design, strategy. You shape what gets built without writing the code.",
+ 'Product, design, strategy. You shape what gets built without writing the code.',
},
];
export const QUESTIONS: PersonaQuestion[] = [
- { text: 'You ship the things users see and click on.', layer: 0, exclusiveGroup: 'primary-domain' },
- { text: 'Your work is mostly backend or infrastructure, not frontend or mobile.', layer: 0, exclusiveGroup: 'primary-domain' },
- { text: 'You don\'t write code as part of your day-to-day job.', layer: 0, lockPersonaId: 'tech-strategist' },
- { text: 'Your main output is a web app people open in a browser.', layer: 1, exclusiveGroup: 'primary-platform' },
- { text: 'You\'re faster in a terminal than in any GUI.', layer: 1 },
- { text: 'You build apps for iPhone or Android.', layer: 1, lockPersonaId: 'mobile-developer', exclusiveGroup: 'primary-platform' },
- { text: 'Your day involves Jupyter notebooks, datasets, or training runs.', layer: 1, exclusiveGroup: 'primary-platform' },
- { text: 'Your main language is TypeScript or JavaScript.', layer: 2, exclusiveGroup: 'main-language' },
- { text: 'Your main language is Python.', layer: 2, exclusiveGroup: 'main-language' },
- { text: 'Your main language is Go, Rust, or C/C++.', layer: 2, exclusiveGroup: 'main-language' },
- { text: 'AI is what you build, not just what you use.', layer: 2, lockPersonaId: 'ai-specialist' },
- { text: 'Your main language is PHP.', layer: 2, lockPersonaId: 'php-developer', exclusiveGroup: 'main-language' },
- { text: 'Your main stack is C# / .NET.', layer: 2, lockPersonaId: 'dotnet-developer', exclusiveGroup: 'main-language' },
- { text: 'You\'ve been the one paged at 3am when production went down.', layer: 3 },
+ {
+ text: 'You ship the things users see and click on.',
+ layer: 0,
+ exclusiveGroup: 'primary-domain',
+ },
+ {
+ text: 'Your work is mostly backend or infrastructure, not frontend or mobile.',
+ layer: 0,
+ exclusiveGroup: 'primary-domain',
+ },
+ {
+ text: "You don't write code as part of your day-to-day job.",
+ layer: 0,
+ lockPersonaId: 'tech-strategist',
+ },
+ {
+ text: 'Your main output is a web app people open in a browser.',
+ layer: 1,
+ exclusiveGroup: 'primary-platform',
+ },
+ { text: "You're faster in a terminal than in any GUI.", layer: 1 },
+ {
+ text: 'You build apps for iPhone or Android.',
+ layer: 1,
+ lockPersonaId: 'mobile-developer',
+ exclusiveGroup: 'primary-platform',
+ },
+ {
+ text: 'Your day involves Jupyter notebooks, datasets, or training runs.',
+ layer: 1,
+ exclusiveGroup: 'primary-platform',
+ },
+ {
+ text: 'Your main language is TypeScript or JavaScript.',
+ layer: 2,
+ exclusiveGroup: 'main-language',
+ },
+ {
+ text: 'Your main language is Python.',
+ layer: 2,
+ exclusiveGroup: 'main-language',
+ },
+ {
+ text: 'Your main language is Go, Rust, or C/C++.',
+ layer: 2,
+ exclusiveGroup: 'main-language',
+ },
+ {
+ text: 'AI is what you build, not just what you use.',
+ layer: 2,
+ lockPersonaId: 'ai-specialist',
+ },
+ {
+ text: 'Your main language is PHP.',
+ layer: 2,
+ lockPersonaId: 'php-developer',
+ exclusiveGroup: 'main-language',
+ },
+ {
+ text: 'Your main stack is C# / .NET.',
+ layer: 2,
+ lockPersonaId: 'dotnet-developer',
+ exclusiveGroup: 'main-language',
+ },
+ {
+ text: "You've been the one paged at 3am when production went down.",
+ layer: 3,
+ },
{ text: 'You write more SQL than CSS.', layer: 3 },
- { text: 'You\'ve drawn boxes and arrows on a whiteboard this month.', layer: 3 },
- { text: 'You specialize in one stack. You don\'t dabble across many.', layer: 2 },
- { text: 'You build games or interactive 3D experiences.', layer: 2, lockPersonaId: 'game-developer' },
- { text: 'Security is your primary job, not a side concern.', layer: 2, lockPersonaId: 'security-engineer' },
+ {
+ text: "You've drawn boxes and arrows on a whiteboard this month.",
+ layer: 3,
+ },
+ {
+ text: "You specialize in one stack. You don't dabble across many.",
+ layer: 2,
+ },
+ {
+ text: 'You build games or interactive 3D experiences.',
+ layer: 2,
+ lockPersonaId: 'game-developer',
+ },
+ {
+ text: 'Security is your primary job, not a side concern.',
+ layer: 2,
+ lockPersonaId: 'security-engineer',
+ },
];
export const MODIFIERS: PersonaModifier[] = [
@@ -178,21 +234,20 @@ export const MODIFIERS: PersonaModifier[] = [
label: 'AI Heavy',
emoji: '๐ค',
description:
- "You use AI tools (Cursor, Claude, agents) for meaningful chunks of your work.",
+ 'You use AI tools (Cursor, Claude, agents) for meaningful chunks of your work.',
},
{
id: 'indie-hacker',
label: 'Indie Hacker',
emoji: '๐',
- description:
- "You're building your own product, startup, or side business.",
+ description: "You're building your own product, startup, or side business.",
},
{
id: 'engineering-leader',
label: 'Engineering Leader',
emoji: '๐ฐ',
description:
- "You lead engineers or set technical direction more than you write code.",
+ 'You lead engineers or set technical direction more than you write code.',
},
];
@@ -204,25 +259,68 @@ export const MODIFIERS: PersonaModifier[] = [
* (non-engineers do not appear in the engagement clustering).
*/
export const PERSONA_QUESTION_LIKELIHOOD: number[][] = [
- [0.192, 0.263, 0.0, 0.148, 0.411, 0.005, 0.029, 0.358, 0.16, 0.331, 0.003, 0.002, 0.001, 0.186, 0.244, 0.206, 0.03, 0.001, 0.0],
- [0.956, 0.002, 0.0, 0.955, 0.111, 0.011, 0.008, 0.97, 0.082, 0.189, 0.011, 0.005, 0.001, 0.071, 0.151, 0.103, 0.004, 0.002, 0.0],
- [1.0, 0.0, 0.0, 1.0, 0.035, 0.019, 0.005, 1.0, 0.044, 0.065, 0.0, 0.012, 0.002, 0.011, 0.045, 0.026, 0.826, 0.006, 0.0],
- [0.062, 0.052, 0.0, 0.052, 0.08, 0.006, 0.019, 0.088, 0.131, 0.055, 0.891, 0.007, 0.004, 0.041, 0.04, 0.066, 0.568, 0.002, 0.0],
- [0.095, 0.863, 0.0, 0.099, 0.083, 0.005, 0.015, 0.118, 0.091, 0.078, 0.001, 0.006, 0.002, 0.036, 0.999, 0.136, 0.157, 0.002, 0.0],
- [0.061, 0.214, 0.0, 0.066, 0.066, 0.006, 0.033, 0.114, 0.152, 0.095, 0.016, 0.005, 0.002, 0.048, 0.213, 0.44, 0.043, 0.001, 0.0],
- [0.103, 0.85, 0.0, 0.097, 0.95, 0.006, 0.026, 0.167, 0.126, 0.987, 0.002, 0.005, 0.002, 0.119, 0.159, 0.153, 0.066, 0.002, 0.0],
- [0.073, 0.9, 0.0, 0.07, 0.936, 0.007, 0.02, 0.154, 0.111, 0.172, 0.004, 0.004, 0.001, 0.939, 0.234, 0.196, 0.118, 0.001, 0.0],
- [0.987, 0.13, 0.0, 0.999, 0.12, 0.009, 0.006, 0.343, 0.066, 0.153, 0.001, 0.876, 0.001, 0.096, 0.197, 0.077, 0.137, 0.003, 0.0],
- [0.344, 0.479, 0.0, 0.412, 0.273, 0.014, 0.014, 0.39, 0.1, 0.096, 0.027, 0.028, 0.007, 0.055, 0.077, 0.048, 0.164, 0.009, 0.394],
- [0.1, 0.836, 0.0, 0.099, 0.171, 0.006, 0.005, 0.217, 0.049, 0.163, 0.0, 0.003, 0.824, 0.073, 0.205, 0.222, 0.143, 0.008, 0.0],
- [0.944, 0.001, 0.0, 0.161, 0.166, 0.022, 0.03, 0.247, 0.143, 0.207, 0.001, 0.006, 0.01, 0.034, 0.079, 0.047, 0.136, 0.771, 0.0],
- [0.986, 0.002, 0.0, 0.266, 0.094, 0.989, 0.008, 0.296, 0.077, 0.046, 0.002, 0.007, 0.004, 0.026, 0.101, 0.085, 0.131, 0.01, 0.0],
- [0.2, 0.03, 0.95, 0.05, 0.02, 0.03, 0.05, 0.03, 0.05, 0.01, 0.03, 0.01, 0.01, 0.02, 0.05, 0.4, 0.25, 0.02, 0.03],
+ [
+ 0.192, 0.263, 0.0, 0.148, 0.411, 0.005, 0.029, 0.358, 0.16, 0.331, 0.003,
+ 0.002, 0.001, 0.186, 0.244, 0.206, 0.03, 0.001, 0.0,
+ ],
+ [
+ 0.956, 0.002, 0.0, 0.955, 0.111, 0.011, 0.008, 0.97, 0.082, 0.189, 0.011,
+ 0.005, 0.001, 0.071, 0.151, 0.103, 0.004, 0.002, 0.0,
+ ],
+ [
+ 1.0, 0.0, 0.0, 1.0, 0.035, 0.019, 0.005, 1.0, 0.044, 0.065, 0.0, 0.012,
+ 0.002, 0.011, 0.045, 0.026, 0.826, 0.006, 0.0,
+ ],
+ [
+ 0.062, 0.052, 0.0, 0.052, 0.08, 0.006, 0.019, 0.088, 0.131, 0.055, 0.891,
+ 0.007, 0.004, 0.041, 0.04, 0.066, 0.568, 0.002, 0.0,
+ ],
+ [
+ 0.095, 0.863, 0.0, 0.099, 0.083, 0.005, 0.015, 0.118, 0.091, 0.078, 0.001,
+ 0.006, 0.002, 0.036, 0.999, 0.136, 0.157, 0.002, 0.0,
+ ],
+ [
+ 0.061, 0.214, 0.0, 0.066, 0.066, 0.006, 0.033, 0.114, 0.152, 0.095, 0.016,
+ 0.005, 0.002, 0.048, 0.213, 0.44, 0.043, 0.001, 0.0,
+ ],
+ [
+ 0.103, 0.85, 0.0, 0.097, 0.95, 0.006, 0.026, 0.167, 0.126, 0.987, 0.002,
+ 0.005, 0.002, 0.119, 0.159, 0.153, 0.066, 0.002, 0.0,
+ ],
+ [
+ 0.073, 0.9, 0.0, 0.07, 0.936, 0.007, 0.02, 0.154, 0.111, 0.172, 0.004,
+ 0.004, 0.001, 0.939, 0.234, 0.196, 0.118, 0.001, 0.0,
+ ],
+ [
+ 0.987, 0.13, 0.0, 0.999, 0.12, 0.009, 0.006, 0.343, 0.066, 0.153, 0.001,
+ 0.876, 0.001, 0.096, 0.197, 0.077, 0.137, 0.003, 0.0,
+ ],
+ [
+ 0.344, 0.479, 0.0, 0.412, 0.273, 0.014, 0.014, 0.39, 0.1, 0.096, 0.027,
+ 0.028, 0.007, 0.055, 0.077, 0.048, 0.164, 0.009, 0.394,
+ ],
+ [
+ 0.1, 0.836, 0.0, 0.099, 0.171, 0.006, 0.005, 0.217, 0.049, 0.163, 0.0,
+ 0.003, 0.824, 0.073, 0.205, 0.222, 0.143, 0.008, 0.0,
+ ],
+ [
+ 0.944, 0.001, 0.0, 0.161, 0.166, 0.022, 0.03, 0.247, 0.143, 0.207, 0.001,
+ 0.006, 0.01, 0.034, 0.079, 0.047, 0.136, 0.771, 0.0,
+ ],
+ [
+ 0.986, 0.002, 0.0, 0.266, 0.094, 0.989, 0.008, 0.296, 0.077, 0.046, 0.002,
+ 0.007, 0.004, 0.026, 0.101, 0.085, 0.131, 0.01, 0.0,
+ ],
+ [
+ 0.2, 0.03, 0.95, 0.05, 0.02, 0.03, 0.05, 0.03, 0.05, 0.01, 0.03, 0.01, 0.01,
+ 0.02, 0.05, 0.4, 0.25, 0.02, 0.03,
+ ],
];
/** Prior probability of each persona (log-shaped to balance large and niche personas). */
export const PERSONA_PRIOR: number[] = [
- 0.2163, 0.1645, 0.0746, 0.0754, 0.0732, 0.1093, 0.0543, 0.042, 0.0407, 0.0498, 0.0241, 0.0181, 0.021, 0.0366,
+ 0.2163, 0.1645, 0.0746, 0.0754, 0.0732, 0.1093, 0.0543, 0.042, 0.0407, 0.0498,
+ 0.0241, 0.0181, 0.021, 0.0366,
];
export const PERSONA_ENGINE_CONFIG: PersonaEngineConfig = {
diff --git a/packages/shared/src/features/onboarding/steps/persona/engine.ts b/packages/shared/src/features/onboarding/steps/persona/engine.ts
index 756316b1471..35af2452e7a 100644
--- a/packages/shared/src/features/onboarding/steps/persona/engine.ts
+++ b/packages/shared/src/features/onboarding/steps/persona/engine.ts
@@ -103,7 +103,10 @@ export const pickNextQuestion = (
if (asked.has(q) || !layers.has(question.layer)) {
return best;
}
- if (question.exclusiveGroup && excludedGroups.has(question.exclusiveGroup)) {
+ if (
+ question.exclusiveGroup &&
+ excludedGroups.has(question.exclusiveGroup)
+ ) {
return best;
}
const gain = informationGain(belief, q);
From 0e241ceb1730443d7a179c406cd9a8172912e4f4 Mon Sep 17 00:00:00 2001
From: idoshamun <16071328+idoshamun@users.noreply.github.com>
Date: Thu, 4 Jun 2026 09:29:45 +0000
Subject: [PATCH 14/15] feat(onboarding): cross-group implications + tighten
DevOps lock
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Two fixes from a playtest where the user answered backend on Q2 and
then was asked Q4 ('main output is a web app') anyway, and ended up
classified as DevOps Engineer despite a clear senior-backend
answer pattern.
1. Cross-group implications
The exclusiveGroup mechanism only closes questions within the same
group. But Q1 ('you ship UI') and Q2 ('you're backend, not frontend
or mobile') are not just opposites of each other; they also imply
answers across the primary-platform group. A yes on Q2 rules out Q4
(web app) and Q6 (mobile app), but the engine had no way to express
that, so it asked Q4 later anyway when info gain was middling.
Added two optional fields to PersonaQuestion:
closesOnYes?: string[] // groups to close when this answer is yes
closesOnNo?: string[] // groups to close when this answer is no
Configured:
Q1 closesOnNo: ['primary-platform'] โ not UI => no UI platform
Q2 closesOnYes: ['primary-platform'] โ backend => no UI platform
usePersonaQuiz honors both when applying an answer.
2. DevOps lock too broad
Q14 was 'You've been the one paged at 3am when production went
down'. Every senior backend dev with on-call rotation answers yes,
which is why the playtest user (backend with Go/Rust and SQL and
diagrams) landed on DevOps Engineer instead of Backend Developer:
the DevOps row has 94 percent yes on Q14 vs 4 percent for Backend,
so yes on Q14 swamps the rest.
Reworded to identify DevOps as the role, not the duty:
'DevOps, SRE, or platform engineering is your job, not just a
side responsibility.'
A backend dev who is on rotation will answer no; a real DevOps,
SRE, or platform engineer will answer yes.
---
.../features/onboarding/steps/persona/data.ts | 17 ++++++++++++++++-
.../onboarding/steps/persona/usePersonaQuiz.ts | 13 +++++++++++++
2 files changed, 29 insertions(+), 1 deletion(-)
diff --git a/packages/shared/src/features/onboarding/steps/persona/data.ts b/packages/shared/src/features/onboarding/steps/persona/data.ts
index 8d0fcc4a967..70b009a5e99 100644
--- a/packages/shared/src/features/onboarding/steps/persona/data.ts
+++ b/packages/shared/src/features/onboarding/steps/persona/data.ts
@@ -13,6 +13,19 @@ export interface PersonaQuestion {
layer: number;
lockPersonaId?: string;
exclusiveGroup?: string;
+ /**
+ * Groups closed when this question is answered yes. Encodes
+ * implications across groups (e.g. Q2 "you're backend" = yes
+ * closes primary-platform, because backend rules out web/mobile
+ * as the main output).
+ */
+ closesOnYes?: string[];
+ /**
+ * Groups closed when this question is answered no. Symmetric to
+ * closesOnYes for negative implications (e.g. Q1 "you ship UI"
+ * = no also closes primary-platform).
+ */
+ closesOnNo?: string[];
}
export interface PersonaModifier {
@@ -143,11 +156,13 @@ export const QUESTIONS: PersonaQuestion[] = [
text: 'You ship the things users see and click on.',
layer: 0,
exclusiveGroup: 'primary-domain',
+ closesOnNo: ['primary-platform'],
},
{
text: 'Your work is mostly backend or infrastructure, not frontend or mobile.',
layer: 0,
exclusiveGroup: 'primary-domain',
+ closesOnYes: ['primary-platform'],
},
{
text: "You don't write code as part of your day-to-day job.",
@@ -204,7 +219,7 @@ export const QUESTIONS: PersonaQuestion[] = [
exclusiveGroup: 'main-language',
},
{
- text: "You've been the one paged at 3am when production went down.",
+ text: 'DevOps, SRE, or platform engineering is your job, not just a side responsibility.',
layer: 3,
},
{ text: 'You write more SQL than CSS.', layer: 3 },
diff --git a/packages/shared/src/features/onboarding/steps/persona/usePersonaQuiz.ts b/packages/shared/src/features/onboarding/steps/persona/usePersonaQuiz.ts
index 42123300206..fa8d57f1f97 100644
--- a/packages/shared/src/features/onboarding/steps/persona/usePersonaQuiz.ts
+++ b/packages/shared/src/features/onboarding/steps/persona/usePersonaQuiz.ts
@@ -240,6 +240,19 @@ export const usePersonaQuiz = (): PersonaQuizState => {
if (value === 1 && question.exclusiveGroup) {
excludedGroupsRef.current.add(question.exclusiveGroup);
}
+ // closesOnYes / closesOnNo: cross-group implications.
+ // Example: Q2 "you're backend" = yes also closes primary-platform,
+ // because that rules out web/mobile as the main output.
+ if (value === 1 && question.closesOnYes) {
+ for (const group of question.closesOnYes) {
+ excludedGroupsRef.current.add(group);
+ }
+ }
+ if (value === 0 && question.closesOnNo) {
+ for (const group of question.closesOnNo) {
+ excludedGroupsRef.current.add(group);
+ }
+ }
thinkingTimeout.current = setTimeout(() => {
setIsThinking(false);
From 3e8144da94122b15fb1daa63e7f9e943a64f92d3 Mon Sep 17 00:00:00 2001
From: idoshamun <16071328+idoshamun@users.noreply.github.com>
Date: Thu, 4 Jun 2026 10:30:39 +0000
Subject: [PATCH 15/15] feat(onboarding): finish open exclusive groups + DevOps
lock + Java question
Three fixes for a playtest where the user answered backend (Q2 yes),
got asked three of the five language questions (JS/TS, Go/Rust, .NET),
none of which was their language, then ended up classified as Backend
Developer without ever being asked about Python, PHP, or Java.
1. Active-group preference in pickNextQuestion
Until now the engine picked questions purely by expected information
gain. Inside the main-language group, once Q1 = no (not UI) was
answered, PHP belief collapsed to near zero (because PHP devs in the
data overwhelmingly answer Q1 = yes). PHP's expected info gain
followed, even though its conditional info gain on a yes is huge
(it's a lock). The engine reasonably decided PHP couldn't be the
answer and moved on, never asking the question.
The new rule: once any question in an open exclusiveGroup has been
asked, prefer the remaining group members before moving on. The
language group is treated as a single decision the user gets to
finish, not a single question the engine can drop after one no.
Same applies to primary-platform and primary-domain.
2. DevOps question is now a hard lock
'DevOps, SRE, or platform engineering is your job, not just a side
responsibility' is a self-identification question. Yes on it is
direct evidence the user IS DevOps, the same shape as Q12 (PHP),
Q13 (.NET), Q18 (game), Q19 (security). Added lockPersonaId:
'devops-engineer' so a yes locks the persona instead of relying on
the Bayesian update.
3. Added Java / Kotlin question
Java / Kotlin / JVM doesn't have its own persona (the JVM enterprise
cluster is too small to surface at K=16), so we never asked about
it. Users coming from Java land on Backend Developer or Software
Architect by inference. Added a new entry in the main-language
group ('Your main language is Java or Kotlin.') with no specific
lock; yes closes the language group and feeds the Bayesian
classifier with the right signal. Hand-crafted column in the
likelihood matrix: high yes rate for Backend Developer (35%),
Software Architect (30%) and Mobile Developer (30%, for Android
Kotlin), low everywhere else.
Bumped maxQuestions from 10 to 12 to make room for the longer
language pass. Median session length should still sit around 6-7
once a lock fires; only sessions that say no to every lock will
approach the new cap.
---
.../features/onboarding/steps/persona/data.ts | 79 ++++++-------------
.../onboarding/steps/persona/engine.ts | 68 +++++++++++-----
2 files changed, 71 insertions(+), 76 deletions(-)
diff --git a/packages/shared/src/features/onboarding/steps/persona/data.ts b/packages/shared/src/features/onboarding/steps/persona/data.ts
index 70b009a5e99..d38cf55968d 100644
--- a/packages/shared/src/features/onboarding/steps/persona/data.ts
+++ b/packages/shared/src/features/onboarding/steps/persona/data.ts
@@ -201,6 +201,11 @@ export const QUESTIONS: PersonaQuestion[] = [
layer: 2,
exclusiveGroup: 'main-language',
},
+ {
+ text: 'Your main language is Java or Kotlin.',
+ layer: 2,
+ exclusiveGroup: 'main-language',
+ },
{
text: 'AI is what you build, not just what you use.',
layer: 2,
@@ -221,6 +226,7 @@ export const QUESTIONS: PersonaQuestion[] = [
{
text: 'DevOps, SRE, or platform engineering is your job, not just a side responsibility.',
layer: 3,
+ lockPersonaId: 'devops-engineer',
},
{ text: 'You write more SQL than CSS.', layer: 3 },
{
@@ -274,62 +280,21 @@ export const MODIFIERS: PersonaModifier[] = [
* (non-engineers do not appear in the engagement clustering).
*/
export const PERSONA_QUESTION_LIKELIHOOD: number[][] = [
- [
- 0.192, 0.263, 0.0, 0.148, 0.411, 0.005, 0.029, 0.358, 0.16, 0.331, 0.003,
- 0.002, 0.001, 0.186, 0.244, 0.206, 0.03, 0.001, 0.0,
- ],
- [
- 0.956, 0.002, 0.0, 0.955, 0.111, 0.011, 0.008, 0.97, 0.082, 0.189, 0.011,
- 0.005, 0.001, 0.071, 0.151, 0.103, 0.004, 0.002, 0.0,
- ],
- [
- 1.0, 0.0, 0.0, 1.0, 0.035, 0.019, 0.005, 1.0, 0.044, 0.065, 0.0, 0.012,
- 0.002, 0.011, 0.045, 0.026, 0.826, 0.006, 0.0,
- ],
- [
- 0.062, 0.052, 0.0, 0.052, 0.08, 0.006, 0.019, 0.088, 0.131, 0.055, 0.891,
- 0.007, 0.004, 0.041, 0.04, 0.066, 0.568, 0.002, 0.0,
- ],
- [
- 0.095, 0.863, 0.0, 0.099, 0.083, 0.005, 0.015, 0.118, 0.091, 0.078, 0.001,
- 0.006, 0.002, 0.036, 0.999, 0.136, 0.157, 0.002, 0.0,
- ],
- [
- 0.061, 0.214, 0.0, 0.066, 0.066, 0.006, 0.033, 0.114, 0.152, 0.095, 0.016,
- 0.005, 0.002, 0.048, 0.213, 0.44, 0.043, 0.001, 0.0,
- ],
- [
- 0.103, 0.85, 0.0, 0.097, 0.95, 0.006, 0.026, 0.167, 0.126, 0.987, 0.002,
- 0.005, 0.002, 0.119, 0.159, 0.153, 0.066, 0.002, 0.0,
- ],
- [
- 0.073, 0.9, 0.0, 0.07, 0.936, 0.007, 0.02, 0.154, 0.111, 0.172, 0.004,
- 0.004, 0.001, 0.939, 0.234, 0.196, 0.118, 0.001, 0.0,
- ],
- [
- 0.987, 0.13, 0.0, 0.999, 0.12, 0.009, 0.006, 0.343, 0.066, 0.153, 0.001,
- 0.876, 0.001, 0.096, 0.197, 0.077, 0.137, 0.003, 0.0,
- ],
- [
- 0.344, 0.479, 0.0, 0.412, 0.273, 0.014, 0.014, 0.39, 0.1, 0.096, 0.027,
- 0.028, 0.007, 0.055, 0.077, 0.048, 0.164, 0.009, 0.394,
- ],
- [
- 0.1, 0.836, 0.0, 0.099, 0.171, 0.006, 0.005, 0.217, 0.049, 0.163, 0.0,
- 0.003, 0.824, 0.073, 0.205, 0.222, 0.143, 0.008, 0.0,
- ],
- [
- 0.944, 0.001, 0.0, 0.161, 0.166, 0.022, 0.03, 0.247, 0.143, 0.207, 0.001,
- 0.006, 0.01, 0.034, 0.079, 0.047, 0.136, 0.771, 0.0,
- ],
- [
- 0.986, 0.002, 0.0, 0.266, 0.094, 0.989, 0.008, 0.296, 0.077, 0.046, 0.002,
- 0.007, 0.004, 0.026, 0.101, 0.085, 0.131, 0.01, 0.0,
- ],
- [
- 0.2, 0.03, 0.95, 0.05, 0.02, 0.03, 0.05, 0.03, 0.05, 0.01, 0.03, 0.01, 0.01,
- 0.02, 0.05, 0.4, 0.25, 0.02, 0.03,
- ],
+ [0.192, 0.263, 0, 0.148, 0.411, 0.005, 0.029, 0.358, 0.16, 0.331, 0.05, 0.003, 0.002, 0.001, 0.186, 0.244, 0.206, 0.03, 0.001, 0],
+ [0.956, 0.002, 0, 0.955, 0.111, 0.011, 0.008, 0.97, 0.082, 0.189, 0.03, 0.011, 0.005, 0.001, 0.071, 0.151, 0.103, 0.004, 0.002, 0],
+ [1, 0, 0, 1, 0.035, 0.019, 0.005, 1, 0.044, 0.065, 0.01, 0, 0.012, 0.002, 0.011, 0.045, 0.026, 0.826, 0.006, 0],
+ [0.062, 0.052, 0, 0.052, 0.08, 0.006, 0.019, 0.088, 0.131, 0.055, 0.02, 0.891, 0.007, 0.004, 0.041, 0.04, 0.066, 0.568, 0.002, 0],
+ [0.095, 0.863, 0, 0.099, 0.083, 0.005, 0.015, 0.118, 0.091, 0.078, 0.35, 0.001, 0.006, 0.002, 0.036, 0.999, 0.136, 0.157, 0.002, 0],
+ [0.061, 0.214, 0, 0.066, 0.066, 0.006, 0.033, 0.114, 0.152, 0.095, 0.3, 0.016, 0.005, 0.002, 0.048, 0.213, 0.44, 0.043, 0.001, 0],
+ [0.103, 0.85, 0, 0.097, 0.95, 0.006, 0.026, 0.167, 0.126, 0.987, 0.05, 0.002, 0.005, 0.002, 0.119, 0.159, 0.153, 0.066, 0.002, 0],
+ [0.073, 0.9, 0, 0.07, 0.936, 0.007, 0.02, 0.154, 0.111, 0.172, 0.05, 0.004, 0.004, 0.001, 0.939, 0.234, 0.196, 0.118, 0.001, 0],
+ [0.987, 0.13, 0, 0.999, 0.12, 0.009, 0.006, 0.343, 0.066, 0.153, 0.01, 0.001, 0.876, 0.001, 0.096, 0.197, 0.077, 0.137, 0.003, 0],
+ [0.344, 0.479, 0, 0.412, 0.273, 0.014, 0.014, 0.39, 0.1, 0.096, 0.05, 0.027, 0.028, 0.007, 0.055, 0.077, 0.048, 0.164, 0.009, 0.394],
+ [0.1, 0.836, 0, 0.099, 0.171, 0.006, 0.005, 0.217, 0.049, 0.163, 0.02, 0, 0.003, 0.824, 0.073, 0.205, 0.222, 0.143, 0.008, 0],
+ [0.944, 0.001, 0, 0.161, 0.166, 0.022, 0.03, 0.247, 0.143, 0.207, 0.05, 0.001, 0.006, 0.01, 0.034, 0.079, 0.047, 0.136, 0.771, 0],
+ [0.986, 0.002, 0, 0.266, 0.094, 0.989, 0.008, 0.296, 0.077, 0.046, 0.3, 0.002, 0.007, 0.004, 0.026, 0.101, 0.085, 0.131, 0.01, 0],
+ [0.2, 0.03, 0.95, 0.05, 0.02, 0.03, 0.05, 0.03, 0.05, 0.01, 0.01, 0.03, 0.01, 0.01, 0.02, 0.05, 0.4, 0.25, 0.02, 0.03],
+
];
/** Prior probability of each persona (log-shaped to balance large and niche personas). */
@@ -345,7 +310,7 @@ export const PERSONA_ENGINE_CONFIG: PersonaEngineConfig = {
triplebreakFloor: 0.3,
fallbackFloor: 0.12,
fallbackPersonaId: 'generalist-developer',
- maxQuestions: 10,
+ maxQuestions: 12,
minQuestions: 5,
instantLockThreshold: 0.85,
instantLockMargin: 0.5,
diff --git a/packages/shared/src/features/onboarding/steps/persona/engine.ts b/packages/shared/src/features/onboarding/steps/persona/engine.ts
index 35af2452e7a..efeea2db938 100644
--- a/packages/shared/src/features/onboarding/steps/persona/engine.ts
+++ b/packages/shared/src/features/onboarding/steps/persona/engine.ts
@@ -86,9 +86,16 @@ const allowedLayers = (questionsShown: number): Set => {
/**
* Returns the next best question index, or -1 when none remain.
- * Questions whose exclusiveGroup has been answered yes already are skipped:
- * once the user picks their main language, asking about the other languages
- * is contradictory and wastes a slot.
+ *
+ * Question selection is greedy on information gain, with two extra rules:
+ * - exclusiveGroup: once a group is closed (a yes answer to one of its
+ * members, or a closesOnYes/closesOnNo from elsewhere), the remaining
+ * members are skipped.
+ * - active-group preference: once any question in an open exclusiveGroup
+ * has been asked, prefer the remaining members before moving on. Stops
+ * the engine from bailing on a half-asked group when info gain on the
+ * leftover questions looks low in expectation but huge conditional
+ * on a yes (e.g. PHP and .NET locks inside the main-language group).
*/
export const pickNextQuestion = (
belief: number[],
@@ -98,22 +105,45 @@ export const pickNextQuestion = (
): number => {
const layers = allowedLayers(questionsShown);
- return QUESTIONS.reduce(
- (best, question, q) => {
- if (asked.has(q) || !layers.has(question.layer)) {
- return best;
- }
- if (
- question.exclusiveGroup &&
- excludedGroups.has(question.exclusiveGroup)
- ) {
- return best;
- }
- const gain = informationGain(belief, q);
- return gain > best.gain ? { index: q, gain } : best;
- },
- { index: -1, gain: -1 },
- ).index;
+ // Groups that have been started but aren't closed yet.
+ const activeGroups = new Set();
+ QUESTIONS.forEach((question, q) => {
+ if (
+ question.exclusiveGroup &&
+ asked.has(q) &&
+ !excludedGroups.has(question.exclusiveGroup)
+ ) {
+ activeGroups.add(question.exclusiveGroup);
+ }
+ });
+
+ let bestInActive = { index: -1, gain: -1 };
+ let bestOverall = { index: -1, gain: -1 };
+
+ QUESTIONS.forEach((question, q) => {
+ if (asked.has(q) || !layers.has(question.layer)) {
+ return;
+ }
+ if (
+ question.exclusiveGroup &&
+ excludedGroups.has(question.exclusiveGroup)
+ ) {
+ return;
+ }
+ const gain = informationGain(belief, q);
+ if (
+ question.exclusiveGroup &&
+ activeGroups.has(question.exclusiveGroup) &&
+ gain > bestInActive.gain
+ ) {
+ bestInActive = { index: q, gain };
+ }
+ if (gain > bestOverall.gain) {
+ bestOverall = { index: q, gain };
+ }
+ });
+
+ return bestInActive.index >= 0 ? bestInActive.index : bestOverall.index;
};
/** Bayesian update of the belief vector given an answer to a question. */