AI instructions
AI instructions tell every AI feature in the app — task summaries, content drafts, financial report explanations, chat personas — how to sound. Set them once per company; some types accept per-project overrides.
Without AI instructions, the model uses generic defaults. With them, output matches your brand voice and house style.
Step-by-step
- 1Open the unified AI instructions view
Settings → AI instructions, or visit `/app/settings/ai-instructions` directly. The page lists every AI feature in the app with its current instruction status.
- 2Pick a feature to configure
Click any feature row (Task, Content plan, Financial report, etc.) to open the editor. Some features are company-scope only; some can have per-project overrides.
- 3Write the instruction
Write 1-3 paragraphs describing the desired tone, length, vocabulary to avoid, and required structure. Treat it like onboarding a new junior teammate.
- 4Add a named instruction (multi-type features)
Some types (e.g., Task) support multiple named instructions — give each a sub-name so UIs that use them can pick the right variant from a dropdown.
- 5Override per project
On the per-project view, you can write an override that replaces the company-wide instruction for that project only — useful when a client wants a specific voice.
Tips
Required instruction types refuse to generate until set — you'll see a toast with a 'Set instructions' link pointing here. Instructions are stored once in the `AiInstruction` collection; legacy per-tab UI in Settings and Project detail has been replaced by this single view. Test changes by triggering the AI feature right after editing — output reflects the new instruction immediately.
Admin configuration
AI instructions require an AI key (OpenAI or Gemini) configured in Settings → Integrations → AI keys. Only admins can edit company-wide instructions; project-scope overrides also require project edit access.