elastic / elastic/ai-github-actions

[information-architecture] Homepage Stale Issues install flow promises lifecycle management but installs investigator only

Open
#1,060 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. Homepage stale-issues install path is disconnected from the lifecycle it describes
**Area:** Disclosure
**Component(s):** `docs/index.md`, `docs/workflows/gh-agent-workflows/stale-issues.md`
**Problem:** The homepage table describes **Stale Issues** as “Find resolved issues and manage their lifecycle,” but the adjacent “Install these workflows” snippet installs only `stale-issues-investigator`. Users following that path will not get automatic stale-issue remediation/closure, because the remediator workflow is not installed. This creates a misleading onboarding path where the promised lifecycle behavior is not reachable from the primary install action.
**Suggested improvement:** In `docs/index.md`, either (a) update the install snippet to include `stale-issues-remediator` alongside investigator, or (b) explicitly label the snippet as investigator-only and link to the full-loop install path.

**Evidence:**
- `docs/index.md:68-70` describes Stale Issues as lifecycle management.
- `docs/index.md:77-83` installs only `stale-issues-investigator`.
- `docs/workflows/gh-agent-workflows/stale-issues.md:5` defines lifecycle behavior as investigator + remediator.
- `docs/workflows/gh-agent-workflows/stale-issues.md:19-29` shows the full-loop install with both workflows.

## Suggested Actions
- [ ] Align `docs/index.md` stale-issues install snippet with the lifecycle promise by adding remediator to the command block, **or** revise copy to clearly state the snippet is investigator-only.
- [ ] Add a short inline note in the homepage stale-issues row linking to the full-loop setup in `docs/workflows/gh-agent-workflows/stale-issues.md#full-loop-investigator--remediator`.

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

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.