Rules

⚡ 3 min read

A Rule is one policy the agent should follow in a specific situation. Keep unrelated policies in separate files — do not stack several topics into one Rule.

Save each file as --kind rule --name <name>.

Shape

/transcodes asks for this shape. The CLI does not enforce it.


Size	100–500 tokens, one policy
Frontmatter	Non-empty `description`; `globs` as a YAML array (not a plain string)
Sections	`# Must`, `# Never`


---
description: Load when changing authentication or token handling
globs:
  - "src/auth/**"
  - "src/**/*.service.ts"
---
 
# Must
- Verify JWTs server-side with the project JWK (ES256)
- Treat member tokens as secrets — never paste them into chat
 
# Never
- Put tokens in URLs, logs, or commit them
- Skip step-up by calling a raw HTTP path when a Transcodes MCP tool exists

description should say when the Rule loads. globs should match the files where it applies.

If you need two unrelated Must/Never groups, split them into two Rules with their own descriptions and globs.

Save


transcodes persona save --persona developer --kind rule --name security --content-file /tmp/security.md

Next: Skills