Refresh repo agent guidance around live state#3452
Conversation
Remove stale hard-coded release branch, version, and milestone references from the repo guidance files. Make live GitHub state, the current branch, CI, and the user's active goal the source of truth for release and issue work. Keep only durable branch safety, verification, stewardship, provider/model, and release approval guardrails. Verification: - git diff --check
![greptile-apps[bot]](https://avatars.githubusercontent.com/in/867647?s=60&v=4){kind=small}
There was a problem hiding this comment.
Your free trial has ended. If you'd like to continue receiving code reviews, you can add a payment method here.
![gemini-code-assist[bot]](https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
There was a problem hiding this comment.
Code Review
This pull request refactors and simplifies the repository agent guidance in AGENTS.md and CLAUDE.md, removing hardcoded branch names, milestones, and versions in favor of instructions to query the live repository state. The feedback suggests replacing <filter> with [filter] in the cargo test commands to prevent shell redirection errors when copy-pasting.
Important
The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.
| cargo test -p codewhale-tui --bin codewhale-tui --locked <filter> | ||
| cargo test -p codewhale-config --locked <filter> | ||
| cargo test -p codewhale-protocol --locked <filter> |
There was a problem hiding this comment.
Using <filter> in a shell code block can cause shell syntax or redirection errors (e.g., No such file or directory or syntax errors) if an agent or user attempts to run the command directly or copy-pastes it. Replacing the angle brackets with square brackets [filter] avoids this issue while still clearly indicating an optional placeholder.
| cargo test -p codewhale-tui --bin codewhale-tui --locked <filter> | |
| cargo test -p codewhale-config --locked <filter> | |
| cargo test -p codewhale-protocol --locked <filter> | |
| cargo test -p codewhale-tui --bin codewhale-tui --locked [filter] | |
| cargo test -p codewhale-config --locked [filter] | |
| cargo test -p codewhale-protocol --locked [filter] |
Document that opening a draft PR is not the end of an issue workflow. Add explicit readback, CI, ready-for-review, merge-when-authorized, and issue cleanup steps so release agents do not leave verified work piled up in drafts. Also capture the current website direction as sparse, calm, and fact-tied rather than busy marketing copy. Verification: - git diff --check
There was a problem hiding this comment.
Your free trial has ended. If you'd like to continue receiving code reviews, you can add a payment method here.
Strengthen repository guidance so agent work targets a terminal disposition instead of stopping at an open PR. Clarify that draft PRs are temporary, verified branches should be made ready, and merge/issue cleanup is part of authorized release or issue queue work. Keep merge guarded by the current user goal or explicit Hunter approval, while preventing ambiguity from becoming a permanent pile of draft PRs. Verification: - git diff --check
There was a problem hiding this comment.
Your free trial has ended. If you'd like to continue receiving code reviews, you can add a payment method here.
1 participant
Goal
Update the repo guidance files so future agents stop anchoring on stale hard-coded release branches, versions, and milestones, and so issue work does not stop at opening draft PRs.
Changes
AGENTS.mdwith a live-state-first workflow.CLAUDE.mdinto a compact compatibility layer that points agents back toAGENTS.md.Verification
git diff --checkRisks
Issue Link
User-requested guidance/process cleanup; no tracked GitHub issue.