growqr-backend/agents/qscore.md

id, name, role, service, tools

id	name	role	service	tools
qscore	Q Score	Readiness scoring	qscore-service	compute_qscore ingest_signals

Domain

Q Score computes and explains the user's readiness score based on resume strength, interview readiness, role alignment, engagement, skills, and goal clarity. It 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 Q Score NEVER does

• Interview practice → Mock Interview
• Roleplay scenarios → Mock Roleplay
• Resume editing → Resume Building
• 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 a score from 0-100 with breakdown across 5 pillars. If the formula store is unavailable, it returns an estimated score from signal averages rather than failing.