Put the fetch gate inside fetch as region, place and role, with All countries and All roles as separate overrides
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
4565507d7a
commit
6741ce88a1
2 files changed
+42
-37
No files matched your search
+41
-36
@@ -4,61 +4,66 @@ The target design of roledesk's ranking: how a role gets from a board to the Rol
|
||||
|
||||
## Terms
|
||||
|
||||
- **Fetch gate**: the agent's hard rules, a yes or no per role.
|
||||
- **Fetch gate**: the agent's hard rules, a yes or no per role, in three parts: region, place and role.
|
||||
- **Analysis score**: what decides the **cut**, the roles that get fetch text and the model pass.
|
||||
- **Final score**: the order of the feed.
|
||||
- **Fetch text**: the second HTTP read of a role's own page, without a model.
|
||||
- **Extract**, **judge**, **summarise**: the model calls (Haiku).
|
||||
- **Fetch terms**: words a big board must match to send a role. They narrow the read at the host and are not part of the fetch gate.
|
||||
- **Affinity**: an agent's setting for a company: hidden, neutral, liked or favourite.
|
||||
- **All roles**: a company switch, the same for every agent, that passes the whole company through the fetch gate.
|
||||
- **All countries**, **All roles**: company switches, the same for every agent, that bypass the place and the role part of the fetch gate.
|
||||
|
||||
## Flow
|
||||
|
||||
```
|
||||
company boards (ATS) search providers
|
||||
fetch gate at the host + fetch terms, their own saved query
|
||||
boards ≥300 roles whose host filters
|
||||
│ │
|
||||
▼ ▼
|
||||
1 Fetch ─ list pages: title, place, teaser or text
|
||||
1 Fetch ─ all relevant roles, limited by the fetch gate:
|
||||
region · place · role, with All countries and All roles as overrides
|
||||
company boards: whole under 300 roles, else filtered at the host where it can
|
||||
search providers: their own saved query
|
||||
│
|
||||
▼
|
||||
2 Fetch gate ─ required countries, Where lines, titles to leave out
|
||||
2 Analysis score, no tokens ─ fit to the prompts, closeness to the CV, affinity → the cut
|
||||
│
|
||||
▼
|
||||
3 Analysis score, no tokens ─ fit to the prompts, closeness to the CV, affinity → the cut
|
||||
3 Fetch text ─ the role's own page, for cut roles without text
|
||||
│
|
||||
▼
|
||||
4 Fetch text ─ the role's own page, for cut roles without text
|
||||
4 Model pass ─ extract the cut → fetch gate and cut again → judge the cut
|
||||
│
|
||||
▼
|
||||
5 Model pass ─ extract the cut → fetch gate and cut again → judge the cut
|
||||
│
|
||||
▼
|
||||
6 Feed ─ every role that passes the fetch gate, in two orders;
|
||||
5 Feed ─ every role that passes the fetch gate, in two orders;
|
||||
filters and saved filters narrow it
|
||||
│
|
||||
▼
|
||||
7 After the ranking ─ summarise the top of the feed
|
||||
6 After the ranking ─ summarise the top of the feed
|
||||
```
|
||||
|
||||
## 1 Fetch
|
||||
|
||||
- On a company board with 300 or more roles, the host is asked for the fetch gate's location part (the required countries and the Where lines) and for the fetch terms, each where the host can filter on it. A smaller board, or a host that cannot filter, is read whole.
|
||||
- A company set to All roles is fetched from every required country, without fetch terms.
|
||||
- A search provider is read by its own saved query and takes neither filter.
|
||||
The aim is to fetch every relevant role while keeping out the thousands that are not, before anything is known about them in detail. The fetch gate does that.
|
||||
|
||||
### 1.1 Fetch gate
|
||||
|
||||
1. **Region**: the required countries, Europe. Every role must be in them, and no override lifts this.
|
||||
2. **Place**: the Where lines. A role passes when it matches at least one line: a country, a town or remote. With every line empty, a role can be anywhere in the region.
|
||||
3. **Role**: the fetch terms, words a big board's host must match before it sends a role, and the titles to leave out, phrases that reject a role by its title.
|
||||
|
||||
Overrides:
|
||||
|
||||
- A company set to **All countries** bypasses the place part. Its roles are fetched and kept from the whole region.
|
||||
- A company set to **All roles** bypasses the role part: no fetch terms and no titles to leave out. It is for small companies worth a speculative approach, whatever the role.
|
||||
- A search provider is read by its own saved query, which replaces the fetch terms.
|
||||
- A hidden company never passes.
|
||||
|
||||
The gate rejects on evidence only. A role with an unknown location passes until extract has read it.
|
||||
|
||||
### 1.2 Reading a board
|
||||
|
||||
- A company board with fewer than 300 roles is read whole.
|
||||
- A company board with 300 or more roles is asked for the fetch gate at the host: the region and place, and the fetch terms, each where the host can filter on it. A host that cannot filter on a part sends the board whole for that part.
|
||||
- Whatever the host did, the gate is applied to every role that arrives.
|
||||
- A read narrowed by fetch terms is not the whole board, so it closes no role. Roles on such boards close by age. This is accepted because ranking relies on recency, not on closing.
|
||||
|
||||
## 2 Fetch gate
|
||||
|
||||
- A role passes when it is in the required countries (Europe), matches at least one Where line (a country, a town or remote), and has no title to leave out in its title. With every Where line empty, a role can be anywhere in the required countries.
|
||||
- A role of a company set to All roles passes on the required countries alone. This is for small companies worth a speculative approach, whatever their roles' location or title.
|
||||
- The gate rejects on evidence only. A role with an unknown location passes until extract has read it.
|
||||
- A hidden company is never scored, read by a model or shown.
|
||||
- The same gate applies at every stage: at the host where it can filter, before the analysis score, again after extract with the real location and remote area, and in the feed.
|
||||
|
||||
## 3 Analysis score and the cut
|
||||
## 2 Analysis score and the cut
|
||||
|
||||
- Free and local: each role is embedded once. **Fit** is its level against the best of the agent's prompts. **CV closeness** is its level against the closest part of the CV. Both are calibrated levels from 0 to 1, the same in every run.
|
||||
- Affinity is a bonus on both levels, in the same proportion as in the final score: a liked company about 0.05 above neutral, a favourite about 0.1. It is a nudge, not a pass.
|
||||
@@ -71,11 +76,11 @@ The target design of roledesk's ranking: how a role gets from a board to the Rol
|
||||
- For a broad agent the count stops each list; for a narrow agent the minimum stops it, so roles that do not fit are not read just to fill the count.
|
||||
- The cut takes only roles that pass the fetch gate. Measured on 2026-10-04 for agent 2, without the Where lines only 118 of the 500 best by fit were roles the agent could take.
|
||||
|
||||
## 4 Fetch text
|
||||
## 3 Fetch text
|
||||
|
||||
- Fetch text reads the role's own page for every role in the cut that came without text. The role is embedded again and its levels recomputed.
|
||||
|
||||
## 5 Model pass
|
||||
## 4 Model pass
|
||||
|
||||
- One depth: the cut is the only selection, and extract and judge both read all of it.
|
||||
- **Extract** reads the cut first. It fills location, remote area, seniority, languages and deadline.
|
||||
@@ -84,7 +89,7 @@ The target design of roledesk's ranking: how a role gets from a board to the Rol
|
||||
- Extract and judge are two calls. Extract needs no CV, and its location and remote answers must reach the fetch gate before judge reads anything.
|
||||
- Each role is extracted once. A judgement is redone only when its input changes. A change to the CV, a prompt, or the like or dislike text re-judges the whole cut (about an hour for 650 roles); a changed posting re-judges that role only.
|
||||
|
||||
## 6 Feed
|
||||
## 5 Feed
|
||||
|
||||
- The feed shows every role that passes the agent's fetch gate, loaded as you scroll, in every order, newest first included. No order shows a role the fetch gate rejects.
|
||||
- **What I'm looking for** orders by the final score: `(0.6 fit + 0.2 newness + 0.2 affinity + 0.2 taste) / sum of the weights`. Newness halves every 14 days. Taste is the role's closeness to the roles the agent liked, away from those it passed. The weights are set per agent.
|
||||
@@ -92,9 +97,9 @@ The target design of roledesk's ranking: how a role gets from a board to the Rol
|
||||
- Everything else (seniority, location, remote or hybrid, pay) is a filter, not a score term. Filters only narrow what the fetch gate passed.
|
||||
- The Roles page says that the feed is already filtered by the agent's fetch gate, location included.
|
||||
- **Saved filters**, per agent: the current filter settings are saved under a name, loaded with one click, and deleted. There is no editing; a change is a new saved filter.
|
||||
- The company view says what is filtered: for an All roles company, every role in the required countries; for any other company, the roles the agent's fetch gate passes. Looking up a company never silently hides roles elsewhere.
|
||||
- The company view says what is filtered: which parts of the fetch gate apply to this company, for example "every role in Europe, not filtered by country" for an All countries company. Looking up a company never silently hides roles elsewhere.
|
||||
|
||||
## 7 After the ranking
|
||||
## 6 After the ranking
|
||||
|
||||
- Summarise is not part of any score. It runs after the final score, on the top of the feed by the final score (50 to start, its own setting), and on every role liked or saved.
|
||||
|
||||
@@ -103,10 +108,10 @@ The target design of roledesk's ranking: how a role gets from a board to the Rol
|
||||
Per agent, on the form:
|
||||
|
||||
- name and prompts
|
||||
- the fetch block: required countries, Where lines, titles to leave out, fetch terms
|
||||
- the fetch gate: region (required countries), place (Where lines), role (fetch terms, titles to leave out)
|
||||
- CV, languages, likes and dislikes
|
||||
- the cut: count and minimum by fit, count and minimum by CV closeness
|
||||
- the final score weights, and the CV match weights
|
||||
- summarise size
|
||||
|
||||
Per agent, per company: affinity (hidden, neutral, liked, favourite). Per company, for every agent: All roles.
|
||||
Per agent, per company: affinity (hidden, neutral, liked, favourite). Per company, for every agent: All countries and All roles.
|
||||
@@ -100,7 +100,7 @@ Without the Where lines, about four in five model reads go to roles outside DK,
|
||||
- The feed shows every role that passes the fetch gate, loaded as you scroll, not only the cut. Newest first stays inside the fetch gate as well, so no order shows roles outside the agent's places.
|
||||
- There are two orders: "what I'm looking for" (final score) and "what fits me" (CV match). The final score includes newness and likes. It is not one blended number.
|
||||
- Front-end filters only narrow further. The Roles page says that the feed is already filtered by the agent's fetch gate, location included.
|
||||
- **All roles**, one company switch in place of today's All countries and All roles. It is for small companies worth a speculative approach ("have you thought about hiring in Denmark?"). The company is fetched from every country inside the required countries (Europe) and without fetch terms, and its roles pass the fetch gate whatever the Where lines and the titles to leave out say. It changes nothing in any score: its roles enter the cut only by their levels, and favourite is what pushes them up. It applies to every agent, as the two switches do today.
|
||||
- **All countries** and **All roles** stay two company switches, now defined as overrides of the fetch gate: All countries bypasses the place part (Where lines) and All roles the role part (fetch terms and titles to leave out); the region (Europe) always applies. Neither changes any score: favourite is what pushes a company's roles up. Both apply to every agent, as today. Use case: small companies worth a speculative approach ("have you thought about hiring in Denmark?").
|
||||
- The company view says plainly what is filtered: for an All roles company, "every role in Europe, not filtered by country or title"; for any other company, that it shows the roles the agent's fetch gate passes. Looking up a company must not silently hide roles in other countries.
|
||||
- **Saved filters**, per agent. The current filter settings can be saved under a name, loaded with one click and deleted. There is no editing: to change one, save a new one and delete the old.
|
||||
|
||||
|
||||
Reference in new issue
Block a user