[q] Improve glossary-maintainer: allow any bash command and leverage qmd search

[github-actions]

Requested by @pelikhan in #22644 comment: "allow any bash comment, import qmd-docs.md and leverage the qmd tools for better docs search."

Changes

glossary-maintainer.md

1. Allow any bash command (bash: true)

Previously, the workflow restricted bash to a small hardcoded list:

bash:
  - "find docs -name '*.md'"
  - "grep -r '*' docs"
  - "git log --since='24 hours ago' --oneline"
  - "git log --since='7 days ago' --oneline"

Changed to:

bash: true

This lets the agent freely explore the repository without being blocked by missing bash patterns.

2. shared/mcp/qmd-docs.md was already imported — no change needed there.

3. Better qmd search integration

• Promoted the search tool to the top of the Available Tools section with clear usage guidance
• Added a new "Use QMD search first" step in Scan Recent Changes — the agent now uses search to discover existing docs for each changed feature before deciding if a term needs a glossary entry
• Strengthened the search-first guidance in Review Current Glossary with an additional example (search("qmd documentation search tool"))

Validation

✅ glossary-maintainer.md compiled successfully with no errors or warnings.

---

Warning

🛡️ Protected Files — Push Permission Denied

This was originally intended as a pull request, but the patch modifies protected files: .github/workflows/glossary-maintainer.md.

The push was rejected because GitHub Actions does not have workflows permission to push these changes, and is never allowed to make such changes, or other authorization being used does not have this permission. A human must create the pull request manually.

📋 Create the pull request manually

# Download the patch from the workflow run
gh run download 23486893699 -n agent -D /tmp/agent-23486893699

# Create a new branch
git checkout -b q/glossary-maintainer-bash-qmd-improvements-143531e1521074f1 main

# Apply the patch (--3way handles cross-repo patches)
git am --3way /tmp/agent-23486893699/aw-q-glossary-maintainer-bash-qmd-improvements.patch

# Push the branch and create the pull request
git push origin q/glossary-maintainer-bash-qmd-improvements-143531e1521074f1
gh pr create --title '[q] Improve glossary-maintainer: allow any bash command and leverage qmd search' --base main --head q/glossary-maintainer-bash-qmd-improvements-143531e1521074f1 --repo github/gh-aw

🎩 Equipped by Q · ◷

• expires on Mar 26, 2026, 11:28 AM UTC