> ## Documentation Index
> Fetch the complete documentation index at: https://specs.flux.employinc.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Wave 2: Job Posting

# Wave 2: Job Posting

**Status**: IN PROGRESS
**Domain**: Job creation (JD generation, screening questionnaires), multi-channel distribution to job boards, and agentic tier-selection + budget optimization.
**Owner**: @pj

***

## Scope

Wave 2 owns the job lifecycle from "employer decides to post" through "job is live on the right boards with the right budget." It encompasses:

* Conversational job intake (handled by Wave 0 tools — `define_hiring_need`, `research_candidate_profiles`, `generate_job_description`, `create_screening_questionnaire`).
* The **3-tier distribution architecture** per the 2026-03-28 Job Distribution Strategy ADR:
  * Tier 1 (Direct): Indeed Sponsored Jobs, LinkedIn Jobs, ZipRecruiter
  * Tier 2 (Programmatic): Appcast, Joveo, PandoLogic
  * Tier 3 (Marketplace): JobGet, Vonq
* AI-driven channel selection, CPC/CPA budget optimization, real-time reallocation.
* Application ingestion from all channels via normalized webhook and polling paths.

Wave 2 does not own candidate identity or portal (Wave 3), hiring decisions (Wave 4), or infrastructure (Wave 5). It owns the pipeline from job creation to candidate arrival.

***

## Cycles

| Cycle | Title                           | Status | Phase                                                  |
| ----- | ------------------------------- | ------ | ------------------------------------------------------ |
| 208   | Agentic Job Distribution Engine | Draft  | 3 phases — Phase 1 in M1, Phase 2 in M3, Phase 3 in M3 |

### Cycle 208 phase breakdown

* **Phase 1** (M1 Paychex Pilot floor): 3-tier `JobDistributionChannel` abstraction, 8 channel adapters scaffolded with full interface contracts, **Indeed Sponsored Jobs live**, AI tier-selection reasoning operational over live channels.
* **Phase 2** (M3 post-pilot): Appcast programmatic live, budget-reallocation optimization loop, cross-channel attribution.
* **Phase 3** (M3 post-pilot): LinkedIn, ZipRecruiter, Joveo, PandoLogic, JobGet, Vonq live; predictive models for time-to-fill and cost-per-hire.

***

## M1 Paychex Pilot Contribution

**Floor**:

* Cycle 208 Phase 1 in full — 3-tier architecture, 8 scaffolded adapters, Indeed live, AI tier-selection reasoning.

**Stretch** (governed by CL-2):

* LinkedIn Jobs API live as a second Tier-1 channel, if sandbox approval lands within \~5 days.

**Explicitly out of pilot**:

* ZipRecruiter, Appcast, JobGet, Vonq live (M3 post-pilot).
* Budget optimization loop (M3).
* Predictive models (M3).

***

## Dependencies

* Wave 0: ReAct agent + tool system + Temporal workflows (used for `DistributionOptimizationWorkflow`).
* Wave 1: Employer chat surface (agent invokes `post_to_job_boards` tool).
* Wave 5: Observability stack (channel-level metrics, distribution dashboards — Cycle 301.1).
* Wave 3: Candidate identity (Cycle 217) for application ingestion deduplication.

***

## Strategic Importance

Job distribution is **the only per-transaction revenue path** in the pilot (Paychex receives a per-job revenue share for channel distribution; job board fees flow through channels). Cycle 208 Phase 1 shipping on time is the commercial underpinning of the partnership.

The 3-tier architecture also differentiates Flux from single-aggregator competitors (see ADR `2026-03-28-job-distribution-strategy.md`). Blue-collar candidates require Tier 3 marketplaces; white-collar require Tier 1 direct. A single-aggregator strategy would have failed the small-business market.

***

## Historical Context

Wave 2 was previously labeled "Revenue + Platform Foundation" and bundled job distribution with canonical schema, pricing, and staging. In the 2026-04-17 domain-reorganization: pricing (211.1) moved to Wave 5, staging (209.1) moved to Wave 5, canonical schema Part 2 (210) stays with the Wave 2 lineage as canonical-adjacent work tracked in post-pilot planning. Wave 2 is now narrowly scoped to job posting and distribution.