Skip to main content
Project rules are instructions the agent follows every time it works on your project. Write “Use sentence case for every button” once, instead of repeating it in every prompt. Every plan has them.
Project Settings on the Rules tab, showing rules.md and design.md with their Create file buttons

Two files

Both are plain text files in your project, in the .polymet folder. You write them in Markdown.

Create a file

  1. Click the Project settings icon next to your project’s name.
  2. Open Rules.
  3. Click Create file next to rules.md or design.md.
  4. The file opens in the code editor with a heading. Write your rules under it.
  5. Click Save, then Save in the dialog.
Until you save, the Rules tab shows Continue editing. After you save, it shows Open in editor. You can create files only on the latest version. On an older one, Create file is off and its tooltip says “Switch to the latest version to create files.”

Write rules that work

  • One rule per line, as a bullet.
  • Say what to do, with a name or a number. “Each page has at most one primary button” beats “Keep pages clean”.
  • Keep it to rules that hold for the whole project. Put one-off requests in the prompt.
An example rules.md:

With a design system

If the project is linked to a design system, the agent reads the design system’s design.md first, then yours on top. Where the two disagree, yours wins. Design guidance is capped at 10,000 characters in total. When both files together run over, the design system’s part is shortened first.