From e57dbfef9e6ac17d197062ea2969328244ab7d19 Mon Sep 17 00:00:00 2001
From: David Karlsson <35727626+dvdksn@users.noreply.github.com>
Date: Tue, 20 Oct 2026 08:10:52 +0000
Subject: [PATCH] docs: explain host Git ignore snapshots

Git workflows did not explain how host ignore decisions reach local sandboxes. Document the creation-time snapshot and its limits without implying that ignored files are inaccessible.
---
 content/manuals/ai/sandboxes/workflows/git.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/content/manuals/ai/sandboxes/workflows/git.md b/content/manuals/ai/sandboxes/workflows/git.md
index 3586dabca7..47289832b1 100644
--- a/content/manuals/ai/sandboxes/workflows/git.md
+++ b/content/manuals/ai/sandboxes/workflows/git.md
@@ -187,6 +187,20 @@ yourself after reviewing the changes.
    $ gh pr create
    ```
 
+## Git ignore rules
+
+Git inside a local sandbox preserves host-specific ignore decisions for paths
+that exist when you create the sandbox. This applies when the primary workspace
+is at a Git repository root.
+
+The sandbox receives a snapshot of ignored paths, not the host-specific patterns.
+Those patterns don't apply to files created later, but ignored directories still
+cover files added inside them. Additional repositories and primary workspaces
+below a repository root don't receive this snapshot. Repository `.gitignore`
+files continue to work as usual.
+
+Git ignore rules don't restrict the agent's access to files in the workspace.
+
 ## Commit signing
 
 SSH agent forwarding is enabled by default. When `SSH_AUTH_SOCK` is set,