From 6479394de23248acf518903e7030237cb63ff248 Mon Sep 17 00:00:00 2001
From: Wilson Freitas <wilson.freitas@gmail.com>
Date: Wed, 22 Apr 2026 06:36:05 -0300
Subject: [PATCH] Add AGENTS.md with developer instructions

---
 AGENTS.md | 43 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)
 create mode 100644 AGENTS.md

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..05ac23d
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,43 @@
+# AGENTS.md
+
+## Commands
+
+```bash
+# Install deps (requires Python 3.11+)
+uv sync --no-install-project
+
+# Run parser (requires GitHub token)
+GITHUB_ACCESS_TOKEN=<token> uv run python parse.py
+
+# Generate static site
+uv run python site/generate.py
+```
+
+## GitHub MCP Tools
+
+This repo uses GitHub MCP tools for PR operations (not `gh` CLI). Key tools:
+- `github_list_pull_requests` - list open PRs
+- `github_get_pull_request` - get PR details
+- `github_get_pull_request_files` - get files changed
+- `github_merge_pull_request` - merge PRs
+- `github_add_issue_comment` - comment on PRs
+- `github_update_issue` - close/update issues and PRs
+- `github_get_file_contents` - fetch README.md from repo
+
+## Entry Format
+
+The critical regex: `^\s*- \[(.*)\]\((.*)\) - (.*)$`
+
+- Must include backtick language tags (e.g., `` `Python` ``)
+- Description must end with period
+- Commercial sites in "Commercial & Proprietary Services" section
+- Language tag optional for commercial sites
+
+See CLAUDE.md and CONTRIBUTING.md for full details.
+
+## PR Review Workflow
+
+1. Always ask user before merging
+2. Check section placement (not Market Data if commercial)
+3. Check for duplicates in README
+4. Use "reviewed" label after commenting