Symlink agents/AGENTS.md to ~/.claude/CLAUDE.md

Replace programmatic write of global CLAUDE.md with a repo-managed
file and symlink, matching the pattern used for skills and custom agents.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: drn

agents/AGENTS.md

@@ -0,0 +1,18 @@
+## TTS Notifications
+
+**ALWAYS speak aloud when completing ANY task or waiting for user input.** This is mandatory.
+
+**First, check if on a call:**
+```bash
+mic-check  # returns "active" (exit 0) or "inactive" (exit 1)
+```
+If mic is **active**, skip TTS entirely — user is in a call. Do not speak.
+
+When mic is inactive, use TTS:
+```
+Tool: mcp__tts__openai_tts
+Speed: 1.4
+Words: 2-4 max (e.g., "Done", "Updated config", "Need input")
+```
+
+Do this BEFORE moving to the next task. If you forget, you're not following instructions.

cli/commands/install/agents.go

@@ -9,27 +9,6 @@ import (
 	"github.com/drn/dots/pkg/path"
 )
 
-// ttsInstructions is the global CLAUDE.md content for TTS notifications
-const ttsInstructions = `## TTS Notifications
-
-**ALWAYS speak aloud when completing ANY task or waiting for user input.** This is mandatory.
-
-**First, check if on a call:**
-` + "```bash" + `
-mic-check  # returns "active" (exit 0) or "inactive" (exit 1)
-` + "```" + `
-If mic is **active**, skip TTS entirely — user is in a call. Do not speak.
-
-When mic is inactive, use TTS:
-` + "```" + `
-Tool: mcp__tts__openai_tts
-Speed: 1.4
-Words: 2-4 max (e.g., "Done", "Updated config", "Need input")
-` + "```" + `
-
-Do this BEFORE moving to the next task. If you forget, you're not following instructions.
-`
-
 // Agents - Installs agent skills and custom agents for Claude Code and Codex
 func (i Install) Agents() {
 	log.Action("Install Agents")
@@ -58,23 +37,14 @@ func (i Install) Agents() {
 	}
 	link.Soft(skillsSource, path.FromHome(".agents/skills"))
 
-	// Install global CLAUDE.md with TTS instructions
-	installClaudeMD()
+	// Symlink global CLAUDE.md
+	claudeMDSource := path.FromDots("agents/AGENTS.md")
+	link.Soft(claudeMDSource, path.FromHome(".claude/CLAUDE.md"))
 
 	// Install TTS MCP server in global settings
 	installTTSServer()
 }
 
-// installClaudeMD writes ~/.claude/CLAUDE.md with TTS instructions
-func installClaudeMD() {
-	target := path.FromHome(".claude/CLAUDE.md")
-	if err := os.WriteFile(target, []byte(ttsInstructions), 0644); err != nil {
-		log.Error("Failed to write ~/.claude/CLAUDE.md: %s", err.Error())
-		return
-	}
-	log.Info("Installed ~/.claude/CLAUDE.md")
-}
-
 // installTTSServer adds the TTS MCP server to ~/.claude/settings.json
 func installTTSServer() {
 	settingsPath := path.FromHome(".claude/settings.json")