oak-domain-career

A career-transition & reskilling domain for the OakQuant platform — the third domain built on Timber's plugin system, and the platform's counter-cyclical pillar.

Career DNA is LIVE in production, across all three layers. A person can discover their Career DNA — a short, evidence-grounded read of their interests, work style, values, and readiness for a career move, with a personalized narrative — two ways:

• As a launchable assessment from the Account page (/flows/career_dna_evaluation), a grove HITL flow driven by the same engine as Financial DNA (context → four dimension screens → deterministic scoring → an AI-written, anti-Barnum read).
• Through the career coach in chat ("What's my Career DNA?"), an acorn assistant profile.

It ships as a discoverable plugin that registers into timber/grove/acorn at startup with zero edits to any sibling repo (ADR-0003), and it is fully ring-fenced by capability: grove serves a generic home/nav and this domain contributes its own, gated to the career capability, and every /api/v3/career endpoint is reachable only by a career-provisioned tenant (grove's default router guard). The other three R1 flows (layoff-triage, land-a-role, reskill) are next. See docs/STATUS.md.

What it is

oak-domain-career is a discoverable Timber domain plugin. Installing it will add a career-transition capability to an OakQuant deployment; leaving it out is a no-op. Like the other two domains it is fully additive and opt-in — it ships its own models, services, and integration points and wires them into the platform's shared registries at startup, with no edits to the core Timber, Grove, or Acorn libraries.

Why career transition — the counter-cyclical pillar

OakQuant's portfolio thesis is one engine across the whole economic cycle:

Career transition is counter-cyclical: layoffs are the demand signal. It is the domain "everyone needs in a bust," and it runs on the same seams as the other two — assessment → goal → workflow → outcome, with a continuous-learning loop closing on real placement data.

See docs/00-ambition.md for the full thesis, and research/ for the market, competitive, funding, and monetization analysis that this plan is built on.

The first release (R1) — four flows, one arc

R1 is deliberately a full arc rather than a single feature, because the flows chain off a shared spine (Career DNA feeds the other three):

1. Career DNA — a HITL behavioral + skills assessment → persona, skill-gap map, and a readiness/risk score. The root the other three consume. (Mirrors Financial DNA.)
2. Layoff triage (first 72 hrs) — the counter-cyclical entry point: just-laid-off intake → benefits/runway math → an immediate, routed action plan with SLAs.
3. Land your next role — a CareerGoal with a deadline-driven application pipeline, résumé/brand imagery, and interview-prep video.
4. Reskill pathway — an adaptive learning path with mastery tracking — the tightest continuous-learning loop.

Start with the product narrative: docs/application-flows-and-benefits.md — every flow as Who / How / Benefit, with a visual SVG process diagram each. Internal flow detail: docs/02-flows.md.

The plugin shape

This package plugs into all three OakQuant layers through one entry point per layer. Each layer discovers only its own entry-point group and imports only that entry point's module — so the Timber layer never pulls in Grove/FastAPI or Acorn.

Repository layout

oak-domain-career/
├── README.md · LICENSE · pyproject.toml · CHANGELOG.md · .gitignore
├── .github/workflows/release.yml     # PyPI Trusted-Publishing on version bump (parity w/ siblings)
├── docs/                             # product narrative + SVG diagrams, ambition, plan, architecture, ADRs
│   ├── application-flows-and-benefits.md   # ← flagship user-facing doc (Who/How/Benefit + diagrams)
│   ├── funded-training-and-benefits-resources.md
│   └── diagrams/                     # generated SVG process diagrams (generate.mjs)
├── research/                         # competitive / funding / market / monetization / regulatory
├── oak_domain_career/                # the package skeleton (contracts + TODOs, no behavior yet)
│   ├── domain.py  models.py  grove_plugin.py  acorn_plugin.py
│   ├── calendar_taxonomy.py  routing_seed.py
│   └── services/                     # assessment / pathway / job_search / triage / outcome / calendar / routing
├── tests/                            # discovery test skeleton
└── config/                           # future Tier-1 config dir (grove.feature_packages)

Relationship to the other domain repos

Stored on GitHub exactly like its siblings under the oakquant-ai org (github.com/oakquant-ai/oak-domain-career), same main default branch, same root files, same .github/workflows/release.yml, same package/tests layout. See docs/03-architecture.md for what it reuses from oak-domain-investments (Financial DNA, the adaptive engine, Plaid, calendar generators) versus what is net-new.

Status & next steps

This is a planning repository. The build sequence, open questions, and the (future) integration checkpoints that will require touching other repos are tracked in docs/STATUS.md.