From f1380e8b1712a105ccd8df1dbac930ffcf6db315 Mon Sep 17 00:00:00 2001
From: matt wilkie <maphew@gmail.com>
Date: Fri, 19 Dec 2025 18:50:41 -0700
Subject: [PATCH] Refactor init command and remove redundant @AGENTS.md (#648)

---
 @AGENTS.md     | 40 ----------------------------------------
 cmd/bd/init.go | 16 +++++++---------
 2 files changed, 7 insertions(+), 49 deletions(-)
 delete mode 100644 @AGENTS.md

diff --git a/@AGENTS.md b/@AGENTS.md
deleted file mode 100644
index df7a4af9..00000000
--- a/@AGENTS.md
+++ /dev/null
@@ -1,40 +0,0 @@
-# Agent Instructions
-
-This project uses **bd** (beads) for issue tracking. Run `bd onboard` to get started.
-
-## Quick Reference
-
-```bash
-bd ready              # Find available work
-bd show <id>          # View issue details
-bd update <id> --status in_progress  # Claim work
-bd close <id>         # Complete work
-bd sync               # Sync with git
-```
-
-## Landing the Plane (Session Completion)
-
-**When ending a work session**, you MUST complete ALL steps below. Work is NOT complete until `git push` succeeds.
-
-**MANDATORY WORKFLOW:**
-
-1. **File issues for remaining work** - Create issues for anything that needs follow-up
-2. **Run quality gates** (if code changed) - Tests, linters, builds
-3. **Update issue status** - Close finished work, update in-progress items
-4. **PUSH TO REMOTE** - This is MANDATORY:
-   ```bash
-   git pull --rebase
-   bd sync
-   git push
-   git status  # MUST show "up to date with origin"
-   ```
-5. **Clean up** - Clear stashes, prune remote branches
-6. **Verify** - All changes committed AND pushed
-7. **Hand off** - Provide context for next session
-
-**CRITICAL RULES:**
-- Work is NOT complete until `git push` succeeds
-- NEVER stop before pushing - that leaves work stranded locally
-- NEVER say "ready to push when you are" - YOU must push
-- If push fails, resolve and retry until it succeeds
-
diff --git a/cmd/bd/init.go b/cmd/bd/init.go
index 9727b2c2..8109cb94 100644
--- a/cmd/bd/init.go
+++ b/cmd/bd/init.go
@@ -1586,17 +1586,15 @@ const landingThePlaneSection = `
 - If push fails, resolve and retry until it succeeds
 `
 
-// addLandingThePlaneInstructions adds "landing the plane" instructions to AGENTS.md and @AGENTS.md
+// addLandingThePlaneInstructions adds "landing the plane" instructions to AGENTS.md
 func addLandingThePlaneInstructions(verbose bool) {
-	// Files to update (AGENTS.md and @AGENTS.md for web Claude)
-	agentFiles := []string{"AGENTS.md", "@AGENTS.md"}
+	// File to update (AGENTS.md is the standard comprehensive documentation file)
+	agentFile := "AGENTS.md"
 
-	for _, filename := range agentFiles {
-		if err := updateAgentFile(filename, verbose); err != nil {
-			// Non-fatal - continue with other files
-			if verbose {
-				fmt.Fprintf(os.Stderr, "Warning: failed to update %s: %v\n", filename, err)
-			}
+	if err := updateAgentFile(agentFile, verbose); err != nil {
+		// Non-fatal - continue with other files
+		if verbose {
+			fmt.Fprintf(os.Stderr, "Warning: failed to update %s: %v\n", agentFile, err)
 		}
 	}
 }