Simplify pixi tasks and add agent documentation

- Simplified pixi tasks in pyproject.toml by removing overly complex task chains
- Removed tasks that mix concerns (e.g., ci-push, fix-commit-push)
- Organized tasks into logical groups with comments
- Simplified update-lock to not auto-commit
- Added agents.md with project workflow documentation and available pixi tasks

Author: claude

agents.md

@@ -0,0 +1,62 @@
+# python_template Agent Documentation
+
+## Project Overview
+This project uses **pixi** for environment management. Configuration and tasks are defined in `pyproject.toml`.
+
+## Development Workflow
+
+**Making Changes:**
+- Implement the requested modifications
+- Run `pixi run style` to format and lint the code
+- Run `pixi run test` to verify tests pass
+- Execute `pixi run ci` and iterate until all checks pass
+- Commit only when CI passes
+
+## Available Pixi Tasks
+
+### Formatting and Linting
+- `pixi run format` - Format code using ruff
+- `pixi run ruff-lint` - Lint and auto-fix code issues with ruff
+- `pixi run pylint` - Run pylint checks on all Python files
+- `pixi run lint` - Run both ruff-lint and pylint
+- `pixi run style` - Format and lint code (runs format + lint)
+
+### Testing
+- `pixi run test` - Run pytest tests
+- `pixi run coverage` - Run tests with coverage reporting
+- `pixi run coverage-report` - Display coverage report
+
+### CI Workflow
+- `pixi run ci` - Run complete CI pipeline (style + coverage + coverage-report)
+
+### Pre-commit Hooks
+- `pixi run pre-commit` - Run all pre-commit hooks
+- `pixi run pre-commit-update` - Update pre-commit hook versions
+
+### Utility Tasks
+- `pixi run update-lock` - Update pixi.lock file
+- `pixi run clear-pixi` - Remove .pixi directory and pixi.lock
+- `pixi run setup-git-merge-driver` - Configure git merge driver for lock files
+- `pixi run update-from-template-repo` - Update from the template repository
+
+## Python Environments
+
+The project supports multiple Python versions:
+- `default` - Default environment with latest supported Python
+- `py310` - Python 3.10 environment
+- `py311` - Python 3.11 environment
+- `py312` - Python 3.12 environment
+- `py313` - Python 3.13 environment
+
+To use a specific environment, add `-e <env>` to pixi commands:
+```bash
+pixi run -e py310 test
+```
+
+## Best Practices
+
+1. **Always run CI before committing**: Use `pixi run ci` to ensure all checks pass
+2. **Keep dependencies updated**: Regularly run `pixi run update-lock`
+3. **Use pre-commit hooks**: Set up pre-commit hooks to catch issues early
+4. **Test across Python versions**: Verify compatibility by testing with different environments
+5. **Format before linting**: The `style` task runs format first, then lint

pyproject.toml

@@ -61,32 +61,27 @@ py313 = ["py313", "test"]
 
 
 [tool.pixi.tasks]
-pre-commit = "pre-commit run -a"
-pre-commit-update = "pre-commit autoupdate"
+# Formatting and linting
 format = "ruff format ."
-check-clean-workspace = "git diff --exit-code"
 ruff-lint = "ruff check . --fix"
 pylint = "pylint --version && echo 'running pylint...' && pylint $(git ls-files '*.py')"
 lint = { depends-on = ["ruff-lint", "pylint"] }
 style = { depends-on = ["format", "lint"] }
-commit-format = "git commit -a -m'autoformat code' || true"
+
+# Testing
 test = "pytest"
 coverage = "coverage run -m pytest && coverage xml -o coverage.xml"
 coverage-report = "coverage report -m"
-update-lock = "pixi update && git commit -a -m'update pixi.lock' || true"
-push = "git push"
-update-lock-push = { depends-on = ["update-lock", "push"] }
-fix = { depends-on = ["update-lock", "format", "ruff-lint", "pre-commit"] }
-fix-commit-push = { depends-on = ["fix", "commit-format", "update-lock-push"] }
-ci-no-cover = { depends-on = ["style", "test"] }
-ci = { depends-on = [
-  "format",
-  "ruff-lint",
-  "pylint",
-  "coverage",
-  "coverage-report",
-] }
-ci-push = { depends-on = ["format", "ruff-lint", "update-lock", "ci", "push"] }
+
+# CI workflow
+ci = { depends-on = ["style", "coverage", "coverage-report"] }
+
+# Pre-commit hooks
+pre-commit = "pre-commit run -a"
+pre-commit-update = "pre-commit autoupdate"
+
+# Utility tasks
+update-lock = "pixi update"
 clear-pixi = "rm -rf .pixi pixi.lock"
 setup-git-merge-driver = "git config merge.ourslock.driver true"
 update-from-template-repo = "./scripts/update_from_template.sh"