Phase 1.5: Docs Site

Status: In progress
Target: docs.ibexharness.com
Depends on: Phase 1 complete; landing + DNS ready (ibexdepo)
Blocks: Phase 2 entry (docs-first sequencing)

Purpose

Ship a public Fumadocs documentation site at docs.ibexharness.com with the Matte Graphite design system, aligned with the marketing landing at ibexharness.com. Engineering docs remain in docs/ (ADRs, roadmap); the Fumadocs app lives in docs/app/; public MDX in docs/app/content/ (D.2.1+).

Wave-based delivery

One focused PR per wave. Do not batch milestones.

Wave	Milestones	Outcome
0	(scaffold)	Roadmap, ADR-0023, governance
1	D.1.1, D.1.2	pnpm + Turborepo + Cursor rules
2	D.2.1–D.2.2, D.2.7	Design shell (design gate after D.2.2)
3	D.2.3	MDX component kit
4	D.2.4–D.2.6	Search, code blocks, OG
5	D.3.1, D.2.8	IA skeleton + 404
6–8	D.3.2 (sections)	Content by section
9	D.3.3, D.3.4	Quickstart + manual API
10	D.4.1	Superseded — Cloudflare Workers + GHA deploy
11	D.4.2, D.5.2	CI gates (partial)
12	D.5.1, D.6.2–D.6.3	Production launch

Current wave: 11–12 — D.3.3 quickstart polish; production deploy complete (#129–#133)

Goals

See goals.md. Milestone index: PHASE_1_5_DOCS_SITE_MILESTONES.md.

References

MASTER_BRIEF.md — design and technical spec (canonical)
CONTENT_SOURCES.md — engineering doc → public page mapping
ADR-0023

Entry criteria

Phase 1 exit complete
ibexharness.com live; docs CNAME in Cloudflare (DNS only)
Phase 1.5 roadmap scaffold merged (Wave 0)

Exit criteria

https://docs.ibexharness.com serves the Fumadocs site (200)
Matte Graphite design passes visual QA (D.5.1)
infra/scripts/verify_phase15.sh passes against production
Cross-links: landing ↔ docs; both sitemaps in GSC
docs-checks CI green on PRs touching docs/app/