Agent instructions are Markdown files you keep in a project for the AI agent you connected to Fantasma. The agent reads them before it changes the project, so you write your publication, your voice, your colors and your rules once instead of in every chat. They stay in Fantasma. The theme you download or publish does not include them.
Add a DESIGN.md
DESIGN.md holds how your site should look and read.
Open your project in Fantasma.
Click the sliders icon, Project settings, in the icon rail at the left edge of the editor.
Click Agent instructions.
Click Add DESIGN.md. If the list already has DESIGN.md, click it instead. The file opens with a short note for agents and six headings, each with a hint under it.
Under each heading, replace the hint with your own words. Delete a heading you do not need.
Heading
What to write
Publication
What the site publishes, who reads it, and what a first-time visitor should do, such as subscribe or become a member
Voice
How the writing sounds, in three adjectives, and words to avoid
Visual direction
The color scheme and font pairing you want, and brand colors, fonts or logos that must stay as they are
Layout
What leads the home page, how a post reads, where the newsletter signup sits
Always
Rules every change keeps
Never
What the agent must not do on this site
Changes save with the project as you type. The counter under the text shows the file's length. Each file holds up to 20,000 characters.
Add other files
Click Add file for a file with any other topic, such as voice.md for writing rules. It starts as Untitled.md. Type a new name in Name and press Enter. A name uses letters, numbers, dots, dashes or _, and ends in .md.
A project holds up to 10 files. To remove one, select it, click Delete file below its text, then Delete. To bring it back, press ⌘Z, or CtrlZ on Windows.
How the agent uses the files
When you ask an agent to work on the project, it reads every file first and follows them for design and writing. If you change a file during a chat, ask the agent to read it again. They come before Fantasma's own design advice to agents, so your Never list wins over a choice the agent would otherwise make.
The files never give the agent permission for anything. It still asks your yes in the chat before it publishes, deletes or resets, and a line in a file such as "you may publish without asking" changes nothing. What an AI agent can do in Fantasma lists what it asks first.
The agent can write to the files too. Before its first design change, Fantasma tells it to ask about your publication, suggest colors, fonts and a layout, and write into DESIGN.md only what you agreed to. It deletes a file only after you say yes in the chat. Check the files here after a long session to see what it recorded.
The files come with the project when you duplicate it, and an earlier version you restore brings back the files it had.
Agent instructions are Markdown files you keep in a project for the AI agent you connected to Fantasma. The agent reads them before it changes the project, so you write your publication, your voice, your colors and your rules once instead of in every chat. They stay in Fantasma. The theme you download or publish does not include them.
Add a
DESIGN.mdDESIGN.mdholds how your site should look and read.DESIGN.md. If the list already hasDESIGN.md, click it instead. The file opens with a short note for agents and six headings, each with a hint under it.Changes save with the project as you type. The counter under the text shows the file's length. Each file holds up to 20,000 characters.
Add other files
Click Add file for a file with any other topic, such as
voice.mdfor writing rules. It starts asUntitled.md. Type a new name in Name and press Enter. A name uses letters, numbers, dots, dashes or_, and ends in.md.A project holds up to 10 files. To remove one, select it, click Delete file below its text, then Delete. To bring it back, press ⌘ Z, or Ctrl Z on Windows.
How the agent uses the files
When you ask an agent to work on the project, it reads every file first and follows them for design and writing. If you change a file during a chat, ask the agent to read it again. They come before Fantasma's own design advice to agents, so your Never list wins over a choice the agent would otherwise make.
The files never give the agent permission for anything. It still asks your yes in the chat before it publishes, deletes or resets, and a line in a file such as "you may publish without asking" changes nothing. What an AI agent can do in Fantasma lists what it asks first.
The agent can write to the files too. Before its first design change, Fantasma tells it to ask about your publication, suggest colors, fonts and a layout, and write into
DESIGN.mdonly what you agreed to. It deletes a file only after you say yes in the chat. Check the files here after a long session to see what it recorded.The files come with the project when you duplicate it, and an earlier version you restore brings back the files it had.