Skip to content

'AGENTS.md outperforms skills in our agent evals' - compressed index is not being created in AGENTS.md #89240

@spatulatom

Description

@spatulatom

Link to the code that reproduces this issue

https://github.com/spatulatom/reproduction-app

To Reproduce

This blog posts https://vercel.com/blog/agents-md-outperforms-skills-in-our-agent-evals recommends follwing steps:
One command sets this up for your Next.js project:

  1. npx @next/codemod@canary agents-md

This functionality is part of the official @next/codemod package.

This command does three things:

1.1. Detects your Next.js version

1.2. Downloads matching documentation to .next-docs/

1.3. Injects the compressed index into your AGENTS.md - COMPRESSED INDEX IS NOT BEING INJECTED INTO AGENTS.MD

Current vs. Expected behavior

currently AGENTS.md looks liekie this:

[Next.js Docs Index]|root: ./.next-docs|STOP. What you remember about Next.js is WRONG for this project. Always search docs and read before any task.|If docs missing, run this command first: npx @next/codemod agents-md --output AGENTS.md

what was exepcted that compressed relevant next.js documentation would have been injected in AGENTS.md

Provide environment information

Operating System:
  Platform: win32
  Arch: x64
  Version: Windows 11 Home
  Available memory (MB): 32181
  Available CPU cores: 16
Binaries:
  Node: 24.13.0
  npm: 11.6.2
  Yarn: N/A
  pnpm: 10.15.0
Relevant Packages:
  next: 16.1.4
  eslint-config-next: N/A
  react: 19.2.4
  react-dom: 19.2.4
  typescript: 5.9.3
Next.js Config:
  output: N/A

Which area(s) are affected? (Select all that apply)

Not sure

Which stage(s) are affected? (Select all that apply)

next dev (local)

Additional context

I tested my reproduction in vscode

Metadata

Metadata

Assignees

No one assigned

    Labels

    UpstreamRelated to using Next.js with a third-party dependency. (e.g., React, UI/icon libraries, etc.).

    Type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions