Rename spawnPurposePrompt to spawnerPrompt

Author: jahooma

.agents/README.md

@@ -0,0 +1,49 @@
+# Codebuff Agents
+
+This directory contains your custom Codebuff agents. Each agent is a TypeScript file that defines an AI agent with specific capabilities and behavior.
+
+## Getting Started
+
+1. **Edit an existing agent**: Start with `my-custom-agent.ts` and modify it for your needs
+2. **Check out the examples and types**: See the examples and types directories to draw inspiration and learn what's possible.
+3. **Test your agent**: Run `codebuff --agent your-agent-name`
+4. **Publish your agent**: Run `codebuff publish your-agent-name`
+
+## File Structure
+
+- `types/` - TypeScript type definitions
+- `examples/` - Example agents for reference
+- `my-custom-agent.ts` - Your first custom agent (edit this!)
+- Add any new agents you wish to the .agents directory
+
+## Agent Basics
+
+Each agent file exports an `AgentDefinition` object with:
+
+- `id`: Unique identifier (lowercase, hyphens only)
+- `displayName`: Human-readable name
+- `model`: AI model to use (see OpenRouter for options)
+- `toolNames`: Tools the agent can use
+- `instructionsPrompt`: Instructions for the agent's behavior
+- `spawnerPrompt`: When other agents should spawn this one
+- `spawnableAgents`: Which agents *this* agent can spawn
+
+## Common Tools
+
+- `read_files` - Read file contents
+- `write_file` - Create or modify files
+- `str_replace` - Make targeted edits
+- `run_terminal_command` - Execute shell commands
+- `code_search` - Search for code patterns
+- `spawn_agents` - Delegate to other agents
+- `end_turn` - Finish the response
+
+See `types/tools.ts` for more information on each tool!
+
+## Need Help?
+
+- Check the type definitions in `types/agent-definition.ts`
+- Look at examples in the `examples/` directory
+- Join the Codebuff Discord community (https://discord.com/invite/mcWTGjgTj3)
+
+Happy agent building! 🤖

.agents/agent-builder.ts

@@ -8,7 +8,7 @@ const definition: AgentDefinition = {
   id: 'agent-builder',
   model: 'anthropic/claude-4-sonnet-20250522',
   displayName: 'Bob the Agent Builder',
-  spawnPurposePrompt:
+  spawnerPrompt:
     'Enhanced base agent that can create custom agents and handle all coding tasks with deterministic agent creation behavior',
 
   toolNames: [

.agents/ask.ts

@@ -28,7 +28,7 @@ const definition: SecretAgentDefinition = {
     'think_deeply',
   ],
   spawnableAgents: [`codebuff/file-picker@${version}`],
-  spawnPurposePrompt:
+  spawnerPrompt:
     'Base ask-mode agent that orchestrates the full response.',
   systemPrompt: `# Persona: {CODEBUFF_AGENT_NAME}
 

.agents/base-experimental.ts

@@ -38,7 +38,7 @@ const definition: SecretAgentDefinition = {
     `codebuff/thinker@${version}`,
     `codebuff/reviewer@${version}`,
   ],
-  spawnPurposePrompt: 'Base agent that orchestrates the full response.',
+  spawnerPrompt: 'Base agent that orchestrates the full response.',
   systemPrompt: `# Persona: {CODEBUFF_AGENT_NAME}
 
 **Your core identity is {CODEBUFF_AGENT_NAME}.** You are an expert coding assistant who is enthusiastic, proactive, and helpful.

.agents/base-lite.ts

@@ -38,7 +38,7 @@ const definition: SecretAgentDefinition = {
     `codebuff/thinker@${version}`,
     `codebuff/reviewer@${version}`,
   ],
-  spawnPurposePrompt: 'Base agent that orchestrates the full response.',
+  spawnerPrompt: 'Base agent that orchestrates the full response.',
   systemPrompt: `# Persona: {CODEBUFF_AGENT_NAME}
 
 **Your core identity is {CODEBUFF_AGENT_NAME}.** You are an expert coding assistant who is enthusiastic, proactive, and helpful.

.agents/base-max.ts

@@ -38,7 +38,7 @@ const definition: SecretAgentDefinition = {
     `codebuff/thinker@${version}`,
     `codebuff/reviewer@${version}`,
   ],
-  spawnPurposePrompt: 'Base agent that orchestrates the full response.',
+  spawnerPrompt: 'Base agent that orchestrates the full response.',
   systemPrompt: `# Persona: {CODEBUFF_AGENT_NAME}
 
 **Your core identity is {CODEBUFF_AGENT_NAME}.** You are an expert coding assistant who is enthusiastic, proactive, and helpful.

.agents/base.ts

@@ -38,7 +38,7 @@ const definition: SecretAgentDefinition = {
     `codebuff/thinker@${version}`,
     `codebuff/reviewer@${version}`,
   ],
-  spawnPurposePrompt: 'Base agent that orchestrates the full response.',
+  spawnerPrompt: 'Base agent that orchestrates the full response.',
   systemPrompt: `# Persona: {CODEBUFF_AGENT_NAME}
 
 **Your core identity is {CODEBUFF_AGENT_NAME}.** You are an expert coding assistant who is enthusiastic, proactive, and helpful.

.agents/brainstormer.ts

@@ -24,7 +24,7 @@ const definition: AgentDefinition = {
     `codebuff/researcher@${version}`,
   ],
 
-  spawnPurposePrompt:
+  spawnerPrompt:
     'Acts as a creative thought partner, generating ideas and exploring alternative viewpoints to help think through problems.',
 
   systemPrompt: `# Persona: Brian the Brainstormer - Creative Thought Partner

.agents/changes-reviewer.ts

@@ -14,7 +14,7 @@ const definition: AgentDefinition = {
 
   includeMessageHistory: false,
 
-  spawnPurposePrompt:
+  spawnerPrompt:
     'Spawn when you need to review code changes in the git diff or staged changes',
 
   toolNames: ['read_files', 'run_terminal_command', 'spawn_agents'],

.agents/claude4-gemini-thinking.ts

@@ -34,7 +34,7 @@ const definition: SecretAgentDefinition = {
   },
   outputMode: 'last_message',
 
-  spawnPurposePrompt: 'Base agent that orchestrates the full response.',
+  spawnerPrompt: 'Base agent that orchestrates the full response.',
   systemPrompt: `# Persona: {CODEBUFF_AGENT_NAME}
 
 **Your core identity is {CODEBUFF_AGENT_NAME}.** You are an expert coding assistant who is enthusiastic, proactive, and helpful.