Skip to content

Add issue triage workflow (thin trigger for docs-actions)#5635

Merged
theletterf merged 4 commits into
mainfrom
fabri/gh-aw-issue-triage
Apr 8, 2026
Merged

Add issue triage workflow (thin trigger for docs-actions)#5635
theletterf merged 4 commits into
mainfrom
fabri/gh-aw-issue-triage

Conversation

@theletterf

@theletterf theletterf commented Mar 26, 2026

Copy link
Copy Markdown
Member

Summary

  • Adds a thin trigger workflow that calls the centralized issue-triage agentic workflow from elastic/docs-actions
  • Triggered by typing /triage on an issue comment (write access required) or via manual workflow_dispatch for batch processing
  • The workflow analyzes issue content (title, body, URLs, labels), uses the Elastic Docs MCP server to look up referenced documentation pages, and applies the correct Team:* label
  • Team ownership mapping is passed via additional-instructions — the core triage logic lives in docs-actions

How it works

  1. Someone comments /triage on an issue (or dispatches manually for batch mode)
  2. The centralized workflow in docs-actions fetches issue data and CODEOWNERS
  3. The AI agent reads the issue, uses the Elastic Docs MCP server to gather context
  4. For docs outside docs-content, it fetches the relevant repo's CODEOWNERS via gh api
  5. It applies the best-fit team label via safe-output (add-labels)

Dependencies

  • Requires elastic/docs-actions#57 to be merged and a new release published (so the v1 tag includes the lock file)
  • Requires COPILOT_GITHUB_TOKEN secret configured in this repo

Labels an issue can receive

Team:Admin, Team:Developer, Team:DocsEng, Team:Experience, Team:Ingest, Team:Projects, cross-team

🤖 Generated with Claude Code

Add a GitHub Agentic Workflow that triages docs-content issues by
analyzing their content and applying the correct team label. The
workflow is triggered by typing `/triage` on an issue comment (write
access required) or via manual workflow_dispatch for batch processing.

Features:
- Uses Elastic Docs MCP server to look up referenced pages
- Derives team ownership from CODEOWNERS
- Can fetch CODEOWNERS from other repos for cross-repo issues
- Supports batch triage of all open needs-team issues

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@theletterf theletterf requested review from a team as code owners March 26, 2026 09:59
@theletterf theletterf requested a review from cotti March 26, 2026 09:59
@github-actions

github-actions Bot commented Mar 26, 2026

Copy link
Copy Markdown
Contributor

🔍 Preview links for changed docs

@florent-leborgne florent-leborgne left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, some nits on the paths for my team and the dev-docs team

Comment thread .github/workflows/issue-triage.md Outdated
Comment thread .github/workflows/issue-triage.md Outdated
Co-authored-by: florent-leborgne <florent.leborgne@elastic.co>
@theletterf

Copy link
Copy Markdown
Member Author

@shainaraskas @szabosteve Could you review as well? Thanks!

Replace standalone gh-aw workflow (source .md + compiled .lock.yml)
with a thin trigger that calls the centralized issue-triage workflow
from elastic/docs-actions. Team mapping is passed via
additional-instructions.

Depends on elastic/docs-actions#57 being merged and released.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@theletterf theletterf changed the title Add gh-aw issue triage workflow Add issue triage workflow (thin trigger for docs-actions) Apr 2, 2026

@shainaraskas shainaraskas left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nice! likely good enough for 90% (sorry reviewing this took me so long)

couple comments on keywords + also the fallback behavior

Comment thread .github/workflows/issue-triage.yml Outdated
Comment thread .github/workflows/issue-triage.yml Outdated
Comment thread .github/workflows/issue-triage.yml Outdated
@shainaraskas

Copy link
Copy Markdown
Member

for longevity, could this be made to reference the ownership mappings in codeowners?

Address feedback from florent-leborgne and shainaraskas:
- Fix Team:Experience paths (reference/kibana/, reference/observability/)
- Fix Team:Developer paths (reference/machine-learning/, cross-project-search)
- Replace broad "security" in Team:Admin with specific terms
- Add "subscriptions" to Team:Admin, bare "security" to Team:Experience
- Change fallback from Team:Projects to cross-team

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@theletterf theletterf merged commit 60c4ae4 into main Apr 8, 2026
7 checks passed
@theletterf theletterf deleted the fabri/gh-aw-issue-triage branch April 8, 2026 08:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants