From 035e3116ce6305a4d74132453e6c329edaf687b1 Mon Sep 17 00:00:00 2001 From: "mathieu.legault" Date: Mon, 14 Sep 2026 20:12:51 +0000 Subject: [PATCH 1/4] docs: add hidden coding-agent onboarding page at /learn/get-started Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- fern/products/home/home.yml | 5 ++- fern/products/home/pages/agent-onboarding.mdx | 39 +++++++++++++++++++ 2 files changed, 43 insertions(+), 1 deletion(-) create mode 100644 fern/products/home/pages/agent-onboarding.mdx diff --git a/fern/products/home/home.yml b/fern/products/home/home.yml index ee29ac7466..a6b3c9dfd1 100644 --- a/fern/products/home/home.yml +++ b/fern/products/home/home.yml @@ -1,3 +1,6 @@ navigation: - page: Home - path: ./pages/welcome.mdx \ No newline at end of file + path: ./pages/welcome.mdx + - page: Get started with a coding agent + path: ./pages/agent-onboarding.mdx + hidden: true \ No newline at end of file diff --git a/fern/products/home/pages/agent-onboarding.mdx b/fern/products/home/pages/agent-onboarding.mdx new file mode 100644 index 0000000000..b07a116665 --- /dev/null +++ b/fern/products/home/pages/agent-onboarding.mdx @@ -0,0 +1,39 @@ +--- +title: Get started with Fern using a coding agent +slug: get-started +description: Instructions a coding agent follows to set up Fern Docs, SDKs, or both for a user's API. +--- + +This page is written for a coding agent (Claude Code, Cursor, Codex, or similar) that a user has asked to set up Fern. Readers who aren't agents can paste the prompt from the [Fern homepage](https://buildwithfern.com) into their agent, or follow the [Docs quickstart](/learn/docs/getting-started/quickstart) or [SDKs quickstart](/learn/sdks/overview/quickstart) directly. + + + + + Before running any commands, ask the user which product they want to set up: + + - **Docs**: a documentation site built from Markdown pages and an OpenAPI spec. + - **SDKs**: client libraries in TypeScript, Python, Go, Java, C#, PHP, Ruby, Swift, or Rust, generated from an OpenAPI spec. + + Also ask whether they have an OpenAPI spec and where it lives. Wait for the answer before continuing. + + + + If the user chose Docs or both, install the `fern-docs` skill for their agent, then fetch and follow the [Docs quickstart](https://buildwithfern.com/learn/docs/getting-started/quickstart.md) step by step: + + ```bash + npx skills add fern-api/skills --skill fern-docs -a claude-code + ``` + + Use `-a cursor`, `-a codex`, or `-a github-copilot` for those agents. + + + + If the user chose SDKs or both, fetch and follow the [SDKs quickstart](https://buildwithfern.com/learn/sdks/overview/quickstart.md) step by step. Ask the user which languages they need before adding generators. + + If the user chose both, set up Docs first. SDKs reuse the same `fern` folder and API definition. + + + + Tell the user what was created, where the `fern` folder lives, and the command to run next (`fern docs dev` for Docs, `fern generate` for SDKs). + + From 5a908d73b9ee2b4ea129f2e768b6f73bfdcedf04 Mon Sep 17 00:00:00 2001 From: "mathieu.legault" Date: Mon, 14 Sep 2026 20:27:07 +0000 Subject: [PATCH 2/4] docs: use absolute slug so the page resolves at /learn/get-started Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- fern/products/home/pages/agent-onboarding.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fern/products/home/pages/agent-onboarding.mdx b/fern/products/home/pages/agent-onboarding.mdx index b07a116665..62bf81b950 100644 --- a/fern/products/home/pages/agent-onboarding.mdx +++ b/fern/products/home/pages/agent-onboarding.mdx @@ -1,6 +1,6 @@ --- title: Get started with Fern using a coding agent -slug: get-started +slug: /get-started description: Instructions a coding agent follows to set up Fern Docs, SDKs, or both for a user's API. --- From 1e6d6909a7495059a6fd1dfa38556a91a7f1df91 Mon Sep 17 00:00:00 2001 From: "mathieu.legault" Date: Mon, 14 Sep 2026 20:32:49 +0000 Subject: [PATCH 3/4] docs: page resolves at /learn/home/get-started; drop absolute slug Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- fern/products/home/pages/agent-onboarding.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fern/products/home/pages/agent-onboarding.mdx b/fern/products/home/pages/agent-onboarding.mdx index 62bf81b950..b07a116665 100644 --- a/fern/products/home/pages/agent-onboarding.mdx +++ b/fern/products/home/pages/agent-onboarding.mdx @@ -1,6 +1,6 @@ --- title: Get started with Fern using a coding agent -slug: /get-started +slug: get-started description: Instructions a coding agent follows to set up Fern Docs, SDKs, or both for a user's API. --- From 1fa6be62e4396ba6a8f5c02f2f27abfb3e426f79 Mon Sep 17 00:00:00 2001 From: "mathieu.legault" Date: Tue, 15 Sep 2026 17:17:14 +0000 Subject: [PATCH 4/4] docs: serve the agent onboarding steps only to agents via llms-only Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- fern/products/home/pages/agent-onboarding.mdx | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/fern/products/home/pages/agent-onboarding.mdx b/fern/products/home/pages/agent-onboarding.mdx index b07a116665..748b8193de 100644 --- a/fern/products/home/pages/agent-onboarding.mdx +++ b/fern/products/home/pages/agent-onboarding.mdx @@ -4,7 +4,12 @@ slug: get-started description: Instructions a coding agent follows to set up Fern Docs, SDKs, or both for a user's API. --- -This page is written for a coding agent (Claude Code, Cursor, Codex, or similar) that a user has asked to set up Fern. Readers who aren't agents can paste the prompt from the [Fern homepage](https://buildwithfern.com) into their agent, or follow the [Docs quickstart](/learn/docs/getting-started/quickstart) or [SDKs quickstart](/learn/sdks/overview/quickstart) directly. + +The instructions on this page are only served to coding agents (Claude Code, Cursor, Codex, or similar) that fetch its Markdown version. To use them, paste the prompt from the [Fern homepage](https://buildwithfern.com) into your agent. To set up Fern yourself, follow the [Docs quickstart](/learn/docs/getting-started/quickstart) or [SDKs quickstart](/learn/sdks/overview/quickstart). + + + +You are a coding agent that a user has asked to set up Fern. Follow these steps in order. @@ -37,3 +42,4 @@ This page is written for a coding agent (Claude Code, Cursor, Codex, or similar) Tell the user what was created, where the `fern` folder lives, and the command to run next (`fern docs dev` for Docs, `fern generate` for SDKs). +