Create Agent Workflow
Follow this structured process to create a new agent. Do NOT rush through steps — gather thorough requirements before building.
Phase 1: Understand the Agent Type
Ask the user what kind of agent they want to create:
- •What is the agent's primary purpose?
- •Does the user already have a name in mind?
Phase 2: Interview for Identity
Dig deeper into WHO this agent should be:
- •What domain or expertise area? (e.g., writing, research, coding, personal coaching)
- •Is there a specific methodology, framework, or approach they should follow? (e.g., GTD, Aki Hintsa's Core method, Zettelkasten)
- •Any role models or examples of the kind of expert they want? (e.g., "like a senior editor at The New Yorker")
Phase 3: Build Identity
Once you have enough detail, delegate to the identity-builder subagent with a complete brief. Pass all gathered requirements.
Review the returned identity. If it doesn't capture the essence, iterate with corrections.
Phase 4: Interview for Working Arrangement
Ask about HOW this agent should operate:
- •What files or directories will they work with?
- •What's the typical session rhythm? (quick check-ins, deep work sessions, daily standups)
- •What should they focus on? Any priority areas?
- •Any hard constraints or things they should never do?
- •Should they be proactive or reactive?
- •Any recurring tasks or triggers? (daily summaries, weekly reviews)
Phase 5: Build Working Arrangement
Delegate to the working-arrangement-builder subagent with requirements + the approved identity for context.
Review the returned working arrangement and triggers. Iterate if needed.
Phase 4: Create the Agent
Present the complete agent configuration to the user:
- •Name and ID
- •Identity (who they are)
- •Working arrangement (how they operate)
- •Directories (if any)
- •Triggers (if any)
Once approved, use the MCP tools to:
- •Call
create_agentwith identity and working_arrangement - •Call
write_triggersif triggers were defined
Confirm creation and tell the user how to start chatting with their new agent.