elastic / elastic/ai-github-actions

[product-manager-impersonator] 30-second Workflow Chooser

Open
#817 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Python
Stars
11
Forks
16
Avg merge
22h 9m
Merged PRs (30d)
31

Description

## Feature Idea

**Summary:** Add an intent-first “Workflow Chooser” page that helps users pick the right workflow(s) in under a minute and gives copy-paste install snippets.

## Why a Customer Would Want This
New adopters see a large catalog and often don’t know which workflow to start with for a concrete goal (for example: “review PRs,” “debug CI failures,” or “continuous quality checks”). A quick chooser reduces setup friction and improves first-run success.

## Rough Implementation Sketch
- Add `docs/workflows/workflow-chooser.md` with a goal → recommended workflow(s) matrix (including trigger type and required permissions/secrets).
- Include copy-paste install examples for each goal, including `--workflows` examples where relevant.
- Link this page prominently from `README.md`, `docs/index.md`, and `docs/workflows/gh-agent-workflows.md`.
- Add a short “Best for” section to a small set of high-traffic workflow docs (core five + top scheduled detectors) that points back to the chooser.

## Why It Won't Be That Hard
This is primarily a docs/navigation change with existing building blocks already in place: workflow catalog tables, quick-install snippets, and known workflow IDs. It does not require compiler/runtime changes and is a small-surface documentation iteration.

## Evidence
- Large workflow surface area is already emphasized: `docs/index.md:5`, `docs/index.md:118`.
- The canonical workflow catalog is comprehensive but taxonomy-first, not goal-first: `docs/workflows/gh-agent-workflows.md:31-90`.
- Quick setup expects users to know workflow IDs in advance (`--workflows` CSV): `scripts/quick-setup.sh:144-147`, `gh-agent-workflows/README.md:63-65`.
- Prior PM-impersonator reports in `/tmp/previous-findings.json` cover preflight/postflight/validation topics, but not an intent-first chooser.

> [!NOTE]
>
> 🔒 Integrity filtering filtered 54 items
>
> Integrity filtering activated and filtered the following items during workflow execution.
> This happens when a tool call accesses a resource that does not meet the required integrity or secrecy level of the workflow.
>
> - issue:elastic/ai-github-actions#765 (`list_issues`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".)
> - issue:elastic/ai-github-actions#815 (`list_issues`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".)
> - issue:elastic/ai-github-actions#816 (`list_issues`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".)
> - issue:elastic/ai-github-actions#786 (`list_issues`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".)
> - issue:elastic/ai-github-actions#813 (`list_issues`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".)
> - issue:elastic/ai-github-actions#812 (`list_issues`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".)
> - issue:elastic/ai-github-actions#811 (`list_issues`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".)
> - issue:elastic/ai-github-actions#810 (`list_issues`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".)
> - issue:elastic/ai-github-actions#809 (`list_issues`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".)
> - issue:elastic/ai-github-actions#808 (`list_issues`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".)
> - issue:elastic/ai-github-actions#807 (`list_issues`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".)
> - issue:elastic/ai-github-actions#806 (`list_issues`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".)
> - issue:elastic/ai-github-actions#804 (`list_issues`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".)
> - issue:elastic/ai-github-actions#781 (`list_issues`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".)
> - issue:elastic/ai-github-actions#803 (`list_issues`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".)
> - issue:elastic/ai-github-actions#801 (`list_issues`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".)
> - ... and 38 more items
>
>

---
[What is this?](https://ela.st/github-ai-tools) | [From workflow: Trigger Product Manager Impersonator](https://github.com/elastic/ai-github-actions/actions/runs/23641481143)

Give us feedback! React with 🚀 if perfect, 👍 if helpful, 👎 if not.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.