From b908ed5d6eacea39baf9104947595287859cf690 Mon Sep 17 00:00:00 2001 From: Pedram Amini Date: Thu, 5 Feb 2026 14:42:59 -0600 Subject: [PATCH] docs: add Conductor Profile section to configuration docs Explains what the Conductor Profile is, how to configure it, what to include, and how agents use it. Previously only had brief parenthetical mentions without dedicated documentation. --- docs/configuration.md | 38 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 38 insertions(+) diff --git a/docs/configuration.md b/docs/configuration.md index 2a92f2ee..9f88c72f 100644 --- a/docs/configuration.md +++ b/docs/configuration.md @@ -20,6 +20,44 @@ Settings are organized into tabs: | **AI Commands** | View and edit slash commands, [Spec-Kit](./speckit-commands), and [OpenSpec](./openspec-commands) prompts | | **SSH Hosts** | Configure remote hosts for [SSH agent execution](./ssh-remote-execution) | +## Conductor Profile + +The **Conductor Profile** (Settings → General → **About Me**) is a short description of yourself that gets injected into every AI agent's system prompt. This helps agents understand your background, preferences, and communication style so they can tailor responses accordingly. + +**To configure:** +1. Open **Settings** (`Cmd+,` / `Ctrl+,`) → **General** tab +2. Find the **About Me** text area at the top +3. Write a brief profile describing yourself + +### What to Include + +A good conductor profile is concise (a few sentences to a short paragraph) and covers: + +- **Your role/background**: Developer, researcher, team lead, etc. +- **Technical context**: Languages you work with, tools you prefer, platforms you use +- **Communication preferences**: Direct vs. detailed, level of explanation needed +- **Work style**: Preferences for how agents should approach tasks + +### Example Profile + +``` +Security researcher. macOS desktop. TypeScript and Python for tools. +Direct communication, no fluff. Action over process. Push back on bad ideas. +Generate markdown for Obsidian. CST timezone. +``` + +### How Agents Use It + +When you start a session, Maestro includes your conductor profile in the system prompt sent to the AI agent. This means: + +- Agents adapt their response style to match your preferences +- Technical context helps agents make appropriate assumptions +- Communication preferences reduce back-and-forth clarification + +### Using in Custom Commands + +You can reference your conductor profile in [slash commands](./slash-commands) using the `{{CONDUCTOR_PROFILE}}` template variable. This is useful for commands that need to remind agents of your preferences mid-conversation. + ## Checking for Updates Maestro checks for updates automatically on startup (configurable in Settings → General → **Check for updates on startup**).