Add agent instructions and fix-issue command

.claude/commands/fix-issue.md

@@ -0,0 +1,20 @@
+# Fix GitHub Issue
+
+Fix the GitHub issue: $ARGUMENTS
+
+## Steps
+
+1. Fetch issue details: `pixi run gh issue view $ARGUMENTS`
+2. Extract the issue number from the URL for commit messages
+3. Understand the problem and locate relevant code
+4. Implement the fix
+5. Run `pixi run ci` to verify (format, lint, test, coverage)
+6. Commit with message referencing the issue (e.g., `Fixes #123`)
+7. Create PR: `pixi run gh pr create`
+
+## Notes
+
+- Input can be a GitHub URL (e.g., `https://github.com/owner/repo/issues/123`) or issue number
+- Keep changes minimal and focused on the issue
+- Add tests if fixing a bug
+- Run full CI before committing

AGENTS.md

@@ -0,0 +1,17 @@
+# Agent Instructions
+
+## Development Environment
+
+This project uses a devcontainer with pixi for environment management.
+
+### Available Tools
+
+- **GitHub CLI (`gh`)**: Available via `pixi run gh` or directly if using a login shell. The container mounts the host's `~/.config/gh` directory, so if the user is authenticated on the host, authentication is shared automatically.
+
+### Running Commands
+
+When using pixi tasks, prefer `pixi run <task>`. See `pixi task list` for available tasks.
+
+For tools installed as dependencies (like `gh`), you can run them via:
+- `pixi run gh <args>` - works in any shell
+- `gh <args>` - works in login shells (`bash -l -c '...'`)

CLAUDE.md

@@ -0,0 +1 @@
+AGENTS.md