From 9835e13fee0b9d3991c2052c94a637e29f732248 Mon Sep 17 00:00:00 2001
From: dave <Jeremykalmus@gmail.com>
Date: Sun, 11 Jan 2026 15:26:10 -0800
Subject: [PATCH] feat(polecat): add AGENTS.md fallback copy from mayor/rig
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

When creating or repairing worktrees, if AGENTS.md doesn't exist after
checkout (e.g., stale fetch or local-only file), copy it from mayor/rig.
This ensures polecats always have the critical "land the plane" instructions.

Applied to both AddWithOptions and RepairWorktreeWithOptions for
consistency. Errors are non-fatal (warning only).

Fixes: gt-sq1.2

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 internal/polecat/manager.go | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/internal/polecat/manager.go b/internal/polecat/manager.go
index 8490a44f..23389c3a 100644
--- a/internal/polecat/manager.go
+++ b/internal/polecat/manager.go
@@ -282,6 +282,18 @@ func (m *Manager) AddWithOptions(name string, opts AddOptions) (*Polecat, error)
 		return nil, fmt.Errorf("creating worktree from %s: %w", startPoint, err)
 	}
 
+	// Ensure AGENTS.md exists - critical for polecats to "land the plane"
+	// Fall back to copy from mayor/rig if not in git (e.g., stale fetch, local-only file)
+	agentsMDPath := filepath.Join(clonePath, "AGENTS.md")
+	if _, err := os.Stat(agentsMDPath); os.IsNotExist(err) {
+		srcPath := filepath.Join(m.rig.Path, "mayor", "rig", "AGENTS.md")
+		if srcData, readErr := os.ReadFile(srcPath); readErr == nil {
+			if writeErr := os.WriteFile(agentsMDPath, srcData, 0644); writeErr != nil {
+				fmt.Printf("Warning: could not copy AGENTS.md: %v\n", writeErr)
+			}
+		}
+	}
+
 	// NOTE: We intentionally do NOT write to CLAUDE.md here.
 	// Gas Town context is injected ephemerally via SessionStart hook (gt prime).
 	// Writing to CLAUDE.md would overwrite project instructions and could leak
@@ -554,6 +566,18 @@ func (m *Manager) RepairWorktreeWithOptions(name string, force bool, opts AddOpt
 		return nil, fmt.Errorf("creating fresh worktree from %s: %w", startPoint, err)
 	}
 
+	// Ensure AGENTS.md exists - critical for polecats to "land the plane"
+	// Fall back to copy from mayor/rig if not in git (e.g., stale fetch, local-only file)
+	agentsMDPath := filepath.Join(newClonePath, "AGENTS.md")
+	if _, err := os.Stat(agentsMDPath); os.IsNotExist(err) {
+		srcPath := filepath.Join(m.rig.Path, "mayor", "rig", "AGENTS.md")
+		if srcData, readErr := os.ReadFile(srcPath); readErr == nil {
+			if writeErr := os.WriteFile(agentsMDPath, srcData, 0644); writeErr != nil {
+				fmt.Printf("Warning: could not copy AGENTS.md: %v\n", writeErr)
+			}
+		}
+	}
+
 	// NOTE: We intentionally do NOT write to CLAUDE.md here.
 	// Gas Town context is injected ephemerally via SessionStart hook (gt prime).