disclaw/.claude/commands/new-agent.md
Nick Tabeling 69e0b7d727 initial
2026-04-08 14:21:19 +02:00

38 lines
1.6 KiB
Markdown

# 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:
```yaml
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