compose-screening-answer

compose-screening-answer

Input

• question_text: the literal question shown by the form.
• widget_type: one of text_short, textarea, number, radio_yes_no, dropdown, checkbox. Tells you the expected answer format.
• widget_options: list of allowed values (for dropdown/radio); empty otherwise.
• is_required: bool.
• profile_text: the full text of the user's profile.md.

Steps

1. Parse question_text to identify what is asked.
2. Search profile_text for relevant ground truth:
   • For year-count questions: look in the Skills section.
   • For salary: look in Preferencias/FAQ.
   • For auth: look in Preferencias/FAQ.
   • For "tell us about" questions: look in Experiencia bullets.
3. Compose the answer in the format widget_type requires:
   • number → integer string (or "0").
   • radio_yes_no → exact label from widget_options.
   • dropdown → exact label from widget_options that best matches; if all options overstate, pick the lowest one.
   • text_short → ≤ 80 chars.
   • textarea → 2–4 sentences.
4. Return the answer string and a short rationale.

Honesty rules (HARD)

• For a skill not in profile: years = 0. Never invent.
• Never claim certifications, credentials, or projects not in profile.
• For nuanced questions (auth, willingness to relocate), prefer the most accurate answer from profile, even if it weakens the application.
• If is_required = true and you cannot produce an honest answer in the required format, return unanswerable so the caller can abort the job with error_unanswerable_required.

Output

Return:

{
  "answer": "<string to type/select>",
  "rationale": "<one line: where in profile this came from>",
  "honest": true,
  "unanswerable": false
}

If unanswerable: true, set answer to empty and explain in rationale.

Examples

question_text	widget	profile_says	answer
"Years of Python?"	number	"Python: 8 years"	"8"
"Years of SAP?"	number	(not mentioned)	"0"
"Authorized in US?"	radio_yes_no	"contractor yes, employee no"	"No" (most forms ask about employment auth)
"Salary expectation"	text_short	"USD 90k+ full-time"	"USD 90,000+"
"Optimized a slow query?"	textarea	Postgres bullets	2-3 sentence answer citing the profile bullet