docs: update CLAUDE.md and README.md to reflect changes in language profiles and quiz structure; remove outdated language paths summary

The documentation now accurately describes the updated structure of the language profiles, including the dual MBTI mappings for better personality matches. The removal of the outdated language paths summary streamlines the documentation, ensuring that users have access to the most relevant and current information about the quiz and its features.

Author: ariel-frischer

CLAUDE.md

@@ -47,23 +47,35 @@ The quiz operates in three phases managed by `src/lib/stores/quiz.ts`:
 
 ### Key Data Flow
 
-1. MBTI questions (`mbti-questions.ts`) → Calculate MBTI type → Filter candidate languages from `language-profiles.ts`
+1. MBTI questions (`mbti-questions.ts`) → Calculate MBTI type → Filter candidate languages from `languages.ts`
 2. Generate adaptive questions (`adaptive-questions.ts`) based on MBTI type
 3. Score candidate languages based on answers → Return highest scoring language
 
 ### Component Structure
 
 - **MBTIQuestion.svelte**: Handles MBTI personality questions
 - **LanguageQuestion.svelte**: Handles adaptive language matching questions
-- **Results.svelte**: Displays final matched language with personality insights
+- **Results.svelte**: Displays final matched language with user's MBTI type
 - **+page.svelte**: Main orchestrator managing quiz phases and state transitions
 
 ### Data Architecture
 
-- **language-profiles.ts**: 200+ language profiles with MBTI mappings
+- **languages.ts**: 42 language profiles with dual MBTI mappings (primary + optional secondary)
+  - Each language has `mbti: [primary, secondary?]` format
+  - Languages can match multiple personality types for better distribution
+  - Example: Python maps to `['ENFP', 'INTP']` - creative + analytical
 - **adaptive-questions.ts**: Dynamic question generation based on MBTI type
 - **quiz.ts store**: Centralized state management using Svelte stores
 
+### MBTI Mapping Strategy
+
+Languages support 1-2 MBTI types to ensure:
+
+- All 16 MBTI types have at least one language match
+- Popular languages can appeal to multiple personality types
+- Matching considers both primary and secondary MBTI assignments
+- User's calculated MBTI type is preserved in results (not the language's MBTI)
+
 ## Deployment
 
 The app deploys to GitHub Pages via GitHub Actions on push to main branch. The deployment workflow:

README.md

@@ -9,8 +9,9 @@ Visit the live application at: https://repobirdbot.github.io/programming-persona
 ## 🌟 Features
 
 - **MBTI-Based Assessment**: Two-phase quiz combining personality typing with language matching
-- **42 Programming Languages**: Curated list of mainstream and specialized languages
+- **42 Programming Languages**: Curated list with dual MBTI mappings for better personality matches
 - **Adaptive Questioning**: Dynamic questions based on your MBTI personality type
+- **Improved Distribution**: Languages support 1-2 MBTI types, ensuring all 16 personalities have options
 - **Share Your Results**: Social sharing buttons for Twitter, LinkedIn, WhatsApp, and Reddit
 - **Shareable Links**: Copy and share unique URLs that display your quiz results
 - **Beautiful UI**: Modern, responsive design with smooth animations

tests/language-paths-summary.md

@@ -1,11 +1,13 @@
 import { languages } from '../src/lib/data/languages';
 import { getAdaptiveQuestions } from '../src/lib/data/adaptive-questions';
+import type { MBTIType } from '../src/lib/types/quiz';
 
 // Quick test focused on problematic MBTI types
 const PROBLEM_MBTI_TYPES = ['ENFP', 'ISFJ', 'ESFP', 'ISTJ'];
 
 function quickSimulateQuiz(mbtiType: string, languageAnswers: Record<string, string>) {
-	let candidateLanguages = languages.filter((lang) => lang.mbti === mbtiType);
+	// Check both primary and secondary MBTI types
+	let candidateLanguages = languages.filter((lang) => lang.mbti.includes(mbtiType as MBTIType));
 
 	if (candidateLanguages.length === 0) {
 		candidateLanguages = languages;
@@ -130,7 +132,8 @@ console.log(`Success Rate: ${((passed / testCases.length) * 100).toFixed(1)}%`);
 // Test question generation for each MBTI type
 console.log('\n=== QUESTION GENERATION TEST ===');
 PROBLEM_MBTI_TYPES.forEach((mbtiType) => {
-	const candidateLanguages = languages.filter((lang) => lang.mbti === mbtiType);
+	// Check both primary and secondary MBTI types
+	const candidateLanguages = languages.filter((lang) => lang.mbti.includes(mbtiType as MBTIType));
 	const questions = getAdaptiveQuestions(mbtiType);
 	console.log(
 		`${mbtiType}: ${candidateLanguages.length} candidates, ${questions.length} questions generated`