docs: improve CLAUDE.md structure and discoverability

- Move COM shorthand to prominent position after safety warning
- Add version sync note (must match package.json)
- Consolidate Key Files into 4 logical categories
- Clarify next available test port (3128)

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

src/subagent-watcher.ts

@@ -102,7 +102,7 @@ export class SubagentWatcher extends EventEmitter {
   private idleTimers = new Map<string, NodeJS.Timeout>();
   private pollInterval: NodeJS.Timeout | null = null;
   private livenessInterval: NodeJS.Timeout | null = null;
-  private isRunning = false;
+  private _isRunning = false;
   private knownSubagentDirs = new Set<string>();
 
   constructor() {
@@ -115,8 +115,8 @@ export class SubagentWatcher extends EventEmitter {
    * Start watching for subagent activity
    */
   start(): void {
-    if (this.isRunning) return;
-    this.isRunning = true;
+    if (this._isRunning) return;
+    this._isRunning = true;
 
     // Initial scan
     this.scanForSubagents();
@@ -177,11 +177,18 @@ export class SubagentWatcher extends EventEmitter {
     return false;
   }
 
+  /**
+   * Check if the watcher is currently running
+   */
+  isRunning(): boolean {
+    return this._isRunning;
+  }
+
   /**
    * Stop watching
    */
   stop(): void {
-    this.isRunning = false;
+    this._isRunning = false;
 
     if (this.pollInterval) {
       clearInterval(this.pollInterval);