/gaia-create-stakeholder

user-facing
Category:
Creative & Collaboration
Lifecycle phase:
Any
Arguments:
[name]

What it does

/gaia-create-stakeholder creates a new stakeholder persona file for use in Party Mode and meetings. Each stakeholder has a name, role, expertise, personality, and optional perspective/tags. The file is saved to custom/stakeholders/ where Party Mode discovers it.

When to use it

  • You are preparing for a /gaia-party discussion and want a specific domain expert, decision-maker, or end-user voice in the room.
  • You want to capture a recurring persona (e.g., a regulatory officer, a power user, an operations manager) so you can reuse it across multiple Party Mode sessions without re-entering details each time.
  • You are running design discussions and need user archetypes that represent different viewpoints, priorities, or constraints.
  • You want to model a stakeholder who is unavailable for live sessions but whose perspective should influence decisions.

Prerequisites

  • No strict prerequisites. Works best when planning artifacts exist for context.

How to invoke

/gaia-create-stakeholder Maria Santos

What it does step by step

  1. Ensure directory exists Creates custom/stakeholders/ if it does not exist.
  2. Collect inputs Prompts for name, role, expertise, personality (required) and perspective, tags (optional).
  3. Validate Checks the 50-file cap and case-insensitive duplicate name detection.
  4. Write file Generates the stakeholder file with YAML frontmatter and a Background section at custom/stakeholders/{slug}.md.

Inputs

InputSourceDescription
nameCommand argument (optional)The stakeholder's display name. If omitted, the command prompts for it.

Outputs

OutputLocationDescription
Stakeholder filecustom/stakeholders/{slug}.mdMarkdown file with YAML frontmatter (name, role, expertise, personality, optional perspective/tags) and a Background section.

Hard limits

The custom/stakeholders/ directory enforces a 50-file cap and a 100-line per-file limit. The command will refuse to create a new stakeholder if either limit would be exceeded.

Example session

> /gaia-create-stakeholder

Name: Maria Santos
Role: Housekeeper Manager
Expertise: Room turnover logistics
Personality: Pragmatic, detail-oriented
Perspective (optional): Operations-first
Tags (optional): operations, hospitality

Created custom/stakeholders/maria-santos.md

What to run next

  • Create additional stakeholders to assemble a diverse discussion panel, then run /gaia-party to start a multi-agent discussion with them.
  • Use /gaia-meeting for a more structured facilitated session with the new stakeholder.

Troubleshooting

Name not provided

The command prompts for the stakeholder name interactively if no argument is given.

"50-file cap reached"

Delete unused stakeholder files from custom/stakeholders/ before creating a new one.