docs: Added AGENTS.md

[closedLoop]

I created an AGENTS.md file so that Cursor, Windsurf, Codex and others could easily code new apps and familiarize themselves with this new codebase. I tested it by having Windsurf + Claude 4.5 'mostly' one shot a Trello Clone.

With a combination of these rules and your type support it got there pretty quickly.
Screencast from 2025-10-11 00-38-35.webm

I was able to generate this using these steps:

1. Pull the repo using repomix

npx -y repomix --copy --remote https://github.com/remix-run/remix --ignore "packages/tar-parser/**/*,**/*test.ts"

2. Use Gemini 2.5 Pro with this system prompt and the repo above

For someone new to this repository. Please help me first build a tutorial with chapters. I want to understand the major components and ideas, understand where the live in the repo and how to use it. First build out the curriculum and tutorial chapters in Markdown format.

This generated a TUTORIAL.md file

3. Now using CODEX (gpt-5-codex medium), I used this prompt

I want to build an AGENTS.md file for this repo in the spirit of https://agents.md/. Please access this website https://agents.md for examples and usage. Use the information in @TUTORIAL.md as an initial guide. This AGENTS.md file should help users deploy new applications and build websites. It should help inform others about the methods over how it is done in React traditionally to be more helpful

4. I then asked Windsurf + Cursor to do the following

Create a new example in the @demos I want a trello todo app.
It should have boards and cards which are draggable and editable
It should persist state in a sqlite backend.
It should be styled with tailwind to adhere to the https://remix.run themes
It should be a single person app with no auth required for this demo
Consult with @AGENTS.md and other examples in the repo on how to do it.

I hope this was helpful. Thank you @mjackson and @ryanflorence for great talks and launch today!