refactor: Update job recruiter template with XML sections and tool-fo…

…cused documentation

tools/job_recruiter_response_template.md

@@ -1,33 +1,78 @@
-# Responding to recruiters
+# Job Recruiter Response Template
 
----
+This tool helps craft professional responses to job recruiters, ensuring effective communication while maintaining professional boundaries and opportunities.
 
-> [!NOTE]
-> WORK IN PROGRESS
+## What It Does
 
----
+This tool helps you formulate appropriate responses to recruiter outreach by:
 
+1. **Situation Analysis**: Evaluates the context, timing, and nature of the recruiter's message
+2. **Response Formulation**: Crafts professional, strategic replies that maintain opportunities
+3. **Information Protection**: Ensures personal details are shared appropriately
+4. **Value Communication**: Highlights relevant qualifications while maintaining professionalism
+5. **Future Preservation**: Keeps doors open for potential opportunities
+6. **Quality Control**: Ensures responses are error-free and professionally formatted
 
+## Usage
 
+Provide the following inputs:
 
+1. **The prompt:** See below
+2. **Recruiter's message**: The message you received
+3. **Optional: Your resume**: To provide context about your experience and goals
+4. **Optional: Job description**: If provided by the recruiter
 
+## Prompt
 
+```markdown
 
+<task>
+Before responding, analyze the situation, the timeline & response timing, task(s), and desired outcome. Craft a concise, direct reply that maintains a positive tone and preserves future opportunities. Safeguard personal information while strategically choosing words that showcase your value. Avoid any negative statements or overly revealing details. Carefully proofread your response, as even small errors can impact the recruiter's perception. Aim to create the best possible impression while keeping the door open for potential future opportunities. Include a brief statement of interest or qualification related to the position, if appropriate. Reminder to tailor the response to the specific job or company mentioned by the recruiter.
+</task>
 
+<Today>
+[Paste today's date here]
+</Today>
 
+<resume>
+[Optional: Include your resume or relevant background information]
+</resume>
 
+<recruiter_message>
+[Paste recruiter's message here]
+</recruiter_message>
+```
 
-Evaluate this template for responding to recruiters.
+## Best Practices
 
-```
-Before responding, analyze the situation, task(s), and desired outcome. Craft a concise, direct reply that maintains a positive tone and preserves future opportunities. Safeguard personal information while strategically choosing words that showcase your value. Avoid any negative statements or overly revealing details. Carefully proofread your response, as even small errors can impact the recruiter's perception. Aim to create the best possible impression while keeping the door open for potential future opportunities. Include a brief statement of interest or qualification related to the position, if appropriate. Reminder to tailor the response to the specific job or company mentioned by the recruiter.
+1. **Be Prompt**: Respond within 24-48 hours when possible
+2. **Stay Professional**: Maintain a courteous and professional tone
+3. **Ask Key Questions**: Request important details like compensation and remote work policy upfront
+4. **Protect Privacy**: Share personal information strategically
+5. **Show Interest**: Demonstrate knowledge of the company/role while remaining neutral
+6. **Proofread**: Check for errors before sending
+7. **Keep Records**: Save important correspondence for future reference
 
----
+## Limitations
 
-[What you want to say and any context]
+- **Context Sensitivity**: The tool provides general guidance but may not account for industry-specific norms
+- **Personal Style**: You may need to adjust the tone to match your personal brand
+- **Negotiation Complexity**: Complex salary or benefit negotiations may require more nuanced approaches
+- **Cultural Differences**: May need adaptation for different cultural contexts or international recruiters
 
----
+## FAQ
 
-[Your Resume]
+1. **Q: How accurate is this tool in crafting appropriate responses?**
+   A: While the tool provides guidance based on best practices, individual situations may require adjustments. Use it as a starting point and modify the response based on your specific context.
 
-```
+2. **Q: Can this tool help with complex negotiation scenarios?**
+   A: The tool focuses on initial responses and basic interactions. For complex negotiations, use it to craft the initial response but seek additional guidance for detailed negotiations.
+
+3. **Q: Why should I include my resume when using this tool?**
+   A: Including your resume provides context that helps the tool generate more relevant and tailored responses that align with your experience and career goals.
+
+4. **Q: What if I need to respond to multiple recruiters with similar roles?**
+   A: While you can use the same prompt template, always create separate responses for each recruiter and customize details to reflect the specific company and role. The tool helps maintain consistency while ensuring each response feels personal.
+
+5. **Q: How does this tool handle different types of recruiter messages?**
+   A: The tool adapts to various scenarios (initial contact, follow-ups, etc.) but may need adjustment for unique situations or cultural contexts.