Multiple role guide docs reference rpi as a collection ID for install commands, but rpi is only a Phase 7 bundle alias in the installer agent — not a collection ID. The actual collection ID is hve-core (defined in collections/hve-core.collection.yml). Additionally, the role index is incomplete and the install guide references a nonexistent collection.

Findings

1. rpi used as collection ID in 5 role docs

The installer agent's Phase 7 defines rpi as a bundle alias (line 1127 of .github/agents/installer/hve-core-installer.agent.md). It is not a collection ID. The collection selection sub-flow reads from collections/*.collection.yml using the id field. No rpi.collection.yml exists — the correct collection ID is hve-core.

2. Phantom developer collection in install.md

docs/getting-started/install.md references a Developer collection (extension hve-developer, ID developer) that does not exist. No collections/developer.collection.yml file and no hve-developer extension on the Marketplace.

3. UX Designer missing from role index

docs/hve-guide/roles/ux-designer.md exists with full content but is absent from all sections of docs/hve-guide/roles/README.md (Role Overview table, Find Your Role table, Collaboration Patterns, Coverage Notes).

4. Coverage statistics stale

Coverage Notes calculates "72 role-stage pairs" based on 8 roles × 9 stages. With UX Designer as the 9th role, the correct count is 81.

5. UX Designer collection recommendation gap

UX Designer recommends only design-thinking. The project-planning collection contains a ux-ui-designer agent directly relevant to UX workflows.

Checklist

• Replace rpi with hve-core as collection ID in docs/hve-guide/roles/engineer.md (line 23)
• Replace rpi with hve-core as collection ID in docs/hve-guide/roles/tech-lead.md (line 23)
• Replace rpi with hve-core as collection ID in docs/hve-guide/roles/data-scientist.md (line 23)
• Replace rpi with hve-core as collection ID in docs/hve-guide/roles/sre-operations.md (line 30)
• Replace rpi with hve-core as collection ID in docs/hve-guide/roles/new-contributor.md (lines 26-28)
• Add UX Designer to Role Overview table in docs/hve-guide/roles/README.md
• Add UX Designer to "Find Your Role" table in docs/hve-guide/roles/README.md
• Add UX Designer collaboration pattern in docs/hve-guide/roles/README.md
• Recalculate coverage stats for 9 roles (81 pairs) in docs/hve-guide/roles/README.md
• Remove phantom Developer collection row from docs/getting-started/install.md
• (Optional) Add project-planning as secondary collection for UX Designer in docs/hve-guide/roles/ux-designer.md

Research

Full analysis in .copilot-tracking/research/2026-02-27/role-collection-recommendations-research.md.