Agents guide: AGENTS.md, MCP, skills
An agent works best when it can read the rules of a project and call its tools. fw gives it three things: instruction files, an MCP server and skills.
Instruction files
Section titled “Instruction files”Put an AGENTS.md at the root of the repository. It holds the rules an agent must follow: how to build, how to test, what not to touch. Claude Code reads CLAUDE.md; keep it as a short pointer to AGENTS.md.
Run fw onboard [dir] | fw onboard export <all|mcp|opencode|zed> [--dir <dir>]. It describes the workspace for agents and can export configs for MCP, OpenCode and Zed.
fw onboard export allPlain-text docs
Section titled “Plain-text docs”This site serves text for machines:
- llms.txt lists every page with a one-line note.
- llms-full.txt holds every page in one file.
- Add
index.mdto any page address for the markdown source, for example/cli/index.md.
fw mcp | fw mcp <list|add|remove> serves fw tools over stdio, and fw serve serves them over HTTP on /mcp. The server lists 17 tools. Each has a page with its input schema: see the MCP tools.
Skills
Section titled “Skills”Skills are folders with a SKILL.md. The command is fw skills <list|read|install>.
fw skills listfw skills read <name>Check your setup
Section titled “Check your setup”- Run
fw onboard export mcpin your project. - Open the
.mcp.jsonit wrote. - Start your agent and ask it to call
fw_status.