> ## 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 0: AI Blueprint Foundation

# Wave 0: AI Blueprint Foundation

**Status**: COMPLETE
**Domain**: Foundation — the sage-blueprint stack that every downstream wave builds on.
**Owner**: @pj

***

## Scope

Wave 0 is the generative capability bedrock: the ReAct agent loop, SSE streaming chat, 5-layer skill system, Temporal workflow patterns (approval + saga), full observability stack, domain models, hiring tools, specialist agents, the employer frontend scaffolding, marketing site, and CI/CD pipeline. It is the platform on which all functional domains (Waves 1–6) stand.

This is explicitly **not** a release milestone — it is the persistent foundation. Its "complete" status means every blueprint capability is operating; it continues to evolve as downstream waves extend it.

***

## Cycles

| Cycle | Title                         | Status     | Deliverables                                                          |
| ----- | ----------------------------- | ---------- | --------------------------------------------------------------------- |
| 133.1 | Scaffold + Infra              | ✅ Complete | k3d cluster, Doppler secrets, Clerk auth, all services booting        |
| 202   | Domain Models + Skill Catalog | ✅ Complete | 8 models, 7 skill seeds, HiringEvent audit log, 30+ API endpoints     |
| 203   | Tools + Specialists           | ✅ Complete | 14 hiring tools, 6 specialist agents, RBAC policy, OTel tracing       |
| 204   | Temporal Workflows            | ✅ Complete | HiringPipeline, InterviewScheduling, PaychexOnboarding, 27 activities |
| 204.1 | Workflow Hardening            | ✅ Complete | Cerebe activities, 5 Grafana dashboards, 5 alert rules, search attrs  |
| 205   | Employer Frontend             | ✅ Complete | Chat UI, dashboard, jobs/candidates pages, 7 generative UI components |
| 205.1 | Frontend API Wiring           | ✅ Complete | Mock data deleted, TanStack Query hooks live, generated API types     |
| 209   | CI/CD + GKE                   | ✅ Complete | GHCR, ArgoCD, GKE Autopilot, ESO, branch protection                   |
| 211   | Marketing Landing Site        | ✅ Complete | Dark-first design, Clerk signup, pricing, scroll-driven animations    |
| 212   | AI Chat Hero                  | ✅ Complete | Chat endpoint, SSE proxy, conversation persistence, onboarding flow   |

***

## What Wave 0 Enables

* Every Wave 1–6 cycle assumes this foundation exists. New domain models plug into the existing ORM + Alembic + async session pattern. New agents reuse the ReAct loop + skill registry + tool policy. New workflows reuse Temporal patterns.
* The observability stack (Tempo, Loki, Grafana, OTel) is operating in k3d; downstream waves extend it (Cycle 301.x) rather than rebuild it.
* The type-safety pipeline (Pydantic → FastAPI OpenAPI → @hey-api/openapi-ts → TypeScript + Zod) is enforced by `make flux-generate-api-types` — any downstream schema change flows through automatically.

***

## Historical Context

Wave 0 was originally labeled "Bootstrap" and treated as a pre-roadmap sprint (\~1 week of compressed execution against the sage-blueprint template). The 2026-04-17 domain-reorganization of the roadmap renamed it to "AI Blueprint Foundation" to match the new construct where waves describe functional capability rather than release sequencing.
