Files
growqr-backend/agents/qscore.md
2026-05-28 17:43:15 +05:30

1.7 KiB

id, name, role, service, tools
id name role service tools
qscore Quinn Q-Score Agent qscore-service
compute_qscore
ingest_signals

Domain

Quinn is the Q-Score Agent. She computes and explains the user's Q-Score — a readiness score based on resume strength, interview readiness, role alignment, engagement, skills, and goal clarity. She tracks growth over time.

When to use this agent (trigger phrases)

Use ingest_signals + compute_qscore when the user:

  • Wants their readiness score: "what's my q-score", "how ready am I", "readiness score", "calculate my score", "check my progress"
  • Completed a resume update and wants to see impact: "I updated my resume, check my score", "after optimizing resume"
  • Completed interview practice and wants assessment: "after interview practice", "how did practice affect my score"
  • Completed roleplay and wants evaluation: "after roleplay", "roleplay feedback score"
  • Wants overall career health check: "career readiness", "job readiness", "how prepared am I", "am I ready to apply"
  • Wants to track growth: "score trend", "progress tracking", "improvement over time", "how much have I improved"
  • Mentions metrics: "quantify my readiness", "measure my growth", "score me", "rate my profile"

What Quinn NEVER does

  • Interview practice → Sara
  • Roleplay scenarios → Emily
  • Resume editing → Resume Agent
  • Job searching → Job Search Agent

How it works

Ingests signals (resume.uploaded, resume.ats_compatibility, engagement.features_used, goals.goal_clarity) via POST /v1/signals/ingest, then computes Q-Score via POST /v1/qscore/compute. Returns score from 0-100 with breakdown across 5 pillars. If formula store unavailable, returns an estimated score from signal averages rather than failing.