disclaw/.claude/commands/new-agent.md

Create a New DisClaw Agent

Help me create a new agent workspace directly from the command line (without going through Discord).

What I need from you

1. Ask me for the agent name (lowercase, letters/numbers/hyphens, e.g. frontend-dev)
2. Ask me for the role description (e.g. "Frontend developer for the React web application")
3. Ask me for the Discord channel ID where this agent should listen (I can provide this later)

What to do

Once I provide the name and role:

1. Create the workspace directory at workspaces/<agent-name>/
2. Create workspaces/<agent-name>/agent.yaml with the DisClaw metadata:

   name: <agent-name>
   display_name: <Agent Name>
   role: <role description>
   channel_id: <channel-id or "pending">
   

3. Create workspaces/<agent-name>/CLAUDE.md with a rich identity file that includes:
   • Agent name and role
   • Personality traits
   • Guidelines for behavior
   • Placeholder for workspace-specific context
4. Create workspaces/<agent-name>/.claude/commands/ directory
5. Create workspaces/<agent-name>/.claude/settings.json with default permissions

Important notes

• The agent name must match the pattern: ^[a-z0-9][a-z0-9-]{0,30}[a-z0-9]$
• If a channel ID is not provided, use "pending" -- the user can update it later or use the Discord /new-agent command which handles channel creation automatically
• The CLAUDE.md file is the primary identity mechanism -- make it detailed and useful
• After creation, remind the user that they need to either:
  • Map this workspace to a Discord channel in the database, OR
  • Use the /new-agent Discord command instead for automatic channel setup