Files
krow_backend/skills/create-position.md
Suriyakumarvijayanayagam dc785b917c
Some checks failed
CI / test (push) Failing after 4m41s
CI / fixture (push) Failing after 8s
Separate what a worker does from what a company needs filled
Owliver could offer neither create. The Create Position flow worked and no chip
anywhere suggested it, because the chip row is entirely the backend's static
catalogue and no intent in it wrote anything. The gap was never in the
frontend's trigger matching — every phrasing already routed.

`employee_roles` is the supply side of `job_postings`. A posting is what the
ORGANIZATION needs filled; this is what a WORKER says they do. They share a
vocabulary and almost nothing else: "3 years" on a posting is a minimum an
applicant must clear, and the same words here are what the person has. There is
deliberately no foreign key between them — supply and demand already meet
through `job_applications`, which carries the funnel, the interview and the
outcome, and a second weaker link would disagree with it the first time
somebody withdrew.

NO NEW COMPANY ENTITY, AND THAT IS THE LOAD-BEARING DECISION. "Create a company
position" reads like it needs a client record. `organizations` is the TENANT —
absent from the resource table, absent from the policy map, written only by the
seeder — so creating a row there from a chat flow would provision a new tenant,
and the position would carry an org_id the operator's session cannot see. The
operator could never view the record they just created. That breaks I5 and I1
to add a feature nobody asked for. The client stays free text on the posting,
per blueprint decision D2, and the flow simply offers the clients this
organization already staffs for as chips. No schema change, no endpoint change.

Create is operators-only, and that is an I1 decision rather than a deferral.
The worker is named explicitly on the row and is deliberately NOT derived from
the session, because an operator recording a role on somebody's behalf is the
whole point of the flow. Granting talent the same Create would let a talent
caller write a role under any worker_email in the tenant — the attribution hole
Phase 3D closed elsewhere. Talent reads its own via a ScopeEmail predicate,
which is in place now so the grant is one line when a talent console exists.

`created_by` is in gen_resources.py's SERVER_OWNED as well as the policy's
Derived list. Both are required and the pairing is easy to miss: Derived fills
the column from the session, SERVER_OWNED is what makes the descriptor ReadOnly
so a request body cannot set it in the first place. Without it,
TestDerivedColumnsAreReadOnlyOrTalentScoped fails — verified by mutation, not
by reading.

The two catalogue intents carry PHRASE terms only. A bare "position" or "role"
term scores 10, the same as every reading on that page, and wins the tie on
declaration order — so a create chip would have arrived by evicting
`positions-attention` from the exact ordered result TestPositionsSuggestions
asserts. An offer to create something must not displace the reading a person
actually asked for. Neither declares a Subject, on the precedent of
`position-spec-steps`: a Subject would let the bare query "summarize" match
through matchShape and survive filterOnTopic. Neither declares a Signal, so an
empty composer still reports what the organization needs rather than proposing
paperwork.

Chip text is the coupling with nothing else holding it together: no page
context declares `capabilities`, so every server suggestion dispatches as its
own TEXT and is answered by whichever skill's trigger that text matches. A
renamed chip would open nothing, silently. Asserted on the frontend side.

The down migration drops `employee_role_status` and keeps `english_level`,
which is shared with job_postings.english_required and
job_applications.english_level. Rolled back and re-applied against the
database to prove it, not asserted.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PJvibeSc1JYXjatankqM1g
2026-09-02 15:29:25 +05:30

2.6 KiB
Raw Permalink Blame History

id, name, description, pages, status, prompt, triggers, actions
id name description pages status prompt triggers actions
create-position Create Position Create a position by answering a few questions in the chat.
positions
active Create a position
create a position
create position
create a client
create client
add a client
new client
create a * position
create * position
new position
new * position
post a job
post a * job
open a role
open a * role
add a position
i want to hire
create_position

Create Position

Purpose

Create a position without leaving the Positions page. Owliver asks for what it does not already know, one question at a time, offers the answers as chips, then reads the whole thing back before anything is written.

No form opens. No page is navigated to. The record created is the same JobPosting the manual form writes, through the same create action.

Capabilities

  • Understand requests to create positions.
  • Read the role, location, pay, experience, English level and certifications out of a single sentence.
  • Ask only for what the request did not already answer.
  • Offer each answer as a suggestion, so the whole flow can be clicked.
  • Read the position back for confirmation before creating it.
  • Create the position on the page you are already on.

Conversation

Each line is field | question | suggestions | required?. Suggestions beginning with @ come from the application's own data, so a role category added in the form is offered here without this file changing.

@companies is the clients this organization already staffs for, read off the postings already on screen. Picking one is a tap; typing a name that is not on the list is how a new client is named, which is all "create a client" has ever meant here — the company is a field on the position, not a record of its own.

  • company | Which client is this role for? | @companies | required
  • role_category | What role are you hiring for? | @roles | required
  • location | Where will this role be based? | Chennai; Bengaluru; Coimbatore; Bay Area; Other | required
  • pay | What is the pay range? | $18–$28/hr; $25–$35/hr; $30–$40/hr; Custom | required
  • min_experience_years | Any minimum experience? | No minimum; 1 year; 2 years; 3+ years | optional
  • english_required | What is the minimum English level? | @english | optional
  • certifications_required | Any required certifications? | @certifications; None | optional

Actions

  • create_position