alias-creator

Alias Theme Creator

Create, edit, preview, and manage agent alias themes for the delivery team pipeline.

What Are Alias Themes?

Alias themes give each delivery team role a themed character name and personality. When a theme is active, every sub-agent speaks in character — Gandalf gives wise product advice, Gimli builds code with directness, Legolas catches bugs with elven precision.

Built-in themes are in delivery-flow/references/aliases/. Custom themes are stored per-repo in .delivery/aliases/.

---

Creating a Custom Theme

Interactive Creation

Walk the user through creating a theme step by step:

1. Theme identity: Ask for theme name (kebab-case), display name, and personality strength (light/moderate/full)
2. For each of the 13 roles, ask:
   • Character name
   • Personality description (1-2 sentences)
   • Catchphrase (or "none")
   • Communication style (free text)
   • 2 example voice lines (how this character talks about delivery work)
3. Validate: All 13 roles mapped, all required fields present
4. Write: Save to .delivery/aliases/<theme-name>.yml

Quick Creation from Description

If the user provides a theme concept (e.g., "Harry Potter theme"), generate all 13 role mappings automatically:

1. Map each role to the best-fitting character based on traits
2. Write personality notes that match the character's known behavior
3. Generate catchphrases adapted from source material
4. Present the full mapping for user review before saving
5. User can edit individual roles before finalizing

Partial Themes

Themes don't need all 13 roles. Unmapped roles fall back to the Business theme. Mark partial themes:

theme: my-partial-theme
display_name: "My Partial Theme"
personality_strength: moderate
min_roles_version: 13
partial: true  # indicates not all roles are mapped

---

The 13 Delivery Team Roles

Every theme maps these roles:

Role ID	Role Name	What They Do
product-owner	Product Owner	Business value, user stories, PRDs, backlogs
scrum-master	Scrum Bag	Process facilitation, retros, velocity, ceremonies
data-analyst	Data Analyst	Metrics, analytics, A/B testing, dashboards
developer	Developer	Code implementation across 14 languages
architect	Architect	System design, ADRs, decomposition, C4 models
qa-engineer	QA Engineer	Test strategy, test cases, quality metrics
devops	DevOps Engineer	CI/CD, deployment, infrastructure, monitoring
release-manager	Release Manager	Release planning, versioning, rollback, feature flags
tech-writer	Technical Writer	API docs, user guides, runbooks, release notes
ux-designer	UX Designer	User flows, wireframes, usability, research
ui-designer	UI Designer	Design systems, components, accessibility, interactions
game-ui-designer	Game UI Designer	HUD, menus, inventory UI, game accessibility
user-feedback	User Feedback	Feedback facilitator (personas keep their own identities)