elastic / elastic/ai-github-actions

[product-manager-impersonator] Additive workflow selection for quick setup

Open Beginner friendly
#1,485 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 a `--add-workflows` option to `scripts/quick-setup.sh` so adopters can install the default core workflows plus a few named add-ons without replacing the core set.

## Why a Customer Would Want This
Teams trying AI GitHub Actions often want the recommended five-workflow starter set and one or two extra automations, such as `docs-patrol` or `dependency-review`. Today `--workflows` is documented as an override, so a command like `--workflows docs-patrol` installs only that add-on and silently omits the core review, triage, mention, and CI detective workflows. An additive flag would make the common "core plus one" path obvious and safer.

## Rough Implementation Sketch
- Add a new `--add-workflows CSV` option alongside `--workflows` in `scripts/quick-setup.sh`.
- Parse the CSV after initializing `workflows` from either the defaults or an explicit `--workflows` override, then append each requested workflow with the existing `append_workflow_if_missing` helper.
- Update the quick setup help text and docs to clarify that `--workflows` replaces the default set while `--add-workflows` keeps it.
- Add lightweight shell tests or script-level validation coverage for default-only, override-only, and default-plus-add-on behavior if the repo has an existing quick setup test pattern.

## Why It Won't Be That Hard
The script already has the necessary building blocks: the default workflow array, the override parsing path, and `append_workflow_if_missing` for de-duplicating workflows when `--continuous-improvement` adds extras. This is a small CLI parsing/docs change rather than a compiler or workflow-runtime change.

## Evidence
- `scripts/quick-setup.sh:21`-`27` lists the current quick setup options and has no additive workflow flag.
- `scripts/quick-setup.sh:115`-`121` defines the recommended default core workflows.
- `scripts/quick-setup.sh:138`-`143` shows that providing `--workflows` replaces the default list instead of extending it.
- `scripts/quick-setup.sh:145`-`159` already has `append_workflow_if_missing`, which can be reused for additive selection.
- `gh-agent-workflows/README.md:56`-`65` documents the default workflows and says `--workflows` overrides them.
- `docs/workflows/gh-agent-workflows.md:24`-`27` presents the core set and continuous-improvement add-ons as opinionated bundles, which this flag would make easier to compose.

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

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

Contributor guide

Open the contributing guide

Research direction

Start in scripts/quick-setup.sh, reading the option help, default workflow initialization, override parsing, and append_workflow_if_missing sections cited in the issue. Then review the quick setup documentation in gh-agent-workflows/README.md and docs/workflows/gh-agent-workflows.md. Done means --workflows still replaces defaults, --add-workflows appends without duplicates, and help and docs explain both behaviors; add lightweight coverage if an existing shell-test pattern is found.

Written by the indexing model from the issue text.

Assessment

Tech stack
markdown, shell
Domain
cli, documentation, testing
Issue type
Feature
Difficulty
2/5
Estimated time
1-2 days
Activity status
Quiet
Clarity
Clearly specified
Newbie friendliness
78/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.