c_Learn & Practice AILEARN/Write useful AGENTS.md instructions
← Level 4 · Project instructions
LEVEL 04 · 12 min

Write useful AGENTS.md instructions

AGENTS.md records reusable project guidance. Include verified commands, conventions, boundaries, and completion criteria. It is guidance, not a security barrier.

01

What is it?

AGENTS.md records reusable project guidance. Include verified commands, conventions, boundaries, and completion criteria. It is guidance, not a security barrier.

02

Why it matters

Reusable rules help keep work consistent across sessions.

03

When to use it

When the same rules apply to repeated project tasks.

04

How to do it

  1. Read the explanation and identify the files or environment involved.
  2. Use the generator for your project type. Replace every placeholder, inspect the real configuration for available commands, and save a reviewed AGENTS.md at the project root.
  3. Compare the result with the verification criteria below. Record what worked and what remains unclear.
05

Worked example

Goal

Use the generator for your project type. Replace every placeholder, inspect the real configuration for available commands, and save a reviewed AGENTS.md at the project root.

06

Try it yourself

Repeat the exercise with your own wording or a second sample. Use the smallest change that demonstrates the idea.

Prompt builder
07

Verify your result

A new task can list the instruction sources it loaded. Each documented command exists in the project.

08

Common mistakes

Copying npm commands into a non-Node project. Use commands verified for the actual stack.

09

How to recover

Stop at the first unexpected result. Preserve your current work, re-check the named file or environment, and repeat only the failing step. Ask for an explanation if the recovery is unclear.

Official references

Product interfaces and access can change. Use the linked official guide for current installation and account requirements.

OpenAI · AGENTS.md ↗Source review: 2026-09-16
Checkpoint
Esc · Close