diff --git a/CLAUDE.md b/CLAUDE.md
index 88ec76f..69a4704 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -80,3 +80,30 @@ Use the `tea` CLI (Gitea command-line tool) for PR operations instead of `gh`.
 
 **Linking issues**: When a PR solves an issue, reference the issue in both the commit message and PR description using `Closes #<number>`.
 This automatically links and closes the issue when the PR is merged.
+
+### Updating PR Descriptions
+
+Use the `tea` CLI to update pull request descriptions:
+
+```bash
+tea pr edit  -d "New description text"
+```
+
+#### Options
+
+- `-d, --description` - Set description directly
+- `--desc-file` - Read description from a file
+- `-r, --repo` - Specify repo (defaults to current directory)
+
+#### Examples
+
+```bash
+# Update PR #42 with inline text
+tea pr edit 42 -d "Updated implementation based on feedback"
+
+# Update using a file
+tea pr edit 42 --desc-file PR_DESCRIPTION.md
+
+# Update PR in a different repo
+tea pr edit 42 -r username/repo -d "New description"
+```
\ No newline at end of file