From 80734e3b53034a763826d18beaaf630631e5aebd Mon Sep 17 00:00:00 2001
From: Phillip Cloud <417981+cpcloud@users.noreply.github.com>
Date: Tue, 17 Mar 2026 13:03:44 -0400
Subject: [PATCH 1/2] Document pixi-first agent guidance

Prefer pixi-managed tasks over raw Python and pytest commands when available so agents run inside the repository's configured environment.

Made-with: Cursor
---
 AGENTS.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index 525d300801..ee805a8101 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -23,6 +23,9 @@ guide for package-specific conventions and workflows.
   (search), `read_file`, `list_dir`, `glob_file_search`, `apply_patch`,
   `todo_write/update_plan`. Use `cmd`/`run_terminal_cmd` only when no listed
   tool can perform the action.
+- If `pixi` is available for this repo, prefer `pixi run ...` or the matching
+  `pixi` task over invoking raw `python`, `pytest`, `pip`, or similar tools
+  directly so commands run in the repository-managed environment.
 - When multiple tool calls can be parallelized (e.g., todo updates with other
   actions, file searches, reading files), make these tool calls in parallel
   instead of sequential. Avoid single calls that might not yield a useful

From 1e124f20ff0844ed517693cc38b76dc93b635f71 Mon Sep 17 00:00:00 2001
From: Phillip Cloud <417981+cpcloud@users.noreply.github.com>
Date: Tue, 17 Mar 2026 13:06:04 -0400
Subject: [PATCH 2/2] Clarify jq-first JSON processing guidance

Prefer jq-based JSON filtering over one-off Python parsing, and steer gh JSON queries toward the built-in --jq flag.

Made-with: Cursor
---
 AGENTS.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index ee805a8101..dd62ad5a95 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -26,6 +26,9 @@ guide for package-specific conventions and workflows.
 - If `pixi` is available for this repo, prefer `pixi run ...` or the matching
   `pixi` task over invoking raw `python`, `pytest`, `pip`, or similar tools
   directly so commands run in the repository-managed environment.
+- When extracting or transforming JSON in shell workflows, prefer `jq` over
+  one-off Python parsing. For `gh` commands that return JSON, prefer the
+  built-in `--jq` flag instead of piping the output into `python`.
 - When multiple tool calls can be parallelized (e.g., todo updates with other
   actions, file searches, reading files), make these tool calls in parallel
   instead of sequential. Avoid single calls that might not yield a useful