2 files changed, 40 insertions, 1 deletions

diff --git a/docs/learnings/grasp-01-implementation.md b/docs/learnings/grasp-01-implementation.md
index 14ab452..27124af 100644
--- a/docs/learnings/grasp-01-implementation.md
+++ b/docs/learnings/grasp-01-implementation.md
@@ -42,7 +42,8 @@
 - ✅ Recursive maintainer chain support
 - ✅ HEAD set from state events
 - ✅ `refs/nostr/<event-id>` support for PRs
-- ✅ `allow-tip-sha1-in-want` and `allow-reachable-sha1-in-want`
+- ✅ `allow-tip-sha1-in-want` and `allow-reachable-sha1-in-want` (GRASP-01 requirement)
+- ✅ `uploadpack.allowFilter` for partial clone support (required by git-natural-api)
 
 ---
 
diff --git a/docs/reference/git-protocol.md b/docs/reference/git-protocol.md
index 172a7bc..c0ecb3b 100644
--- a/docs/reference/git-protocol.md
+++ b/docs/reference/git-protocol.md
@@ -4,6 +4,44 @@
 
 This document explains the Git Smart HTTP protocol as it relates to our inline authorization implementation.
 
+## Required Git Capabilities
+
+### GRASP-01 Requirements (MUST)
+
+Per the [GRASP-01 specification](https://github.com/DanConwayDev/grasp/blob/main/01.md), implementations **MUST** advertise and support the following git capabilities:
+
+- **`allow-reachable-sha1-in-want`**: Allows clients to request commits reachable from any ref
+- **`allow-tip-sha1-in-want`**: Allows clients to request specific commit SHAs directly
+- **`uploadpack.allowFilter`**: Enables partial clone/fetch with `--filter` options
+
+These are essential for supporting `refs/nostr/<event-id>` (PR refs) and bandwidth-efficient partial clones.
+
+**Implementation:** `src/git/subprocess.rs:36-42`
+
+### How Capabilities are Advertised
+
+Git capabilities are advertised during the initial `GET /info/refs?service=git-upload-pack` request. The server spawns `git upload-pack --advertise-refs` with configuration flags:
+
+```bash
+git -c uploadpack.allowReachableSHA1InWant=true \
+    -c uploadpack.allowTipSHA1InWant=true \
+    -c uploadpack.allowFilter=true \
+    upload-pack --advertise-refs --stateless-rpc /path/to/repo.git
+```
+
+Clients parse the capability list from the response and only use features the server advertises.
+
+**Verification:** Test with `git ls-remote`:
+
+```bash
+GIT_TRACE_PACKET=1 git ls-remote https://ngit.danconwaydev.com/npub.../repo.git 2>&1 | grep -E "allow-|filter"
+```
+
+Expected output should include:
+```
+pkt-line: ... allow-tip-sha1-in-want allow-reachable-sha1-in-want filter ...
+```
+
 ## Protocol Flow
 
 ### Clone/Fetch (Upload Pack)