improve: update CI workflow and add AGENTS.md

- Update CI workflow: change branch from master to main, add Python 3.10 to matrix, use pinned action versions
- Add AGENTS.md with project guidelines for AI agents

Author: Coding-Dev-Tools

.github/workflows/ci.yml

@@ -2,10 +2,10 @@ name: CI
 
 on:
   push:
-    branches: [master]
+    branches: [main]
     tags: ["v*"]
   pull_request:
-    branches: [master]
+    branches: [main]
 
 permissions:
   contents: read
@@ -15,7 +15,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ["3.11", "3.12", "3.13"]
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
 
     steps:
       - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5
@@ -44,6 +44,7 @@ jobs:
     runs-on: ubuntu-latest
     permissions:
       id-token: write
+      contents: read
 
     steps:
       - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5
@@ -62,4 +63,4 @@ jobs:
         run: python -m build
 
       - name: Publish to PyPI
-        uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b
+        uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b

AGENTS.md

@@ -0,0 +1,35 @@
+# Agent Instructions for deadcode
+
+## Project Overview
+CLI tool to detect and auto-remove unused exports, dead routes, orphaned CSS in TS/React/Next.js projects.
+
+## Build & Test Commands
+- **Install dev dependencies**: `pip install -e ".[dev]"`
+- **Run tests**: `python -m pytest tests/ -x -q`
+- **Lint**: `ruff check .`
+- **Build**: `python -m build`
+
+## Code Style
+- Python 3.10+ target
+- Line length: 120 chars (ruff config)
+- Import sorting: isort with known-first-party = ["deadcode"]
+- Lint rules: E, F, W, I, UP, B, SIM (ignore E501)
+
+## Key Files
+- `src/deadcode/cli.py` - Main CLI entry point
+- `src/deadcode/scanner.py` - Core scanning logic
+- `src/deadcode/config.py` - Configuration handling
+- `tests/` - Test suite (3 test files)
+- `pyproject.toml` - Project configuration
+
+## CI/CD
+- GitHub Actions workflow in `.github/workflows/ci.yml`
+- Tests run on Python 3.10, 3.11, 3.12, 3.13
+- Lint with ruff, test with pytest
+- Publish to PyPI on version tags (v*)
+
+## Contribution Guidelines
+1. Run `ruff check .` before committing
+2. Run `python -m pytest tests/ -x -q` to verify tests pass
+3. Follow conventional commits
+4. Update CHANGELOG.md for notable changes