role-generator

Role Generator

Overview

The Role Generator takes an approved flow and creates specialist role definitions — not generic agents, but deeply specialized for this specific project and request.

Core principle: A generic "Backend Agent" gives generic advice. A "C# ASP.NET 10 + Entity Framework Core 10 + Azure SQL Backend Specialist" gives advice that's actually useful. Every role is specialized.

When to Use

Invoked by solofounder:flow-composer at two points:

1. After flow approval — generate roles for the CURRENT batch of stages only (not all stages if the flow has EXPAND markers)
2. After flow expansion — when an EXPAND point is reached and new stages are generated, generate roles for those new stages
3. On-demand — during stage execution to generate arbiter roles for conflict resolution

CRITICAL: Only generate roles for stages that exist NOW. If the flow has an EXPAND marker after Stage 2, only generate roles for Stages 1-2. Stages 3+ don't exist yet — their roles will be generated when the flow expands after architecture decisions are made.

The Process

digraph role_generator {
    "Approved flow arrives" [shape=doublecircle];
    "Existing roles in .solofounder/roles/?" [shape=diamond];
    "Load existing roles" [shape=box];
    "Read project context" [shape=box];
    "Read stack/domain learning" [shape=box];
    "Generate role for each specialist" [shape=box];
    "Save to .solofounder/roles/" [shape=box];
    "Present team to user" [shape=box];
    "User approves?" [shape=diamond];
    "Adjust roles" [shape=box];
    "Begin stage execution" [shape=doublecircle];

    "Approved flow arrives" -> "Existing roles in .solofounder/roles/?";
    "Existing roles in .solofounder/roles/?" -> "Load existing roles" [label="yes"];
    "Existing roles in .solofounder/roles/?" -> "Read project context" [label="no"];
    "Load existing roles" -> "Read project context";
    "Read project context" -> "Read stack/domain learning";
    "Read stack/domain learning" -> "Generate role for each specialist";
    "Generate role for each specialist" -> "Save to .solofounder/roles/";
    "Save to .solofounder/roles/" -> "Present team to user";
    "Present team to user" -> "User approves?";
    "User approves?" -> "Adjust roles" [label="no"];
    "Adjust roles" -> "Present team to user";
    "User approves?" -> "Begin stage execution" [label="yes"];
}