elastic / elastic/ai-github-actions

[information-architecture] Product Manager Impersonator appears in conflicting workflow categories across docs

Open
#719 1 comment 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. Product Manager Impersonator is grouped inconsistently across the main workflow information architecture
**Area:** Consistency / Grouping and hierarchy
**Component(s):** `gh-agent-workflows/README.md`, `docs/workflows/gh-agent-workflows.md`, `mkdocs.yml`, `docs/index.md`

**Problem:**
The same workflow is categorized in different sections depending on entry point:
- In `gh-agent-workflows/README.md` it is listed under **Detectors** (`gh-agent-workflows/README.md:25-33`).
- In `docs/workflows/gh-agent-workflows.md` it is listed under **Standalone scheduled workflows** (`docs/workflows/gh-agent-workflows.md:85-98`).
- In docs navigation (`mkdocs.yml:59-66`) it is placed under **Planning & Insights**.
- The homepage frames it as an ideation workflow in **Idea Machines** (`docs/index.md:144-149`).

These competing groupings create conflicting mental models about what the workflow is for and where to find related workflows.

**Suggested improvement:**
Standardize Product Manager Impersonator under one taxonomy (for example, planning/insights) across all workflow catalogs and navigation surfaces, then align section headers and table groupings to that taxonomy.

## Suggested Actions
- [ ] Choose one canonical category for Product Manager Impersonator (e.g., Planning & Insights).
- [ ] Update `gh-agent-workflows/README.md` section membership to match the canonical category.
- [ ] Update `docs/workflows/gh-agent-workflows.md` grouping to match the same category.
- [ ] Verify homepage (`docs/index.md`) and docs nav (`mkdocs.yml`) use the same grouping language.

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

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.