🤖 fix: resolve Mintlify MDX compatibility issues

- Remove docs build target (Mintlify is hosted, no local build)
- Use JSX comments for Mintlify MDX compatibility in system-prompt.md
- Update sync script to use JSX comment markers
- Add .prettierignore for system-prompt.md (prettier mangles JSX comments)
- Remove invalid comment from vim-mode.md

_Generated with mux_

Author: ammar-agent

.prettierignore

@@ -0,0 +1,2 @@
+# Mintlify docs that use JSX comments which prettier mangles
+docs/system-prompt.md

Makefile

@@ -49,7 +49,7 @@ include fmt.mk
 .PHONY: test test-unit test-integration test-watch test-coverage test-e2e smoke-test
 .PHONY: dist dist-mac dist-win dist-linux
 .PHONY: vscode-ext vscode-ext-install
-.PHONY: docs docs-server
+.PHONY: docs-server
 .PHONY: storybook storybook-build test-storybook chromatic
 .PHONY: benchmark-terminal
 .PHONY: ensure-deps rebuild-native
@@ -337,10 +337,7 @@ vscode-ext-install: ## Build and install VS Code extension locally
 	@$(MAKE) -C vscode install
 
 ## Documentation
-docs: ## Build documentation (Mintlify)
-	@cd docs && npx mintlify build
-
-docs-server: node_modules/.installed ## Serve documentation locally (opens browser)
+docs-server: node_modules/.installed ## Serve documentation locally (Mintlify dev server)
 	@cd docs && npx mintlify dev
 
 ## Storybook

docs/system-prompt.md

@@ -13,7 +13,8 @@ Even with consistent support at the protocol layer, we have found that different
 
 Here's a snippet from `src/node/services/systemMessage.ts` which is our shared system prompt (minus tools).
 
-<!-- BEGIN SYSTEM_PROMPT_DOCS -->
+
+{/* BEGIN SYSTEM_PROMPT_DOCS */}
 
 ```typescript
 // The PRELUDE is intentionally minimal to not conflict with the user's instructions.
@@ -61,4 +62,5 @@ You are in a git worktree at ${workspacePath}
 }
 ```
 
-<!-- END SYSTEM_PROMPT_DOCS -->
+
+{/* END SYSTEM_PROMPT_DOCS */}

docs/vim-mode.md

@@ -3,9 +3,6 @@ title: Vim Mode
 description: Vim-style editing in the mux chat input
 ---
 
-{/_ Keep this file in sync with: - src/components/VimTextArea.tsx (implementation) - src/utils/vim.ts (core logic) - src/utils/vim.test.ts (test suite)
-_/}
-
 mux includes a built-in Vim mode for the chat input, providing familiar Vim-style editing for power users.
 
 ## Enabling Vim Mode

scripts/sync_system_prompt_docs.sh

@@ -23,8 +23,9 @@ generate_section() {
 }
 
 # Extract the current synced section from docs
+# Uses JSX-style comments for Mintlify MDX compatibility
 extract_current_section() {
-  sed -n '/<!-- BEGIN SYSTEM_PROMPT_DOCS -->/,/<!-- END SYSTEM_PROMPT_DOCS -->/p' "$DOCS_FILE" \
+  sed -n '/{\/\* BEGIN SYSTEM_PROMPT_DOCS \*\/}/,/{\/\* END SYSTEM_PROMPT_DOCS \*\/}/p' "$DOCS_FILE" \
     | tail -n +2 | head -n -1 \
     |
     # Remove first and last lines (markers)
@@ -43,14 +44,15 @@ if [[ "${1:-}" == "check" ]]; then
   echo "✅ $DOCS_FILE is in sync"
 else
   # Replace section between markers using temp file approach
+  # Uses JSX-style comments for Mintlify MDX compatibility
   {
     # Print everything up to and including BEGIN marker
-    sed -n '1,/<!-- BEGIN SYSTEM_PROMPT_DOCS -->/p' "$DOCS_FILE"
+    sed -n '1,/{\/\* BEGIN SYSTEM_PROMPT_DOCS \*\/}/p' "$DOCS_FILE"
     echo ""
     generate_section
     echo ""
     # Print END marker and everything after
-    sed -n '/<!-- END SYSTEM_PROMPT_DOCS -->/,$p' "$DOCS_FILE"
+    sed -n '/{\/\* END SYSTEM_PROMPT_DOCS \*\/}/,$p' "$DOCS_FILE"
   } >"$DOCS_FILE.tmp"
   mv "$DOCS_FILE.tmp" "$DOCS_FILE"
   echo "Updated $DOCS_FILE"