A model reads my work before any person does, and I had no say in what it concluded from a frozen PDF. I couldn't change that a machine reads first. I could change what I put in front of it. So I did — and here's the build.
The shape of it
- A small backend exposes a profile as an API —
GET /info,POST /query(grounded answers + sources),POST /match(fit score),POST /resume(tailored). It also speaks agent: an MCP endpoint and an A2A agent-card for machine callers. - A web front (React + a tiny Hono server) renders it as a conversation for people, and as JSON-LD +
llms.txt+ a crawlable<noscript>for machines — so a non-JS fetch isn't an empty shell. - Nothing hardcodes me. Identity comes from
/info. Fork the front, point two env vars at your backend, and it's yours. Both repos are MIT.
Why I bothered
I'd rather be queryable and checkable than impressively static. The whole thing is grounded — ask it "what's the evidence?" and it answers with commit counts, tests, and live endpoints; the dated reasoning is browsable too. (The resume-agent repo links to a live instance if you want to poke it.)
If you want to build one
The smallest version is about ten minutes — fork the front, point it at any backend (even a stub /info), and deploy. That's a real, queryable node. If you stand one up, I'd genuinely like to see it. You don't have to agree with where I think this goes; a working node is its own statement.
This is the candidate side of a two-sided thing — an open protocol for hiring. The employer-side reference and the spec are open too, if the architecture pulls you further.
The repos
- resume-agent — the candidate-side backend, the profile-as-API. Links to a live instance for a demo: https://github.com/yuens1002/resume-agent
- resume-agent-web — the forkable web front: https://github.com/yuens1002/resume-agent-web
- open-employment-protocol — the reconciler that sits between the two sides: https://github.com/yuens1002/open-employment-protocol
- employer-agent — the employer side, scaffolded as a call to build: https://github.com/yuens1002/employer-agent
Built with a lot of AI help, deliberately unnamed — it wasn't one tool, it was the compounded work of everything that came before mine. Which is the kind of AI I'm building on: something you extend and pass forward.