elastic / elastic/ai-github-actions

[information-architecture] Quick setup --continuous-improvement selector installs undocumented workflows

Open
#1,021 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

## Information Architecture Findings

### 1. `--continuous-improvement` installs workflows that are not part of its documented set
**Area:** Consistency
**Component(s):** `README.md` (lines 25-27, 39), `docs/workflows/gh-agent-workflows.md` (lines 28-30), `scripts/quick-setup.sh` (lines 128-141, 162-165)
**Problem:** The docs describe `--continuous-improvement` as a specific set of 11 add-on workflows, but the quick-setup selector actually appends 13 workflows by also adding `product-manager-impersonator` and `refactor-opportunist`. Users choosing this option from docs-guided setup get behavior that does not match the visible selection model, which makes workflow selection harder to reason about.
**Suggested improvement:** Align the selector definition across docs and installer behavior by either (a) documenting the full installed set everywhere `--continuous-improvement` is described, or (b) removing undocumented workflows from the appended list. Keep one canonical list and reference it from both docs pages.

## Suggested Actions
- [ ] Decide the intended `--continuous-improvement` workflow set (11 vs 13 entries)
- [ ] Update `scripts/quick-setup.sh` or docs so both reflect the same set
- [ ] Add a guard check (docs/script parity) to prevent selector drift

---
[What is this?](https://ela.st/github-ai-tools) | [From workflow: Trigger Information Architecture](https://github.com/elastic/ai-github-actions/actions/runs/24902712336)

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.