Skip to content

Architecture diagram

The diagram shows how a worker's prior career and current relationship are combined with the current firm's representation to produce match quality (MQ). The company encoder is shared: it represents both the current firm and firms in the worker's career history.

flowchart LR
    SharedEnc[Shared company encoder]

    subgraph Worker[Worker-side representation]
        direction TB
        Hist[Prior employer<br/>firm ID + firm categories]
        HistoryEvents[Prior-position details<br/>job category + seniority]
        Tokens[History tokens<br/>firm backbone + job category + seniority]
        Transformer[History transformer]
        Summary[Career-history summary]
        Rel[Current relationship state<br/>tenure + seniority + job category<br/>+ calendar year]
        Static[Worker features<br/>degree, demographics, role, location]
        WorkerHead[Employee head]
        WorkerVec[Worker vector]

        SharedEnc --> Tokens
        HistoryEvents --> Tokens
        Tokens --> Transformer --> Summary
        Summary --> WorkerHead
        Rel --> WorkerHead
        Static --> WorkerHead
        WorkerHead --> WorkerVec
    end

    subgraph Firm[Current-firm representation]
        direction TB
        FirmInput[Current firm ID + firm categories]
        FirmAbout[Optional company-description embedding]
        CompanyHead[Company head]
        FirmVec[Firm vector]

        FirmAbout --> CompanyHead
        CompanyHead --> FirmVec
    end

    Hist --> SharedEnc
    FirmInput --> SharedEnc
    SharedEnc --> CompanyHead
    WorkerVec --> MQ[Match quality<br/>cosine similarity]
    FirmVec --> MQ
    MQ --> Hazard[Separation hazard<br/>baseline + optional additive terms<br/>− beta × MQ]
    MQ -. optional objective .-> Wage[Wage-growth prediction]
    WorkerVec -. at observed moves .-> Destination[Optional destination objective<br/>rank candidate firms]
    FirmVec -. candidate firm vectors .-> Destination

Important distinction: history tokens are not final firm vectors

For each prior position, the worker tower looks up that firm's ID and configured firm categories and runs them through the shared company encoder. It then combines that backbone representation with the history event's job category and seniority. It does not use the current-firm vector produced by the full company tower: the history path omits the company-description embedding and the company head. The two paths share the encoder's learned parameters, not the company tower's final output.

The current firm's path adds the optional company-description embedding to its backbone representation and passes the result through the company head. The worker path summarizes the sequence of prior positions, combines that summary with current relationship state and configured worker features, and projects it through the employee head. MQ compares the resulting worker and current-firm vectors.

The feature names shown are those in config_full.yaml; the configured feature contract can vary. See Inputs for feature details and Objectives for the training targets.