You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Update Claude prompts to have best practices from our gh-aw workflows #132
TL;DR: Align the Claude composite-action prompts with the gh-aw best-practice fragments (formatting, rigor, workflow-edit guardrails, MCP pagination, footer handling) and apply them consistently across the claude-workflows/*/action.yml prompt blocks.
Recommendation: Port the gh-aw prompt guidance from .github/workflows/gh-aw-fragments/ into each Claude prompt block, ideally as a shared snippet (or consistent copy/paste), and reconcile footer guidance so the prompts don’t instruct conflicting footer behavior.
Findings
gh-aw best-practice fragments live in .github/workflows/gh-aw-fragments/: formatting guidance (formatting.md:1-6), rigor rules (rigor.md:1-10), workflow edit guardrails (workflow-edit-guardrails.md:1-4), MCP pagination (mcp-pagination.md:1-32), and footer handling (messages-footer.md:1-9).
Claude prompts are embedded directly in each action’s prompt: | block, e.g. claude-workflows/mention-in-issue/rwx/action.yml:81-166, claude-workflows/mention-in-pr/rwxp/action.yml:101-308, claude-workflows/issue-triage/ro/action.yml:81-209, claude-workflows/pr-review/ro/action.yml:110-236, claude-workflows/build-failure-github-actions/rwx/action.yml:73-196, claude-workflows/build-failure-buildkite/rwx/action.yml:134-265, claude-workflows/generate-report/ro/action.yml:109-167, and claude-workflows/project-manager/ro/action.yml:83-160.
Some prompts already mention auto-append footers but also instruct a manual footer (e.g., claude-workflows/mention-in-pr/rwxp/action.yml:229 vs :287-296), which conflicts with the gh-aw footer fragment’s “no manual footer” guidance (messages-footer.md:1-9).
Verification
Not run (no tests/commands are necessary to assess prompt text alignment).
Detailed Action Plan
Define a reusable prompt block that mirrors the gh-aw fragments: formatting (formatting.md:1-6), rigor (rigor.md:1-10), workflow edit guardrails (workflow-edit-guardrails.md:1-4), MCP pagination (mcp-pagination.md:1-32), and footer guidance (messages-footer.md:1-9).
Insert that block into each Claude prompt’s prompt: | section (after (constraints) or before (additional_instructions)), covering:
Reconcile footer behavior: if the workflow or scripts append a footer automatically (e.g., claude-workflows/pr-review/rwx/action.yml:232-235), remove or soften any manual response_footer blocks to avoid duplicates; otherwise keep the manual footer but add the “don’t add extra sign-offs” guidance from messages-footer.md:7-9.
Run make lint-actions (or make lint) to validate updated action.yml files.
Applied the gh-aw formatting, rigor, workflow-edit guardrails, and MCP pagination guidance across all Claude composite-action prompt blocks (12 action.yml files), leaving footer behavior unchanged as requested. Tests: make lint. PR creation has been requested via the workflow and should appear shortly with these changes.
This issue was labeled stale on 2026-08-10 and has had no further activity for 30 days. Closing automatically. If this issue is still relevant, please reopen it.
Activity
github-actions commentedon Feb 19, 2026
TL;DR: Align the Claude composite-action prompts with the gh-aw best-practice fragments (formatting, rigor, workflow-edit guardrails, MCP pagination, footer handling) and apply them consistently across the
claude-workflows/*/action.ymlprompt blocks.Recommendation: Port the gh-aw prompt guidance from
.github/workflows/gh-aw-fragments/into each Claude prompt block, ideally as a shared snippet (or consistent copy/paste), and reconcile footer guidance so the prompts don’t instruct conflicting footer behavior.Findings
.github/workflows/gh-aw-fragments/: formatting guidance (formatting.md:1-6), rigor rules (rigor.md:1-10), workflow edit guardrails (workflow-edit-guardrails.md:1-4), MCP pagination (mcp-pagination.md:1-32), and footer handling (messages-footer.md:1-9).prompt: |block, e.g.claude-workflows/mention-in-issue/rwx/action.yml:81-166,claude-workflows/mention-in-pr/rwxp/action.yml:101-308,claude-workflows/issue-triage/ro/action.yml:81-209,claude-workflows/pr-review/ro/action.yml:110-236,claude-workflows/build-failure-github-actions/rwx/action.yml:73-196,claude-workflows/build-failure-buildkite/rwx/action.yml:134-265,claude-workflows/generate-report/ro/action.yml:109-167, andclaude-workflows/project-manager/ro/action.yml:83-160.claude-workflows/mention-in-pr/rwxp/action.yml:229vs:287-296), which conflicts with the gh-aw footer fragment’s “no manual footer” guidance (messages-footer.md:1-9).Verification
Not run (no tests/commands are necessary to assess prompt text alignment).
Detailed Action Plan
formatting.md:1-6), rigor (rigor.md:1-10), workflow edit guardrails (workflow-edit-guardrails.md:1-4), MCP pagination (mcp-pagination.md:1-32), and footer guidance (messages-footer.md:1-9).prompt: |section (after(constraints)or before(additional_instructions)), covering:claude-workflows/mention-in-issue/rwx/action.yml:81-166claude-workflows/mention-in-issue/rwxp/action.yml:80-167claude-workflows/mention-in-pr/rwx/action.yml:101-295claude-workflows/mention-in-pr/rwxp/action.yml:101-308claude-workflows/issue-triage/ro/action.yml:81-209claude-workflows/issue-triage/rwx/action.yml:80-240claude-workflows/pr-review/ro/action.yml:110-236claude-workflows/pr-review/rwx/action.yml:110-236claude-workflows/build-failure-github-actions/rwx/action.yml:73-196claude-workflows/build-failure-buildkite/rwx/action.yml:134-265claude-workflows/generate-report/ro/action.yml:109-167claude-workflows/project-manager/ro/action.yml:83-160claude-workflows/pr-review/rwx/action.yml:232-235), remove or soften any manualresponse_footerblocks to avoid duplicates; otherwise keep the manual footer but add the “don’t add extra sign-offs” guidance frommessages-footer.md:7-9.make lint-actions(ormake lint) to validate updated action.yml files.Related Items
workflow-edit-guardrailsfragment used in gh-aw prompts..github/workflows/gh-aw-fragments/formatting.md:1-6.github/workflows/gh-aw-fragments/rigor.md:1-10.github/workflows/gh-aw-fragments/workflow-edit-guardrails.md:1-4.github/workflows/gh-aw-fragments/mcp-pagination.md:1-32.github/workflows/gh-aw-fragments/messages-footer.md:1-9What is this? | From workflow: Issue Triage Agent
Give us feedback! React with 🚀 if perfect, 👍 if helpful, 👎 if not. for issue #132
strawgate commentedon Feb 19, 2026
/ai make it happen, don't worry about the footers and focus on really improving the prompts
github-actions commentedon Feb 19, 2026
Applied the gh-aw formatting, rigor, workflow-edit guardrails, and MCP pagination guidance across all Claude composite-action prompt blocks (12 action.yml files), leaving footer behavior unchanged as requested. Tests:
make lint. PR creation has been requested via the workflow and should appear shortly with these changes.What is this? | From workflow: Issue Assistant
Give us feedback! React with 🚀 if perfect, 👍 if helpful, 👎 if not. for issue #132
github-actions commentedon Aug 26, 2026
This issue was labeled
staleon 2026-08-10 and has had no further activity for 30 days. Closing automatically. If this issue is still relevant, please reopen it.What is this? | From workflow: Trigger Stale Issues Remediator
Give us feedback! React with 🚀 if perfect, 👍 if helpful, 👎 if not.