feat: Disk-based prompt system with user customization UI

.github/workflows/ci.yml

@@ -16,7 +16,6 @@ jobs:
           node-version: '22'
           cache: 'npm'
       - run: npm ci
-      - run: npm run build:prompts
       - run: npx prettier --check .
       - run: npx eslint src/
       - run: npm run lint # TypeScript type checking
@@ -30,5 +29,4 @@ jobs:
           node-version: '22'
           cache: 'npm'
       - run: npm ci
-      - run: npm run build:prompts
       - run: npm run test

.gitignore

@@ -21,7 +21,6 @@ node_modules/
 # Build outputs
 dist/
 release/
-src/generated/
 *.log
 tmp/
 scratch/

BUILDING_WINDOWS.md

@@ -62,7 +62,7 @@ If you encounter issues with the `dev:win` script or prefer to run the steps man
 3.  **Start the Electron main process:**
     Open a **new** PowerShell terminal and run the following command:
     ```powershell
-    npm run build:prompts; npx tsc -p tsconfig.main.json; $env:NODE_ENV='development'; npx electron .
+    npx tsc -p tsconfig.main.json; $env:NODE_ENV='development'; npx electron .
     ```
 
 This will launch the application in development mode with hot-reloading for the renderer.

docs/docs.json

@@ -58,7 +58,8 @@
 							"group-chat",
 							"remote-control",
 							"ssh-remote-execution",
-							"configuration"
+							"configuration",
+							"maestro-prompts"
 						]
 					},
 					{

docs/maestro-prompts.md

@@ -0,0 +1,51 @@
+---
+title: Maestro Prompts
+description: Browse, edit, and customize the core system prompts that power Maestro's AI features.
+icon: file-pen
+---
+
+The **Maestro Prompts** tab in the Right Bar lets you browse and customize the core system prompts that drive Maestro's AI-powered features — the Onboarding Wizard, Auto Run, Group Chat, and more.
+
+## Opening Maestro Prompts
+
+**Keyboard shortcut:**
+
+- macOS: `Cmd+Shift+2`
+- Windows/Linux: `Ctrl+Shift+2`
+
+**From the Right Bar:**
+
+- Open the Right Bar and select the "Maestro Prompts" tab
+
+## Browsing Prompts
+
+Prompts are organized by category:
+
+- **Wizard** — Onboarding and setup prompts
+- **Auto Run** — Prompts used during Auto Run sessions
+- **Group Chat** — Multi-agent coordination prompts
+- **Other** — Additional system prompts
+
+Select a prompt from the list to view its content in the editor panel.
+
+## Editing Prompts
+
+1. Select a prompt from the list
+2. Modify the content in the editor
+3. Click **Save** to apply your changes
+
+Changes take effect immediately — no restart required. Your edits are stored separately from the bundled defaults, so app updates won't overwrite your customizations.
+
+## Resetting to Default
+
+Click **Reset to Default** to restore any prompt to its original bundled version. The reset takes effect immediately.
+
+## How It Works
+
+- **Bundled prompts** ship with each release in the app's bundled resources prompts directory (example: `Resources/prompts/core/`; exact resource location can vary by platform)
+- **User customizations** are stored in `userData/core-prompts-customizations.json`
+- When loading a prompt, Maestro checks for a user customization first; if none exists, it falls back to the bundled default
+
+<Note>
+Unlike SpecKit and OpenSpec commands, core prompts do not have an "Update from GitHub" button — they ship with each Maestro release.
+</Note>

package.json

@@ -19,13 +19,12 @@
 		"dev": "concurrently \"npm run dev:main\" \"npm run dev:renderer\"",
 		"dev:prod-data": "USE_PROD_DATA=1 concurrently \"npm run dev:main:prod-data\" \"npm run dev:renderer\"",
 		"dev:demo": "MAESTRO_DEMO_DIR=/tmp/maestro-demo npm run dev",
-		"dev:main": "npm run build:prompts && tsc -p tsconfig.main.json && npm run build:preload && NODE_ENV=development electron .",
-		"dev:main:prod-data": "npm run build:prompts && tsc -p tsconfig.main.json && npm run build:preload && NODE_ENV=development USE_PROD_DATA=1 electron .",
+		"dev:main": "tsc -p tsconfig.main.json && npm run build:preload && NODE_ENV=development electron .",
+		"dev:main:prod-data": "tsc -p tsconfig.main.json && npm run build:preload && NODE_ENV=development USE_PROD_DATA=1 electron .",
 		"dev:renderer": "vite",
 		"dev:web": "vite --config vite.config.web.mts",
 		"dev:win": "powershell -NoProfile -ExecutionPolicy Bypass -File ./scripts/start-dev.ps1",
-		"build": "npm run build:prompts && npm run build:main && npm run build:preload && npm run build:renderer && npm run build:web && npm run build:cli",
-		"build:prompts": "node scripts/generate-prompts.mjs",
+		"build": "npm run build:main && npm run build:preload && npm run build:renderer && npm run build:web && npm run build:cli",
 		"build:main": "tsc -p tsconfig.main.json",
 		"build:preload": "node scripts/build-preload.mjs",
 		"build:cli": "node scripts/build-cli.mjs",
@@ -116,6 +115,11 @@
 				{
 					"from": "src/prompts/openspec",
 					"to": "prompts/openspec"
+				},
+				{
+					"from": "src/prompts",
+					"to": "prompts/core",
+					"filter": ["*.md"]
 				}
 			]
 		},
@@ -148,6 +152,11 @@
 				{
 					"from": "src/prompts/openspec",
 					"to": "prompts/openspec"
+				},
+				{
+					"from": "src/prompts",
+					"to": "prompts/core",
+					"filter": ["*.md"]
 				}
 			]
 		},
@@ -172,6 +181,11 @@
 				{
 					"from": "src/prompts/openspec",
 					"to": "prompts/openspec"
+				},
+				{
+					"from": "src/prompts",
+					"to": "prompts/core",
+					"filter": ["*.md"]
 				}
 			]
 		},

scripts/start-dev.ps1

@@ -15,7 +15,7 @@ Start-Process powershell -ArgumentList '-NoExit', '-Command', $cmdRenderer
 Write-Host "Waiting for renderer dev server to start..." -ForegroundColor Yellow
 Start-Sleep -Seconds 5
 
-$cmdBuild = "Set-Location -LiteralPath '$repoRootEscaped'; npm run build:prompts; npx tsc -p tsconfig.main.json; npm run build:preload; `$env:NODE_ENV='development'; npx electron ."
+$cmdBuild = "Set-Location -LiteralPath '$repoRootEscaped'; npx tsc -p tsconfig.main.json; npm run build:preload; `$env:NODE_ENV='development'; npx electron ."
 Start-Process powershell -ArgumentList '-NoExit', '-Command', $cmdBuild
 
 Write-Host "Launched renderer and main developer windows." -ForegroundColor Green

src/__tests__/main/group-chat/group-chat-moderator.test.ts

@@ -42,6 +42,17 @@ vi.mock('electron-store', () => {
 	};
 });
 
+// Mock the prompt-manager
+vi.mock('../../../main/prompt-manager', () => ({
+	getPrompt: vi.fn((id: string) => {
+		if (id === 'group-chat-moderator-system') return 'Coordinate the group chat between @agents. Review responses and decide next steps.';
+		if (id === 'group-chat-moderator-synthesis') return 'Synthesize the agents responses into a coherent answer.';
+		if (id === 'group-chat-participant') return 'You are {{PARTICIPANT_NAME}} in {{GROUP_CHAT_NAME}}. Log path: {{LOG_PATH}}';
+		if (id === 'group-chat-participant-request') return '{{PARTICIPANT_NAME}} in {{GROUP_CHAT_NAME}}: {{MESSAGE}}';
+		throw new Error(`Unexpected prompt ID in test: ${id}`);
+	}),
+}));
+
 import {
 	spawnModerator,
 	sendToModerator,

src/__tests__/main/ipc/handlers/director-notes.test.ts

@@ -52,9 +52,12 @@ vi.mock('../../../../main/utils/context-groomer', () => ({
 	groomContext: vi.fn(),
 }));
 
-// Mock the prompts module
-vi.mock('../../../../../prompts', () => ({
-	directorNotesPrompt: 'Mock director notes prompt',
+// Mock the prompt-manager
+vi.mock('../../../../main/prompt-manager', () => ({
+	getPrompt: vi.fn((id: string) => {
+		if (id === 'director-notes') return 'Mock director notes prompt';
+		throw new Error(`Unexpected prompt id: ${id}`);
+	}),
 }));
 
 describe('director-notes IPC handlers', () => {