Skip to main content
TeamCopilot supports workspace-level custom instructions through a file called USER_INSTRUCTIONS.md. This file lets you define default instructions that should apply to every new AI session in that workspace.

​
Why you would use this

Custom instructions are useful when you want TeamCopilot to consistently follow workspace-wide rules or defaults. For example, you might use USER_INSTRUCTIONS.md to tell the AI:
  • information about what your organization does and which industry it is in
  • which coding standards your team follows
  • which internal conventions matter most
  • what environments or systems it should be careful with
  • how you want answers formatted by default
This is best for rules that should apply broadly across the workspace, not just to a single skill or workflow.

​
How it works

Each time a new chat session is created with the AI, the contents of the USER_INSTRUCTIONS.md are injected into the chat automatically.

​
Where the file lives

The file must be placed at the root of your TeamCopilot workspace:

​
How to modify it

TeamCopilot includes a built-in UI for editing workspace-level custom instructions. To update them:
  1. Open the AI chat section in TeamCopilot.
  2. Click Modify global AI instructions.
  3. Edit the contents in the editor page that opens.
  4. Click Save, or use Cmd+S / Ctrl+S.
Changes are saved immediately to USER_INSTRUCTIONS.md at the workspace root. Only users with the Engineer role can modify these instructions. Other users can still see the button, but TeamCopilot will tell them that only engineers can make changes. If you prefer, you can still edit the file directly on disk at:

​
Example

Below is an example of the kind of company context you can put into USER_INSTRUCTIONS.md: