From 3a2d20729ec5ecb7ba3efd935e466ab64ab02a98 Mon Sep 17 00:00:00 2001 From: Jason Paff Date: Fri, 2 Oct 2026 17:27:20 -0400 Subject: [PATCH] docs: show init's agent steps on a fresh create-next-app Current create-next-app writes AGENTS.md and a CLAUDE.md that imports it, so paramour init detects agent tooling on a fresh app, installs the skill to .agents/skills/ and appends its section to AGENTS.md. The getting-started page still showed both steps skipped. Co-Authored-By: Claude Opus 5.5 (1M context) --- docs/content/docs/getting-started/index.mdx | 16 +++++++++++----- 1 file changed, 11 insertions(+), 5 deletions(-) diff --git a/docs/content/docs/getting-started/index.mdx b/docs/content/docs/getting-started/index.mdx index c8c6999..0502523 100644 --- a/docs/content/docs/getting-started/index.mdx +++ b/docs/content/docs/getting-started/index.mdx @@ -48,13 +48,14 @@ paramour init ✔ wrapped next.config.ts with withTypedRoutes ✔ added "paramour" script to package.json ✔ wrote paramour-env.d.ts (1 route) - • no agent tooling detected — skipped agent skills (`paramour skills` installs to the portable .agents/skills/) - • no AGENTS.md or CLAUDE.md — skipped agents snippet + ✔ installed agent skills → .agents/skills/paramour + ✔ appended paramour section to AGENTS.md setup: ✔ route directories: app/ ✔ dependencies declared: paramour, @paramour-js/next ✔ tsconfig.json includes paramour-env.d.ts + ✔ agent skills: .agents/skills/paramour up to date Commit the generated artifact — `paramour check` verifies it stays current in CI. ``` @@ -75,12 +76,17 @@ Four things, each idempotent (rerunning init never clobbers your edits): registry; commit it like a lockfile. The [registry page](/docs/concepts/registry) explains how it works. -The two skipped steps are for projects with coding agents in the loop: when +The two agent lines in the output are for projects with coding agents in +the loop. When init detects agent tooling (a `.claude/`, `.cursor/`, `.codex/`, or `.agents/` directory, or a root `AGENTS.md`), it also installs the bundled [agent skill](/docs/guides/ai-agents) and appends a paramour section to your -agent instructions file — so your agent learns the library the moment you -do. On a fresh `create-next-app` there's nothing to detect, hence the skips. +agent instructions file, so your agent learns the library the moment you +do. Current `create-next-app` writes an `AGENTS.md` (and a `CLAUDE.md` that +imports it), so both steps run on a fresh app: the skill lands in the +portable `.agents/skills/`, and the paramour section goes below Next's own +block in `AGENTS.md`, between its own markers. In a project with no agent +tooling, init skips both steps and says so. ## Define your first route