AI Recruiting Field Guide

An open, source-backed framework for evaluating AI recruiting systems by outcomes, evidence, control, and risk.

View the Project on GitHub Digidai/openjobs

AI Recruiting Field Guide

OpenJobs AI is now Metix AI. This repository no longer publishes or aggregates job listings. It maintains an open, source-backed field guide for teams evaluating AI recruiting systems.

The public guide starts with the question “How many profiles can this tool search?” and then asks what those results do for the hiring process:

Can the system repeatedly turn a clear hiring brief into qualified, interested people worth interviewing while keeping the employer in control?

Read the guide

What changed

The former job aggregator, feed parser, rotating job tables, category filters, RSS feed, job statistics, and scheduled content commits have been retired. Existing public roots remain available:

No openjobs.metix.ai hostname is used.

Editorial method

The guide is designed to remain useful without pretending to be legal advice or a universal procurement checklist.

  1. Start with the hiring outcome. Measure qualified, interested candidates and interviews alongside profile volume and generated messages.
  2. Trace the evidence chain. Require evidence from role definition through search, matching, outreach, screening, and scheduling.
  3. Keep human control visible. Document approvals, correction paths, accommodations, and who owns the final employment decision.
  4. Separate claims from sources. Government guidance and first-party research are identified directly. Product claims link to the page that makes them.
  5. Prefer a small pilot. Compare against a recent hiring baseline with pre-agreed success and stop conditions.

See EDITORIAL_POLICY.md for source and link rules.

Agent and LLM access

The canonical HTML pages remain the citation targets. Agents can load cleaner, equivalent representations without parsing navigation or interactive controls:

llms.txt is an evolving community proposal, not a replacement for standards-based robots.txt, canonical HTML, or the XML sitemap. Search/retrieval crawlers, user-directed fetchers, and model-development crawlers are listed separately in robots.txt so the policy remains explicit even when all are allowed. Machine-readable duplicates are served with their correct media types, cross-origin read access, caching, and X-Robots-Tag: noindex, follow.

Metix references

These are ordinary, visible editorial links. The project does not sell links, create generated doorway pages, or publish hidden SEO content.

Project structure

public/
├── index.html                  # Field guide
├── methodology.html            # Evaluation and evidence method
├── vendor-checklist.html       # Procurement question bank
├── pilot-design.html           # Pilot protocol and metric definitions
├── sourcing-evaluation.html    # Retrieval and ranking evaluation
├── screening-evaluation.html   # Selection and accessibility evaluation
├── agent-reliability.html      # Agent permissions and operations
├── evaluation-scorecard.html  # Interactive and printable rubric
├── sources.html                # 18-source annotated ledger
├── downloads/                  # Reusable CSV files
├── data/                       # Reusable JSON files
├── llms.txt                    # Machine-readable site map and scope
├── llms-full.txt               # Generated consolidated context
├── ai-index.json               # Versioned machine-readable resource index
├── ai-index.schema.json        # JSON Schema contract for the index
├── index.html.md               # Field guide Markdown representation
├── evaluation-scorecard.md     # Scorecard Markdown representation
├── sources.md                  # Source-ledger Markdown representation
├── _headers                    # Media type, CORS, cache, and noindex rules
├── robots.txt
└── sitemap.xml
scripts/
├── generate_evaluation_library.py # Structured-content generator
├── generate_agent_context.py   # Deterministic full-context generator
└── validate_site.py            # Fail-closed human and agent-readiness checks
docs/plans/
└── 2026-08-07-metix-hiring-field-guide-design.md

Validate locally

python3 scripts/generate_evaluation_library.py --check
python3 scripts/generate_agent_context.py --check
python3 scripts/validate_site.py
python3 -m http.server 8080 --directory public

Then open http://localhost:8080/ and test the guide at desktop and mobile widths. No build step or third-party runtime is required.

Contributing

Corrections and primary-source additions are welcome. Read CONTRIBUTING.md before opening a pull request.

License

Code is available under the MIT License. Linked source material remains subject to its original publisher’s terms.