Skip to main content

reference-shield

Manage reference risk and build reference strategy after difficult departure

Stars
19
Source
reggiechan74/JobOps
Updated
2026-05-29
Slug
reggiechan74--JobOps--reference-shield
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/reggiechan74/JobOps/HEAD/plugins/jobops/skills/reference-shield/SKILL.md -o .claude/skills/reference-shield.md

Drops the SKILL.md into .claude/skills/reference-shield.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

Configuration

Read .jobops/config.json. If missing, stop with:

JOBOPS NOT CONFIGURED Run /jobops:setup to initialize your workspace.

Use config.directories.<key> for all file paths in this skill. Use config.preferences.cultural_profile if this skill generates resume-style content. Use config.preferences.default_jurisdiction if this skill has jurisdiction-sensitive logic (crisis/legal skills accept --jurisdiction=<ISO-3166-2> to override).

Default Jurisdiction: Ontario, Canada

This command defaults to Ontario, Canada employment law framework for reference-related matters.

Key Ontario Reference Law Principles:

  • Qualified Privilege: Employers have qualified privilege to give honest references; this protects truthful, good-faith statements
  • Defamation: False statements that damage reputation can lead to defamation claims (libel/slander)
  • Bad Faith Exceptions: Malicious, knowingly false, or reckless statements lose privilege protection
  • Human Rights: References cannot include comments about protected characteristics (age, disability, family status, etc.)
  • Privacy: PIPEDA and provincial privacy laws govern what information employers can share

Practical Reality (Canada): Most Canadian employers have similar practices to US employers - many limit official references to dates/title verification, while managers often provide informal references.

For US users: Specify your state for state-specific immunity and reference laws.

Important Disclaimers

CRITICAL: Read these disclaimers ALOUD to the user at session start:

  1. Not Legal Advice: Reference law varies by state/province. For defamation concerns, consult an employment attorney.
  2. State/Provincial Variation: What employers can legally say varies significantly by jurisdiction.
  3. Practical vs. Legal: Many employers say more than legally required. Practical strategies may matter more than legal limits.
  4. Documentation: Keep records of all reference-related communications and any evidence of problematic references.

Modes of Operation

Parse the mode from arguments:

  • --assess (default): Evaluate reference risk landscape and categorize references
  • --build: Develop proactive reference strategy with primary/backup/specialty references
  • --rescue: Damage control for known or suspected bad reference situation

If no mode specified, default to assess (full reference risk assessment).

Input Documents

Argument Handling:

  • If reference list file provided: Load and analyze existing reference documentation
  • If no file provided: Conduct structured interview to build reference inventory

Load Career Context:

  • Check for {config.directories.resume_source}/ for career history context
  • For career timeline and supervisor inventory, read WorkHistory/*.md directly. Each file should contain supervisor names, dates, and role context. Do NOT load candidate_profile.json — removed in v2.2.0.

Phase 1: Reference Risk Assessment (--assess mode)

1.1 Reference Inventory Interview

Ask the user:

  1. "List all supervisors from the past 10 years with relationship quality (1-10)"

  2. "For your most recent role (difficult departure), who are the key players?"

    • Direct supervisor(s), Skip-level manager, HR contacts
    • Close colleagues, Cross-functional partners, Clients
  3. "What happened during your departure?"

    • Voluntary or termination? PIP or performance issues? Conflict with specific individuals?
    • HR investigation? How did final conversation go? Stated reason for departure?
  4. "What would each person say if contacted?"

    • Who would be enthusiastically positive? Neutral/professional? Negative?
    • Who might "damn with faint praise"?
  5. "Are there witnesses to positive performance or achievements?"

1.2 Reference Risk Categorization

Create a reference matrix:

REFERENCE RISK MATRIX
| Name | Role/Relationship | Tenure Overlap | Risk Level | Likely Response | Notes |
|------|------------------|----------------|------------|-----------------|-------|
| [Name] | Former Manager | 2019-2022 | GREEN | Enthusiastic positive | Strong relationship |
| [Name] | Recent Manager | 2022-2024 | RED | Negative/lukewarm | Conflict during departure |

RISK LEVELS:
- GREEN (Safe): Will provide positive reference
- YELLOW (Unknown): Uncertain, may need coaching
- RED (Risky): Known or suspected negative, avoid using
- BLACK (Hostile): Actively negative, may require intervention

1.3 "Damning with Faint Praise" Detection

Warning Signs: Only confirms dates/title, hesitates when asked, limits scope, strained relationship

Faint Praise to Avoid: "Reliable and showed up on time", "Completed assigned tasks", "Got along with the team"

Strong References Say: Specific accomplishments with metrics, "hire them again in a heartbeat", proactive endorsement

1.4 HR Policy Investigation

Guide user to research:

  • Does company have formal reference policy?
  • Is reference checking centralized through HR?
  • What information does HR officially provide?
  • Can managers give personal references outside official channels?

1.5 Assessing "Would You Rehire?" Risk

The "would you rehire?" question is often the most damaging:

Interpretation by Reference Checkers:

  • "Absolutely, in a heartbeat" = Green light
  • "Yes" = Standard positive
  • "I'd have to think about that" = Red flag
  • "Company policy prevents me from answering" = Yellow flag (sometimes used to avoid lying)
  • "No" = Disqualifying for most employers
  • Long pause before answering = Red flag

Strategies if Rehire Status is "No":

  • Understand why (termination reason, policy, manager preference)
  • Prepare explanation if asked directly
  • Use references who CAN say yes enthusiastically
  • Consider preemptive disclosure

Phase 2: Legal Landscape (What Employers Can Say)

DISCLAIMER: General information, not legal advice. Consult attorney for specific situation.

2.1 Ontario/Canada Reference Law

Qualified Privilege (Canada):

  • Employers have qualified privilege to provide honest, good-faith employment references
  • Protection applies when: statement is relevant, made without malice, and believed to be true
  • Privilege is LOST if: statement is knowingly false, made with malice, or recklessly indifferent to truth

Defamation Remedies:

  • If reference contains false statements causing damage, employee may have defamation claim
  • Must prove: statement was made, it was false, it was communicated to third party, and it caused damage
  • Employers rarely face successful claims if statements are truthful and made in good faith

Human Rights Considerations:

  • Ontario Human Rights Code prohibits discrimination in employment references
  • Cannot mention: disability, age, family status, creed, race, sex, or other protected grounds
  • Violations can be addressed through Human Rights Tribunal of Ontario

2.2 US Reference Immunity States (For US Users)

States with qualified privilege protecting good-faith references: Alaska, Arizona, California, Colorado, Delaware, Florida, Georgia, Idaho, Indiana, Kansas, Louisiana, Maine, Maryland, Michigan, Missouri, Nevada, New Mexico, North Carolina, Ohio, Oklahoma, Oregon, Rhode Island, South Carolina, Tennessee, Texas, Utah, Virginia, Wisconsin, Wyoming

2.3 What Employers CANNOT Say (Generally)

  • False statements or lies
  • Protected class references (age, race, gender, disability)
  • Medical information or health conditions
  • Opinions presented as facts
  • Retaliatory statements

2.4 What Employers CAN Usually Say

  • Verified facts: dates, title, salary
  • Documented performance issues (previously communicated in writing)
  • Eligibility for rehire
  • Reason for departure (if documented and factual)

2.5 Practical Reality

  • Managers often give off-the-record references via personal cell/email
  • Reference checkers often call managers directly, not HR
  • Tone and enthusiasm matter as much as words
  • "I can only confirm dates" IS a signal to reference checkers
  • Long pauses and faint praise are understood as negative

Phase 3: Reference Strategy Development (--build mode)

3.1 Reference Portfolio Structure

PRIMARY REFERENCES (Use First - Strongest Advocates)
| Priority | Name | Title | Relationship | Contact | Best For |

BACKUP REFERENCES (If Primary Unavailable)
| Priority | Name | Title | Relationship | Contact | When to Use |

CHARACTER REFERENCES (For Integrity Concerns)
| Name | Title | Relationship | How They Know Your Character |

SKILL-SPECIFIC REFERENCES (Technical Validation)
| Skill Area | Name | Title | Validation Provided |

PEER REFERENCES (Colleague Perspective)
| Name | Title | Working Relationship | Best Aspects to Discuss |

CLIENT/EXTERNAL REFERENCES (Outside Validation)
| Name | Organization | Relationship | What They Can Speak To |

3.2 Proactive Reference Letter Collection

Timing: Request immediately after project success, upon resignation (even if difficult), while relationship is warm

Request Template: "Would you be willing to write a brief reference letter? Specifically, I'd appreciate if you could speak to: [specific skill], [key strength], [professional qualities]. A few paragraphs on letterhead or LinkedIn would be incredibly valuable."

3.3 LinkedIn Recommendation Strategy

  • Request from GREEN references first
  • Write recommendations for others (often reciprocated)
  • Aim for 5-10 strong recommendations
  • Cover different aspects and seniority levels
  • Request before difficult departure becomes known

3.4 Managing the Problematic Manager Reference

Strategies to Avoid Using Them:

  • Use previous managers, skip-level managers, project managers
  • "My direct manager left the company before me"
  • "My manager was new and didn't have full visibility"
  • "I worked primarily with cross-functional leaders on key projects"

If Asked Directly: "We had different views on team direction, which led to my decision to move on. I believe in being proactive about fit. I'm confident my other references can speak comprehensively to my capabilities."

3.5 Skip-Level and Alternative Supervisor Strategy

When your direct manager is problematic, build alternative supervisor references:

Skip-Level Managers:

  • Senior leader who observed your work on key projects
  • Executive who sponsored your initiatives
  • Department head who approved promotions/recognition

Matrix/Project Managers:

  • Project managers you reported to on major initiatives
  • Cross-functional leaders who managed joint projects
  • Client-side managers (for consulting/service roles)

Previous Supervisors at Same Company:

  • Managers from earlier roles within the organization
  • Supervisors before the problematic manager arrived
  • Acting managers during leave/transition periods

Framing the Alternative: "I've provided [Name] who managed me for [X years/projects] and has comprehensive visibility into my work, including [key accomplishment]."

3.6 Building New References Post-Departure

If you've already left, you can still build references:

  • Contract or freelance work with positive outcomes
  • Volunteer leadership roles
  • Professional association involvement
  • Consulting projects with satisfied clients
  • Academic or teaching relationships

Phase 4: Reference Coaching

4.1 Briefing Your References

Before listing someone: ASK PERMISSION, explain the role, share key messages, provide departure context, alert when contacted, thank them.

Briefing Template: "[Company] may reach out for a reference check for [Role]. About the role: [description]. Key points I'd love you to emphasize: [accomplishment], [skill], [quality]. About my recent departure: [brief explanation]. Questions they might ask: What was their role? Greatest strengths? Areas to improve? Would you work with them again?"

4.2 What to Ask References NOT to Say

  • Speculation about things they didn't witness
  • Details of internal conflicts or drama
  • Negative comments about former employer
  • Too much detail about departure
  • Anything defensive

4.3 Preparing for Common Questions

Performance: Responsibilities? Rate 1-10? Greatest accomplishments? Areas for improvement? Relationship: How long together? Team interaction? Independent and collaborative work? Rehire: Would you hire them again? Recommend for this role? Any concerns? Departure: Why did they leave? Issues leading to departure? Eligible for rehire?

Phase 5: Background Check Preparation

5.1 What Background Checks Verify

  • Employment Verification: Dates, title, sometimes salary, rehire eligibility
  • Reference Checks: Separate from verification, based on YOUR provided list
  • Criminal: Varies by role, typically 7 years
  • Credit: Limited roles (finance, executive), requires consent
  • Education: Degrees, dates, sometimes GPA
  • Social Media: Increasing but controversial, public posts only

5.2 Employment Verification vs. Reference Check

Aspect Employment Verification Reference Check
Who conducts Background check company Hiring manager/recruiter
Who they contact HR Your provided references
What they ask Facts only Opinions and insights
Your control Limited High (you choose)

Key Insight: Bad reference likely comes through REFERENCE check, not verification.

Phase 6: Reference Rescue Tactics (--rescue mode)

6.1 Discovering What's Being Said

Professional Reference Checking Services: Companies that pose as employers to check references. Cost $50-150 per reference. Provides verbatim report. Examples: Allison & Taylor, CheckYourReference.com

When to Use: Suspecting problematic reference, failing multiple final rounds, vague "reference concerns" feedback

6.2 Addressing a Known Bad Reference

Option 1: Preemptive Disclosure "Before we proceed with references, I want to be transparent. My recent manager and I had a difficult relationship. [Brief neutral explanation]. I've learned [specific lesson]. I'm confident my other references can speak to my capabilities."

Option 2: Overwhelm with Good References Provide 5-7 references instead of 3. Include managers, peers, clients, skip-levels. Front-load strongest references. Include written letters and LinkedIn recommendations.

Option 3: Context Framing Help employer interpret: "personality conflict", "reorganization eliminated role", "different views on approach", "I've since reflected and learned"

6.3 Legal Options for Defamatory References

Consider legal action when: Reference contains provably FALSE statements, caused demonstrable harm, pattern of malicious behavior

Cease and Desist Letter: Formal demand to stop, creates record, often stops behavior. Cost $300-800.

More Practical Approach: Document everything, use reference checking service for evidence, focus on building alternative references, move forward.

6.4 Reference Rescue Action Plan

IMMEDIATE (This Week):
- [ ] Identify all potential reference sources beyond problematic one
- [ ] Contact 3-5 alternative references, confirm willingness
- [ ] Request LinkedIn recommendations from GREEN references
- [ ] Prepare preemptive disclosure script
- [ ] Research former employer's official reference policy

SHORT-TERM (1-2 Weeks):
- [ ] Consider reference checking service for problematic contact ($50-150)
- [ ] Collect written reference letters from available sources
- [ ] Draft departure narrative with consistent talking points
- [ ] Coach all references on your messaging
- [ ] Update LinkedIn with new recommendations

IF BAD REFERENCE CONFIRMED:
- [ ] Consult employment attorney if statements are provably false
- [ ] Prepare additional references to offset (aim for 5-7 total)
- [ ] Develop "context framing" approach for interviews
- [ ] Practice preemptive disclosure script
- [ ] Document evidence for potential legal action

ONGOING:
- [ ] Monitor for reference-related feedback after interviews
- [ ] Build new references through contract/volunteer work
- [ ] Maintain relationships with positive references
- [ ] Consider asking interviewers about any reference concerns

Phase 7: Narrative Development

7.1 Departure Story Framework

Three-Part Structure:

  1. Context: Brief positive setup
  2. Decision: Neutral, no blame (2-3 sentences)
  3. Learning: What you gained, forward focus

Example: "At [Company], I led [accomplishment]. There was a change in leadership that shifted priorities. I learned the importance of [lesson]. I'm excited about opportunities like this because [fit]."

7.2 Consistency Requirements

Ensure narrative matches across: Resume dates/titles, LinkedIn, Application forms, Interview responses, Reference briefings, Cover letter

7.3 Follow-Up Question Preparation

"Can you tell me more?" Stick to facts, 3-4 sentences max, bridge to learning "What would your manager say?" Be honest: "They'd say I was [strength]. They might note [fair criticism]." "Were there performance issues?" Acknowledge briefly, focus on what you've done differently "Why didn't you list recent manager?" Use script from 3.4, keep brief, pivot to strong references

Phase 8: Output Deliverables

8.1 Save Reference Strategy Report

Location: {config.directories.crisis_management}/reference_shield_{YYYYMMDD}.md

Structure:

  • Executive Summary
  • Reference Risk Assessment (inventory matrix, risk summary, critical concerns)
  • Recommended Strategy (primary, backup, specialty references)
  • Managing Problematic References (risks, mitigation, narrative)
  • Reference Coaching Guide (briefing points, talking points)
  • Action Items (immediate, short-term, ongoing)
  • Appendix (contact info, scripts, templates)

8.2 Reference Contact Sheet

Portable document with: Name, Title, Company, Relationship, Phone/Email, "Best to speak about"

8.3 Reference Briefing Document

Shareable document including: Role being pursued, what to emphasize, departure explanation, questions they may be asked

8.4 Departure Narrative Script

Create a comprehensive script document:

# Departure Narrative Script
## Prepared: [Date]

### THE 30-SECOND VERSION (Casual/Networking)
"I left [Company] to pursue [forward-looking reason]. It was time for a new challenge where I could [goal]."

### THE 2-MINUTE VERSION (Interviews)
"At [Company], I [accomplishments]. [What happened - neutral]. I learned [lesson] from that experience. Now I'm looking for [what you want] and this role offers [specific appeal]."

### IF PRESSED FOR DETAILS
"[Honest but brief elaboration]. I've reflected on this and [what you learned]. I'm confident I'll bring [value] to my next role."

### ADDRESSING SPECIFIC CONCERNS
- Performance concerns: "There were documented areas for development around [X]. I've since [specific improvement]."
- Conflict: "We had different perspectives on [X]. I believe in addressing misalignment directly rather than letting it fester."
- Termination: "The company made a decision to go in a different direction. I've since [forward progress]."

### WHAT TO AVOID SAYING
- Details of interpersonal drama
- Criticism of former employer/manager
- Defensive explanations
- Excessive detail or justification
- Anything that contradicts your references

Quality Checks

Ensure strategy:

  • Identifies ALL potential reference sources
  • Assesses risk level for each reference
  • Provides clear mitigation actions
  • Includes coaching materials
  • Offers consistent departure narrative
  • Addresses legal considerations appropriately
  • Provides actionable next steps

Session Start

  1. Read any provided reference list file
  2. Deliver disclaimers
  3. Determine mode (assess/build/rescue)
  4. Conduct appropriate interview/analysis
  5. Generate comprehensive strategy and deliverables

Now executing Reference Shield strategy development...