quality-debt: AGENTS.md — PR #2048 review feedback (high)

[marcusquinn]

Unactioned Review Feedback

Source PR: #2048
File: AGENTS.md
Reviewers: coderabbit
Findings: 1
Max severity: high

---

HIGH: coderabbit (coderabbitai[bot])

File: AGENTS.md:8
⚠️ Potential issue | 🟡 Minor

Minor path inconsistency: version-manager.sh is missing its .agents/scripts/ prefix.

Line 8 references version-manager.sh release [major|minor|patch] without a path, while line 69 (the Quality Workflow block) consistently uses the full .agents/scripts/version-manager.sh. A bare filename in the Quick Reference could mislead a contributor into running it from the wrong directory.

📝 Proposed fix

-- **Commands**: `./setup.sh` (deploy) | `.agents/scripts/linters-local.sh` (quality) | `version-manager.sh release [major|minor|patch]`
+- **Commands**: `./setup.sh` (deploy) | `.agents/scripts/linters-local.sh` (quality) | `.agents/scripts/version-manager.sh release [major|minor|patch]`

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

- **Commands**: `./setup.sh` (deploy) | `.agents/scripts/linters-local.sh` (quality) | `.agents/scripts/version-manager.sh release [major|minor|patch]`

🤖 Prompt for AI Agents

Verify each finding against the current code and only fix it if needed.

In `@AGENTS.md` at line 8, Update the Quick Reference entry that currently lists
"version-manager.sh release [major|minor|patch]" to use the full script path
".agents/scripts/version-manager.sh release [major|minor|patch]" so it matches
the Quality Workflow usage; locate the occurrence of the literal
"version-manager.sh release [major|minor|patch]" in AGENTS.md and replace it
with ".agents/scripts/version-manager.sh release [major|minor|patch]".

View comment

---

Auto-generated by quality-feedback-helper.sh scan-merged. Review each finding and either fix the code or dismiss with a reason.

[johnwaldo]

Triaged: Review feedback on documentation/markdown file. These are typically style, completeness, or accuracy suggestions for reference docs. Recommend addressing in a dedicated documentation improvement PR if the suggestions are still relevant to current code.

[johnwaldo]

Recommend closing — AGENTS.md path inconsistency for version-manager.sh is cosmetic. The Quick Reference section uses short names for brevity; the Quality Workflow section uses full paths for copy-paste accuracy. Both conventions are valid in their context.

[alex-solovyev]

Dispatching worker.

• Model: sonnet (anthropic/claude-sonnet-4-6)
• Branch: bugfix/quality-debt-3261-agents-md
• Scope: Fix high-priority quality-debt review feedback for AGENTS.md from PR t1283: Context optimisation pass 3 — tighten language across always-loaded files #2048
• Attempt: 1 of 1
• Direction: Address all findings from PR t1283: Context optimisation pass 3 — tighten language across always-loaded files #2048 review; max severity high

[github-actions]

Completed via PR #4623. Task t3261 merged to main.