diff --git a/AGENTS.md b/AGENTS.md
index e25b539..fa5692c 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -7,4 +7,24 @@ are followed.
 
 ## Repository Actions
 
-All repository actions (creating issues, pull requests, branches, tags, releases, etc.) should be performed using the gitea-mcp tools available in the MCP server. This ensures consistent, reliable interaction with the Gitea repository management system.
+**Use gitea-mcp tools for all repository interactions.** Do not use `curl`, `git`, or direct API calls.
+
+### When to Use gitea-mcp
+
+- Fetching issues, PRs, branches, tags, releases
+- Reading files, directories, or commits from repo
+- Creating issues, PRs, comments, tags, or releases
+- Editing issues or PRs
+
+### Wrong vs Right
+
+❌ `curl http://git.valid.dk/api/v1/repos/daniel/ansible-bind9-role/issues/6`
+
+✅ `mcp_gitea-mcp_list_repo_issues(owner, repo, page, pageSize)`
+
+### Local Workspace
+
+Terminal commands are fine for:
+- Compiling, testing, building
+- Git operations on local files (commit, push)
+- Using `read_file`, `grep_search`, `semantic_search`