Repository navigation
docs(agents): run just through nix develop outside the dev shell - #210
Conversation
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
|
Important Review skippedReview was skipped as selected files did not have any reviewable changes.
|
There was a problem hiding this comment.
✅ No new issues found.
Reviewed changes: a one-line docs addition to AGENTS.md telling agents to run just through nix develop --command outside the dev shell. No behavioral surface.
claude-sonnet-5-5 | 𝕏

Problem
Pullfrog's dispatched run on
main(see moq-dev/quest#779) foundjust checkandjust testfail in its job. The "Put the dev shell's tools on PATH" step in.github/workflows/pullfrog.ymlexports the dev shell'sPATHbut not its variables (PKG_CONFIG_PATH,NIX_LDFLAGS, ...), so builds that link system libraries cannot find them. Run throughnix develop --command, they pass.Approach
One line in
AGENTS.md, beside "Runjust cibefore every push": outside the dev shell, such as in Pullfrog's job, runjustasnix develop --command just ....Impact
Alternatives
PATH, in the workflow step. Rejected: the step comes from the shared Pullfrog workflow standard (dotfiles'repo-settings), not this repo, and handing the agent more of the shell's environment widens what that hardened step sets up;nix develop --commandgives the exact dev shell on demand.nix develop --command quest ...line. Kept separate:questis missing fromPATHentirely outside the dev shell, a different failure, and that line sits with the quest instructions agents read first.Follow-ups
None.
Validation
nix print-dev-env --jsonlistsPKG_CONFIG_PATH,NIX_LDFLAGS,NIX_CFLAGS_COMPILE, andLIBCLANG_PATHamong the shell's variables, so the named examples are real./nix/storePATHentries (as the workflow step builds it) in a clean env,pkg-config --exists libpipewire-0.3exits 1;nix develop --command pkg-config --exists libpipewire-0.3exits 0.Models
Size: XS
Implementer: Claude Code, claude-sonnet-5-5, high effort
(Written by Claude Opus 5.5)
🤖 Generated with Claude Code
Review
Rewritten by
quest reviewafter each round.Head: bc8852f
Base: origin/main at 5ae83b0
Risk: medium,
the base has no RISK.md to name what is always high or customer-facing, so every change is mediumClassified: medium by default
Reviewer: Codex, gpt-6.1-sol, medium effort
Session:
01a1f475-3b5c-7e81-9ceb-5a7c954e96c6, round 1Score: 10/10,
The documentation-only change correctly directs commands through the development shell so library-discovery variables are available, with no actionable defects found.Rounds: 1; first round 0; findings 0: fixed 0, refuted 0, open 0
Findings: none
Reviewer: Codex, gpt-6.1-sol, low effort, shadow
Session:
01a1f475-3b5c-7202-bd20-ab24119e4692, round 1Score: 10/10,
The focused documentation change matches the repository's Nix development environment and introduces no identifiable defect.Rounds: 1; first round 0; findings 0: fixed 0, refuted 0, open 0
Findings: none