diff --git a/.gitignore b/.gitignore
index d838f96..53133e2 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,30 +1,53 @@
+# IDE settings
 .vscode/
 .idea/
+
+# Node.js dependencies
 node_modules/
 package-lock.json
+
+# Local code and scratch files
 code_records/
 scratch.js
+
+# Bot generated code
 bots/**/action-code/**
 bots/**/
+
+# API keys (never commit secrets)
 keys.json
+
+# ViaProxy service files
 services/viaproxy/jars/**
 services/viaproxy/logs/**
 services/viaproxy/plugins/**
 services/viaproxy/ViaLoader/**
 services/viaproxy/saves.json
 services/viaproxy/viaproxy.yml
+
+# Temporary and experiment files
 tmp/
 wandb/
 experiments/
+
+# Agent data
 andy_*.json
 jill_*.json
+
+# Model logs
 src/models/logs/*
+
+# Server and result data
 server_data/*
 results/*
+server_data*
+
+# Task files and test/train data
 tasks/construction_tasks/test_multiagent_construction_tasks.json
 tasks/construction_tasks/train_multiagent_construction_tasks.json
 tasks/construction_tasks/test/**
 tasks/construction_tasks/train/**
-server_data*
+
+# System and Python files
 **/.DS_Store
 src/mindcraft-py/__pycache__/