# How Jobbee works

> Upload your resume and fill in your workspace files. Jobbee finds matching
> roles, tailors a resume for each one, and delivers it to your inbox on a
> schedule you set. You review, you submit, you interview.

Jobbee works on the cadence you choose — finding matching openings,
producing a custom-tailored resume for each one, and emailing it to you
with the original job link. No technical setup and no config files: your
workspace files are plain text, and every tailored resume draws on what
they hold.

## What you actually get

| You do | Jobbee does on schedule |
|---|---|
| Upload your resume | Extracts a structured, editable profile — no manual data entry |
| Fill in your workspace files, and keep them current | Tailors every resume from what they hold |
| Set roles, locations, seniority | Surfaces positions that actually match you |
| Pick daily or weekly | Tailors, checks, and delivers — nothing hidden behind the score. |
| Review each email | Nothing is submitted without you |

## Step 1 — Upload your resume

- **Drop in your current resume** — PDF, Markdown, or DOCX, or paste text
- **Your profile is understood instantly** — skills, experience, and
  preferences are extracted automatically and stay fully editable
- **Your original is preserved untouched** — every tailored resume is
  generated from a copy

## Step 2 — Fill in your workspace files

Before your first search, fill in the workspace files —
round out your profile, extend your base resume, add a project file.
A resume only shows the top 10% of what you've done; these files carry
the other 90%, and they're what tailoring draws on. An upload alone
gets you results; fed files get you the right results.
([Getting the most out of Jobbee →](./effective-use.md))

Two things are non-negotiable before a search can start: your profile and
your base resume. If either is missing, the Jobs tab shows an amber banner
naming exactly which file is missing, with a "Fix in Edit Profile" link —
and the search is refused up front, before your quota is spent. That
banner is a gate, not a glitch: add the missing file under Edit Profile
and search again.

## Step 3 — Set your schedule

Daily or weekly — pick the schedule that suits your search. You can also search manually at
any time, for any job. Changed your mind? A search can be cancelled anytime from the
dashboard — cancel within 15 minutes and the quota slot is refunded
automatically. ([Plans and quotas →](./quota-byok-referrals.md))

Already have a job in mind? Paste the posting's link and Jobbee tailors for
exactly that role — before anything starts, it checks the posting. If the
company is one to avoid, or the match is out of reach, the search is
refused before your quota is spent, and the message tells you why. For a
match that's out of reach, it also shows the percentage of the role's
must-haves your profile covers and points you to "Evaluated, not picked,"
where the requirements you miss are listed. Anything else worth knowing is
shown up front, not after.

## Step 4 — From upload to inbox

Each search targets exactly **one job** — so every resume is written for THAT
specific role, not copy-pasted:

1. **We find matching roles** — and a posting you've already been through
   doesn't come back around
2. **A custom resume is created** — genuinely adapted to the role.
   Not a keyword dump — genuine alignment
   ([Resume tailoring →](./resume-tailoring.md))
3. **We ask, not guess** — if a decision only you can make comes up, the search
   pauses and emails you a link; it resumes automatically after you answer
   ([Clarifications →](./clarifications.md))
4. **Quality is checked** — every resume is checked before it reaches you
5. **You get the email** — the polished PDF and job link land in your inbox.
   Review, apply, repeat. The resume is also always downloadable from your
   dashboard — and editable there before you use it
   ([Resume tailoring →](./resume-tailoring.md))

## Why these jobs — and what we look at

Jobbee doesn't just pick jobs, it shows its work:

- **Every job card carries the verdict.** Your JD match score is right on the
  card, and if a company has a reason for caution, you'll see the warning
  and what triggered it before you spend time on it, not after.
- **Jobs you weren't picked for still count.** The "Evaluated, not picked"
  tab shows roles Jobbee looked at and passed on, with the must-haves you
  didn't meet — so "why not this job?" has a real answer. It's also the
  fastest way to see which skills keep costing you matches
  ([Getting the most out of Jobbee →](./effective-use.md)).
- **Nothing is hidden behind a score.** Open **Analysis** on any job card: a
  coverage bar over the role's requirements, the requirements checklist, and
  the skill gaps in plain text.

## Watch it happen

Every search streams its progress to the dashboard in real time — status
changes, step-by-step progress, quality checks — so a search in progress is
something you watch, not something you wonder about. While anything is
running, a live banner at the top of the Jobs tab links straight to the
live view.

The Jobs tab is home base, with three views:

- **Jobs** — one card per job Jobbee tailored for: the JD match score, the
  current state, skill gaps ("see Analysis"), and any company-caution
  warnings. A job tailored two or more times expands into an attempts history
  in plain language — "Waiting on your answers," "Answers received" — each
  attempt with its duration and how it started (schedule, retry, or you).
  The email's progress shows as a chip on the card: Sending…, Email
  failed, or Email bounced. Filters by status, company, and title sit
  above the cards, and the **Analysis** link opens the full match
  breakdown.
- **Evaluated, not picked** — roles Jobbee looked at and passed on, with
  the must-haves that weren't met
- **Other** — searches that didn't find a fit

Every search is also kept in your workspace's history — revisit past
applications and their scores whenever you need them. Each tailored
resume stays in your delivery email.

## What Jobbee doesn't do

- **It doesn't apply for you.** You review and submit each application
  yourself — you stay in control of every click
- **It never invents experience.** Tailoring re-emphasizes your real history —
  nothing more
- **It doesn't sell or leak your data.** Processed privately; the only path to
  an employer is your own send — delete anytime
  ([Privacy and data handling →](./privacy-data-handling.md))
