docs/manual/08-components-reference/01-c1-command-shadows.md

@@ -24,7 +24,7 @@ all of these commands.
     grep/fgrep/egrep   forced --color=auto                    system grep variants
     dir / vdir         forced --color=auto                    system dir / vdir
     help config        intercepts "help config" → config-help  fish builtin help
-    claude             auto-links AGENTS.md as CLAUDE.md before launch  command claude
+    claude             ensures AGENTS/ is scaffolded before launch      command claude
     edit               multi-editor launcher (GUI/term + fallbacks)  $EDITOR/nvim/nano/vi
 
 When C1 is disabled, `rm` uses bare `command rm` with no wrapper — files
@@ -64,7 +64,7 @@ and the `help config` interception.
 
 ## dev-tools
 
-`claude` (AGENTS.md/CLAUDE.md auto-linking) and `edit` (multi-editor
+`claude` (AGENTS/ scaffolding) and `edit` (multi-editor
 launcher), plus `agy`.
 
 ## For function authors

functions/agy.fish

@@ -17,8 +17,8 @@
 #   Wrapper for the agy Antigravity AI CLI that ensures the AGENTS/
 #   sub-repository is initialized and any agent-made changes are committed
 #   before launch. Delegates all scaffold and commit logic to agents-init
-#   --quiet (full setup), which ensures AGENTS/ is scaffolded and CLAUDE.md
-#   is symlinked to AGENTS/AGENTS.md in the current project.
+#   --quiet (full setup), which ensures AGENTS.md (root and every scoped
+#   subdirectory) is symlinked into AGENTS/ in the current project.
 #
 #   Also syncs the host-scoped agent memory vault (agents-vault). agy has
 #   no session-end hook, so its memory is captured on the next launch

functions/claude.fish

@@ -20,8 +20,9 @@
 #   Wrapper for the claude CLI that ensures the AGENTS/ sub-repository is
 #   initialized and any agent-made changes are committed before launch.
 #   Delegates all scaffold and commit logic to agents-init --quiet (full
-#   setup), which ensures AGENTS/ is scaffolded and CLAUDE.md is symlinked
-#   to AGENTS/AGENTS.md in the current project.
+#   setup), which ensures AGENTS.md (root and every scoped subdirectory)
+#   is symlinked into AGENTS/ in the current project. claude-code reads
+#   AGENTS.md natively, so no CLAUDE.md is created or maintained.
 #
 #   Also syncs the host-scoped agent memory vault (agents-vault), which
 #   tracks curated memory living outside the project tree. The vault
@@ -44,7 +45,7 @@
 #   claude
 #   claude --resume
 #   claude "Explain the recent changes"
-function claude --wraps=claude --description 'claude wrapper: auto-links AGENTS.md as CLAUDE.md'
+function claude --wraps=claude --description 'claude wrapper: ensures AGENTS/ is scaffolded before launch'
     if not __fish_config_op_enabled (status current-function)
         command claude $argv
         return $status