Skip to Content
DocsAGENTS.md
DocsAGENTS.md

Custom AI Instructions - AGENTS.md

Use AGENTS.md to tell Ziva how you want to make your game, without repeating the same instructions in every chat.

  1. Create a text file named AGENTS.md in your game’s folder, beside project.godot.
  2. Write a few short preferences, like the example below, and save the file.
  3. Start a new chat with /new to use the instructions.

What to write

Write things you want Ziva to follow throughout the project, such as the kind of game you are making and how much explanation you need.

Example

# My game - I'm new to Godot. Explain changes in plain language. - Keep this a simple 2D game. - Work on one small change at a time. - Ask before adding a new game mechanic.

When changes take effect

Ziva reads AGENTS.md when a chat starts. After editing it, start a new chat (/new) for the changes to apply.

Optional: other instruction locations and priority

Where Ziva looks

Ziva reads all instruction files that exist in these locations. Project files take priority over home-directory files.

LocationScope
<project>/AGENTS.mdThis project; share the file with your team if you want shared instructions
<project>/.ziva/AGENTS.mdThis project, alternative location
<project>/.agents/AGENTS.mdThis project, alternative location
~/.ziva/AGENTS.mdAll projects on this computer
~/.agents/AGENTS.mdAll projects on this computer, alternative location

<project> is the folder containing project.godot. ~ means your home folder.

See also

  • Memories - preferences Ziva saves between chats
  • Slash commands - shortcuts you use when needed
  • Skills - reusable instructions for particular tasks
Last updated on