feat: rewrite vibe coding language to be AI-native

Update persona taglines, axis descriptions, insight card subtitles,
share card metrics, and LLM narrative prompts to target AI-assisted
coding workflows instead of generic software engineering patterns.

- Persona taglines now reference prompting, agents, and vibe coding
- Axis descriptions explain AI tool usage patterns
- "Strongest" metric shows "AI-Heavy Automation" instead of "Automation 78"
- "Peak Varied" renamed to "All Hours"
- LLM prompts rewritten to focus on AI-assisted workflow analysis
- Fallback narratives updated with AI-native section titles

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: devakone

apps/web/src/app/api/share/[format]/[userId]/route.tsx

@@ -105,29 +105,37 @@ export async function GET(
       strongest: "N/A",
       style: "Balanced",
       rhythm: "Mixed",
-      peak: "Varied"
+      peak: "All Hours"
     };
 
     if (axes) {
       // 1. Strongest
       let maxScore = -1;
-      let maxName = "";
+      let maxKey = "";
       const AXIS_NAMES: Record<string, string> = {
         automation_heaviness: "Automation",
         guardrail_strength: "Guardrails",
-        iteration_loop_intensity: "Loops",
+        iteration_loop_intensity: "Iteration",
         planning_signal: "Planning",
-        surface_area_per_change: "Scope",
+        surface_area_per_change: "Surface Area",
         shipping_rhythm: "Rhythm",
       };
+      const AXIS_HIGH_LABELS: Record<string, string> = {
+        automation_heaviness: "AI-Heavy",
+        guardrail_strength: "Rigorous",
+        iteration_loop_intensity: "Rapid",
+        planning_signal: "Structured",
+        surface_area_per_change: "Wide",
+        shipping_rhythm: "Bursty",
+      };
       for (const [key, val] of Object.entries(axes)) {
         const axis = val as { score: number };
         if (axis.score > maxScore && AXIS_NAMES[key]) {
           maxScore = axis.score;
-          maxName = AXIS_NAMES[key];
+          maxKey = key;
         }
       }
-      const strongest = maxName ? `${maxName} ${maxScore}` : "N/A";
+      const strongest = maxKey ? `${AXIS_HIGH_LABELS[maxKey]} ${AXIS_NAMES[maxKey]}` : "N/A";
 
       // 2. Style
       let style = "Mixed"; // Default

apps/web/src/components/vcp/constants.ts

@@ -23,54 +23,54 @@ export const AXIS_METADATA: Record<AxisKey, AxisMetadata> = {
   automation_heaviness: {
     name: "Automation",
     shortName: "Auto",
-    description: "How much you leverage AI/automation for large-scale changes",
+    description: "How much you rely on AI agents and tools for generating code",
     longDescription:
-      'How "agentic" your workflow looks, driven by large commits and chunky PRs. Higher scores indicate more automation-heavy changes.',
+      "How much of your output comes from AI-assisted generation versus manual edits. Higher scores indicate more agent-driven, multi-file changes.",
     lowLabel: "Manual",
     highLabel: "AI-Heavy",
   },
   guardrail_strength: {
     name: "Guardrails",
     shortName: "Guard",
-    description: "How early and consistently tests/CI/docs appear in your workflow",
+    description: "How closely tests, CI, and docs follow your AI-generated changes",
     longDescription:
-      "How much you stabilize work with tests, CI, and docs early in the lifecycle. Higher scores mean guardrails appear sooner and more consistently.",
+      "How quickly guardrails appear after AI-generated code lands. Higher scores mean tests, CI, and docs show up alongside or right after the AI output.",
     lowLabel: "Light",
     highLabel: "Rigorous",
   },
   iteration_loop_intensity: {
     name: "Iteration",
     shortName: "Iter",
-    description: "How quickly you cycle through fix-forward loops after changes",
+    description: "How often you run prompt-fix-run loops to refine AI output",
     longDescription:
-      'How often you run rapid "generate → run → fix → run" cycles. Higher scores mean faster, denser iteration loops.',
+      'How often you cycle through "prompt → run → fix → run" loops after AI-generated changes. Higher scores mean faster, denser iteration.',
     lowLabel: "Stable",
     highLabel: "Rapid",
   },
   planning_signal: {
     name: "Planning",
     shortName: "Plan",
-    description: "How much upfront structure (issues, specs, docs-first) appears",
+    description: "How much structure you define before prompting AI to generate code",
     longDescription:
-      "How much intent and structure appear up front: linked issues, structured commits, and docs-first patterns. Higher scores indicate more planning.",
+      "How much upfront structure shapes your AI workflow: specs, linked issues, and docs-first patterns. Higher scores mean prompts follow plans, not the other way around.",
     lowLabel: "Emergent",
     highLabel: "Structured",
   },
   surface_area_per_change: {
     name: "Surface Area",
     shortName: "Scope",
-    description: "How many subsystems your typical change touches",
+    description: "How many parts of the codebase your typical prompt or change touches",
     longDescription:
-      "How broad each unit of work is across subsystems. Higher scores mean typical changes span more areas of the codebase.",
+      "How broad each unit of work is across the codebase. Higher scores mean your prompts and changes span multiple subsystems at once.",
     lowLabel: "Narrow",
     highLabel: "Wide",
   },
   shipping_rhythm: {
     name: "Rhythm",
     shortName: "Rhythm",
-    description: "Your shipping pattern — steady vs bursty",
+    description: "Your coding session pattern — steady output vs intense vibe sessions",
     longDescription:
-      "Bursty versus steady shipping over time. Higher scores indicate bursty sessions with gaps; lower scores indicate a steadier cadence.",
+      "How your coding sessions are distributed over time. Higher scores indicate intense vibe coding sessions followed by quiet stretches; lower scores indicate a steadier cadence.",
     lowLabel: "Steady",
     highLabel: "Bursty",
   },

apps/web/src/inngest/functions/analyze-repo.ts

@@ -65,13 +65,13 @@ export function toNarrativeFallback(params: {
     summary: `Analyzed ${metrics.total_commits} commits over ${metrics.active_days} active days.`,
     sections: [
       {
-        title: "Build rhythm",
-        content: `Median gap between commits: ${metrics.hours_between_commits_p50.toFixed(1)}h. Burstiness score: ${metrics.burstiness_score.toFixed(2)}.`,
+        title: "Coding session rhythm",
+        content: `Median gap between commits: ${metrics.hours_between_commits_p50.toFixed(1)}h. Session intensity (burstiness): ${metrics.burstiness_score.toFixed(2)}.`,
         evidence: events.slice(0, 5).map((e) => e.sha),
       },
       {
-        title: "Iteration",
-        content: `Fix ratio: ${(metrics.fix_commit_ratio * 100).toFixed(0)}%. Fix-after-feature sequences: ${metrics.fixup_sequence_count}.`,
+        title: "Fix-forward loops",
+        content: `Fix ratio: ${(metrics.fix_commit_ratio * 100).toFixed(0)}%. Prompt-fix-run sequences: ${metrics.fixup_sequence_count}.`,
         evidence: events.slice(0, 5).map((e) => e.sha),
       },
     ],
@@ -210,7 +210,8 @@ export async function generateNarrativeWithLLM(params: {
   })();
 
   const systemPrompt = [
-    "You write a narrative report about SOFTWARE ENGINEERING PATTERNS observed in commit history.",
+    "You write a narrative report about AI-ASSISTED CODING PATTERNS observed in commit history.",
+    "This profile measures how a developer works with AI coding tools (Claude, Copilot, Cursor, etc.).",
     "",
     "PRIVACY RULES (CRITICAL - VIOLATION MEANS FAILURE):",
     "- NEVER mention the project name, product name, app name, or repository name in your output",
@@ -221,22 +222,23 @@ export async function generateNarrativeWithLLM(params: {
     "- NEVER describe WHAT is being built - only describe HOW development happens",
     "",
     "ALLOWED TOPICS (your output must ONLY cover these):",
-    "- Development rhythm: commit frequency, timing patterns, burst vs steady patterns",
-    "- Iteration style: big batches vs small increments, refactoring frequency",
-    "- Code organization: how changes are structured, file churn patterns",
-    "- Testing approach: when tests appear relative to features, test coverage patterns",
-    "- Documentation patterns: when docs are written, documentation frequency",
-    "- Collaboration signals: merge patterns, review cycles (if visible)",
+    "- Session rhythm: vibe coding session patterns, timing, burst vs steady cadence",
+    "- AI-assisted workflow: agentic vs manual phases, large AI-generated drops vs incremental edits",
+    "- Prompt-iterate loops: fix-forward cycles, prompt-fix-run patterns after AI output",
+    "- Guardrail timing: when tests/CI/docs appear relative to AI-generated code",
+    "- Scope patterns: single-file vs full-stack changes, breadth of AI-assisted edits",
+    "- Planning signals: specs-first vs emergent architecture, structure before prompting",
     "",
-    "SECTION TITLES must be generic engineering terms like:",
-    "- 'Development Rhythm', 'Iteration Patterns', 'Code Organization', 'Testing Approach'",
+    "SECTION TITLES must be AI-workflow terms like:",
+    "- 'Session Rhythm', 'AI-Assisted Workflow', 'Fix-Forward Loops', 'Guardrail Timing'",
     "NOT product-specific like 'Admin Portal Development' or 'Feature Implementation'",
     "",
     "CONTENT RULES:",
     "- Never infer intent, skill, or code quality. Avoid speculation and motivational language.",
     "- Every claim must cite at least one specific metric name and value (e.g. burstiness_score=0.42).",
     "- Each section must include evidence: 2-6 commit SHAs that support the section.",
-    "- Provide a concise tagline (<=60 characters) that describes the developer's vibe. This will be displayed on the share card and must remain observational.",
+    "- Provide a concise tagline (<=60 characters) that describes the developer's vibe coding style. This will be displayed on the share card and must remain observational.",
+    "- Use vocabulary like: vibe coding, prompt-iterate, agentic, AI-assisted, fix loops, session rhythm",
     "",
     "Output must be STRICT JSON with this schema:",
     '{"summary":"...","tagline":"...","sections":[{"title":"...","content":"...","evidence":["sha", "..."]}],"highlights":[{"metric":"...","value":"...","interpretation":"..."}]}',
@@ -295,7 +297,7 @@ export async function generateNarrativeWithLLM(params: {
     "Commit lines (oldest→newest, compact):",
     ...commitLines,
     "",
-    "Produce a concise narrative about the SOFTWARE ENGINEERING PATTERNS observed: development phases, iteration loops, stabilization patterns, testing rhythm. Do NOT describe what was built - only HOW it was built from an engineering perspective. Prefer 4-6 sections.",
+    "Produce a concise narrative about the AI-ASSISTED CODING PATTERNS observed: prompt-iterate loops, agentic vs manual phases, session rhythm, guardrail timing, and scope of changes. Do NOT describe what was built - only HOW it was built and how AI tools shaped the workflow. Prefer 4-6 sections.",
   ].join("\n");
 
   // Use the LLM abstraction layer

apps/web/src/lib/profile-narrative.ts

@@ -75,20 +75,20 @@ export function toProfileNarrativeFallback(params: {
     .join(", ");
 
   return {
-    summary: `Across ${totalRepos} repositories and ${totalCommits} commits, you demonstrate a ${persona.name} coding style with ${persona.confidence} confidence.`,
+    summary: `Across ${totalRepos} repositories and ${totalCommits} commits, your AI-assisted coding workflow maps to the ${persona.name} persona with ${persona.confidence} confidence.`,
     sections: [
       {
-        title: "Your Coding Identity",
-        content: `Your aggregated profile shows you as a ${persona.name}. ${persona.tagline}. This pattern emerges consistently across your analyzed repositories.`,
+        title: "Vibe Coding Identity",
+        content: `Your aggregated profile identifies you as a ${persona.name}. ${persona.tagline}. This pattern emerges consistently across your analyzed repositories.`,
       },
       {
-        title: "Dominant Trait",
-        content: `Your strongest characteristic is ${dominantAxis[0].replace(/_/g, " ")} with a score of ${dominantAxis[1].score}/100. ${dominantAxis[1].why[0] ?? ""}`,
+        title: "Strongest Signal",
+        content: `Your most pronounced trait is ${dominantAxis[0].replace(/_/g, " ")} with a score of ${dominantAxis[1].score}/100. ${dominantAxis[1].why[0] ?? ""}`,
       },
       {
         title: "Repository Breakdown",
         content: repoSummary
-          ? `Your style varies across projects: ${repoSummary}${repoBreakdown.length > 3 ? ` and ${repoBreakdown.length - 3} more` : ""}.`
+          ? `Your vibe coding style varies across projects: ${repoSummary}${repoBreakdown.length > 3 ? ` and ${repoBreakdown.length - 3} more` : ""}.`
           : "No repository breakdown available.",
       },
     ],
@@ -124,27 +124,29 @@ export async function generateProfileNarrativeWithLLM(params: {
   const { provider, apiKey, model, profile } = params;
 
   const systemPrompt = [
-    "You write a personalized narrative about a developer's SOFTWARE ENGINEERING PATTERNS based on their aggregated profile data.",
-    "The profile is computed from multiple repository analyses and represents their overall coding identity.",
+    "You write a personalized narrative about a developer's AI-ASSISTED CODING WORKFLOW based on their aggregated vibe coding profile.",
+    "The profile measures how developers work with AI coding tools (Claude, Copilot, Cursor, etc.) across multiple repositories.",
     "",
     "PRIVACY RULES (CRITICAL - VIOLATION MEANS FAILURE):",
     "- NEVER mention project names, product names, or repository names",
     "- NEVER infer or mention what products, apps, or features the developer builds",
     "- NEVER reference business domains, industries, or product categories",
     "- Repository identifiers (Repo1, Repo2, etc.) are anonymized - do not try to interpret them",
-    "- Focus ONLY on: development rhythm, iteration patterns, testing approach, code organization, shipping cadence",
+    "- Focus ONLY on: AI-assisted workflow patterns, prompt-iterate loops, guardrail habits, session rhythm",
     "",
     "ALLOWED TOPICS:",
-    "- How they iterate (small vs large commits, batch vs continuous)",
-    "- Testing rhythm (when tests appear, test coverage patterns)",
-    "- Shipping cadence (release frequency, stabilization patterns)",
-    "- Code organization (refactoring frequency, structural changes)",
-    "- Collaboration patterns (if visible in data)",
+    "- How they use AI tools (agentic vs manual, large drops vs incremental edits)",
+    "- Prompt-fix-run iteration loops and feedback cycles",
+    "- Guardrail timing (when tests/CI/docs appear relative to AI-generated code)",
+    "- Session patterns (vibe coding marathons vs steady output)",
+    "- Planning before prompting (specs-first vs emergent architecture)",
+    "- Scope of AI-assisted changes (single file vs full-stack slices)",
     "",
     "CONTENT RULES:",
     "- Never infer skill level, code quality, or make judgments",
-    "- Focus on describing observable engineering patterns",
+    "- Focus on describing observable AI-assisted coding patterns",
     "- Be encouraging but factual. Avoid generic motivational language.",
+    "- Use vocabulary like: vibe coding, prompt-iterate, agentic workflow, AI-assisted, fix loops, session rhythm",
     "",
     "Output must be STRICT JSON with this schema:",
     '{"summary":"2-3 sentence overview","sections":[{"title":"...","content":"..."}],"highlights":[{"label":"...","value":"...","interpretation":"..."}]}',
@@ -181,9 +183,9 @@ export async function generateProfileNarrativeWithLLM(params: {
     "Persona Reasoning:",
     profile.persona.why?.join(". ") || "(No reasoning available)",
     "",
-    "Write a personalized narrative about the developer's SOFTWARE ENGINEERING approach and patterns.",
-    "Focus on: how they iterate, their testing rhythm, shipping cadence, and code organization style.",
-    "Do NOT interpret repository names or infer what products they build. Focus only on engineering patterns.",
+    "Write a personalized narrative about the developer's AI-assisted coding workflow and vibe coding patterns.",
+    "Focus on: how they use AI tools, their prompt-iterate loops, guardrail timing, session rhythm, and scope of changes.",
+    "Do NOT interpret repository names or infer what products they build. Focus only on AI-assisted workflow patterns.",
   ].join("\n");
 
   const client = createLLMClient({

apps/web/src/lib/vcp/__tests__/metrics.test.ts

@@ -105,14 +105,14 @@ describe("computeStrongestAxis", () => {
 // =============================================================================
 
 describe("formatStrongestAxis", () => {
-  it("formats as 'Name Score'", () => {
+  it("formats as 'HighLabel Name'", () => {
     const axes = createMockAxes({
       automation_heaviness: { score: 78, level: "high" },
     });
 
     const result = formatStrongestAxis(axes);
 
-    expect(result).toBe("Automation 78");
+    expect(result).toBe("AI-Heavy Automation");
   });
 
   it("formats different axes correctly", () => {
@@ -122,7 +122,7 @@ describe("formatStrongestAxis", () => {
 
     const result = formatStrongestAxis(axes);
 
-    expect(result).toBe("Rhythm 85");
+    expect(result).toBe("Bursty Rhythm");
   });
 });
 
@@ -266,8 +266,8 @@ describe("computePeakLabel", () => {
     expect(computePeakLabel("late_nights")).toBe("Late Nights");
   });
 
-  it("returns 'Varied' for null", () => {
-    expect(computePeakLabel(null)).toBe("Varied");
+  it("returns 'All Hours' for null", () => {
+    expect(computePeakLabel(null)).toBe("All Hours");
   });
 });
 
@@ -349,27 +349,27 @@ describe("computeShareCardMetrics", () => {
     const result = computeShareCardMetrics(axes, "afternoons");
 
     expect(result).toEqual({
-      strongest: "Automation 78",
+      strongest: "AI-Heavy Automation",
       style: "Fast Builder",
       rhythm: "Mixed",
       peak: "Afternoons",
     });
   });
 
-  it("uses 'Varied' for peak when no peakWindow provided", () => {
+  it("uses 'All Hours' for peak when no peakWindow provided", () => {
     const axes = createMockAxes();
 
     const result = computeShareCardMetrics(axes);
 
-    expect(result.peak).toBe("Varied");
+    expect(result.peak).toBe("All Hours");
   });
 
   it("handles null peakWindow explicitly", () => {
     const axes = createMockAxes();
 
     const result = computeShareCardMetrics(axes, null);
 
-    expect(result.peak).toBe("Varied");
+    expect(result.peak).toBe("All Hours");
   });
 });
 

apps/web/src/lib/vcp/metrics.ts

@@ -44,11 +44,12 @@ export function computeStrongestAxis(axes: VibeAxes): StrongestAxis {
 }
 
 /**
- * Format strongest axis for display (e.g., "Automation 78")
+ * Format strongest axis for display (e.g., "AI-Heavy Automation")
  */
 export function formatStrongestAxis(axes: VibeAxes): string {
-  const { name, score } = computeStrongestAxis(axes);
-  return `${name} ${score}`;
+  const { key } = computeStrongestAxis(axes);
+  const meta = AXIS_METADATA[key];
+  return `${meta.highLabel} ${meta.name}`;
 }
 
 // =============================================================================
@@ -126,7 +127,7 @@ export function computeRhythmLabel(axes: VibeAxes): RhythmLabel {
 // =============================================================================
 
 export type PeakWindow = "mornings" | "afternoons" | "evenings" | "late_nights" | null;
-export type PeakLabel = "Mornings" | "Afternoons" | "Evenings" | "Late Nights" | "Varied";
+export type PeakLabel = "Mornings" | "Afternoons" | "Evenings" | "Late Nights" | "All Hours";
 
 /**
  * Compute a peak time label from timing analysis.
@@ -144,7 +145,7 @@ export function computePeakLabel(peakWindow: PeakWindow): PeakLabel {
     case "late_nights":
       return "Late Nights";
     default:
-      return "Varied";
+      return "All Hours";
   }
 }
 
@@ -200,7 +201,7 @@ export function analyzePeakWindow(commitTimestamps: string[]): PeakWindow {
 // =============================================================================
 
 export interface ShareCardMetrics {
-  strongest: string;      // "Automation 78"
+  strongest: string;      // "AI-Heavy Automation"
   style: StyleDescriptor; // "Fast Builder"
   rhythm: RhythmLabel;    // "Bursty"
   peak: PeakLabel;        // "Afternoons"