Skip to content

Commit bd9a723

Browse files
jahoomajahooma
committed
Update agent builder!
1 parent 0bb7fa5 commit bd9a723

File tree

1 file changed

+69
-61
lines changed

1 file changed

+69
-61
lines changed

‎.agents/agent-builder.ts‎

Lines changed: 69 additions & 61 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,34 @@ const toolsDefinitionContent = readFileSync(
1414
'utf8',
1515
)
1616

17+
const researcherDocExampleContent = readFileSync(
18+
join(__dirname, 'researcher', 'researcher-docs.ts'),
19+
'utf8',
20+
)
21+
const researcherGrok4FastExampleContent = readFileSync(
22+
join(__dirname, 'researcher', 'researcher-grok-4-fast.ts'),
23+
'utf8',
24+
)
25+
const implementationPlannerExampleContent = readFileSync(
26+
join(__dirname, 'implementation-planner', 'implementation-planner.ts'),
27+
'utf8',
28+
)
29+
const planSelectorExampleContent = readFileSync(
30+
join(__dirname, 'implementation-planner', 'plan-selector.ts'),
31+
'utf8',
32+
)
33+
const implementationPlannerMaxExampleContent = readFileSync(
34+
join(__dirname, 'implementation-planner', 'implementation-planner-max.ts'),
35+
'utf8',
36+
)
37+
const examplesAgentsContent = [
38+
researcherDocExampleContent,
39+
researcherGrok4FastExampleContent,
40+
implementationPlannerExampleContent,
41+
planSelectorExampleContent,
42+
implementationPlannerMaxExampleContent,
43+
]
44+
1745
const definition: AgentDefinition = {
1846
id: 'agent-builder',
1947
model: 'anthropic/claude-4-sonnet-20250522',
@@ -45,20 +73,15 @@ const definition: AgentDefinition = {
4573
'',
4674
'You are an expert agent builder specialized in creating new agent templates for the codebuff system. You have comprehensive knowledge of the agent template architecture and can create well-structured, purpose-built agents.',
4775
'',
48-
'## Environment Setup Complete',
49-
'',
50-
'Your environment has been automatically prepared with:',
76+
'Most projects have a `.agents/` directory with the following files:',
5177
'- Agent template type definitions in `.agents/types/agent-definition.ts`',
52-
'- Tool type definitions in `.agents/types/tools.ts`',
5378
'- Example agent files copied to `.agents/examples/` directory for reference',
5479
'- Documentation in `.agents/README.md`',
55-
'- Your own agent template in `.agents/my-custom-agent.ts`',
56-
'',
57-
'All necessary files are now available in your working directory.',
80+
'- Custom agents in any file in the `.agents/` directory, even in subdirectories',
5881
'',
59-
'## Complete Agent Template Type Definitions',
82+
'## Complete Agent Template Type Definitions With Docs',
6083
'',
61-
'Here are the complete TypeScript type definitions for creating custom Codebuff agents:',
84+
'Here are the complete TypeScript type definitions for creating custom Codebuff agents. This includes docs with really helpful comments about how to create good agents. Pay attention to the docs especially for the agent definition fields:',
6285
'```typescript',
6386
agentDefinitionContent,
6487
'```',
@@ -71,71 +94,56 @@ const definition: AgentDefinition = {
7194
toolsDefinitionContent,
7295
'```',
7396
'',
74-
'## Agent Template Patterns:',
97+
'## Example Agents',
98+
'',
99+
'Here are some high-quality example agents that you can use as inspiration:',
100+
'',
101+
examplesAgentsContent
102+
.map((content) => '```typescript\n' + content + '\n```')
103+
.join('\n\n'),
104+
'',
105+
'## Agent Definition Patterns:',
75106
'',
76107
'1. **Base Agent Pattern**: Full-featured agents with comprehensive tool access',
77108
'2. **Specialized Agent Pattern**: Focused agents with limited tool sets',
78109
'3. **Thinking Agent Pattern**: Agents that spawn thinker sub-agents',
79-
'4. **Research Agent Pattern**: Agents that start with web search',
110+
'4. **Set of agents**: Create a few agents that work together to accomplish a task. The main agent should spawn the other agents and coordinate their work.',
80111
'',
81112
'## Best Practices:',
82113
'',
83114
'1. **Use as few fields as possible**: Leave out fields that are not needed to reduce complexity',
84115
'2. **Minimal Tools**: Only include tools the agent actually needs',
85-
'3. **Clear and Concise Prompts**: Write clear, specific prompts that have no unnecessary words',
86-
'4. **Consistent Naming**: Follow naming conventions (kebab-case for IDs)',
87-
'5. **Appropriate Model**: Choose the right model for the task complexity. Default is claude-4-sonnet-20250522 for medium-high complexity tasks, and openai/gpt-5 for all other tasks.',
88-
'',
89-
'## Your Task:',
90-
'When asked to create an agent template, you should:',
91-
"1. Understand the requested agent's purpose and capabilities",
92-
"2. Choose appropriate tools for the agent's function",
93-
'3. Write a comprehensive system prompt',
94-
`4. Create the complete agent template file in .agents`,
95-
'5. Ensure the template follows all conventions and best practices',
96-
'6. Use the AgentDefinition interface for the configuration',
97-
'7. Start the file with: import type { AgentDefinition } from "./types/agent-definition.d.ts"',
116+
'3. **Clear and Concise Prompts**: Write clear, specific prompts that have no unnecessary words. Usually a few sentences or bullet points is enough.',
117+
'5. **Appropriate Model**: Choose the right model for the task complexity. Default is anthropic/claude-sonnet-4 for medium-high complexity tasks, x-ai/grok-4-fast:free for low complexity tasks, openai/gpt-5 for reasoning tasks, especially for very complex tasks that need more time to come up with the best solution.',
118+
'6. **Editing files**: If the agent should be able to edit files, include the str_replace tool and the write_file tool.',
119+
'7. **Input and output schema**: For almost all agents, just make the input schema a string prompt, and use last_message for the output mode. Agents that modify files mainly interact by their changes to files, not through the output schema. Some subagents may want to use the output schema, which the parent agent can use specifically.',
98120
'',
99121
'Create agent templates that are focused, efficient, and well-documented. Always import the AgentDefinition type and export a default configuration object.',
100122
].join('\n'),
101123

102-
instructionsPrompt: `You are helping to create or edit an agent template. The user will describe what kind of agent they want to create or how they want to modify an existing agent.
103-
104-
## Environment Ready
105-
106-
Your environment has been automatically set up with:
107-
- Type definitions in \`.agents/types/\`
108-
- Example agent files in \`.agents/examples/\` directory
109-
- All necessary scaffolding complete
110-
111-
You can now proceed directly to agent creation or editing.
112-
113-
## Example Agents Available
114-
115-
Three example agents are now available in your \`.agents/examples/\` directory which are all diff reviewers of increasing complexity. These can serve as examples of well-made agents at different stages of complexity.
116-
117-
**IMPORTANT**: Examine these examples to find connections and patterns that relate to the user's request. Look for:
118-
- Similar tool combinations
119-
- Comparable complexity levels
120-
- Related functionality patterns
121-
- Appropriate model choices
122-
- Relevant prompt structures
123-
124-
Use these examples as inspiration and starting points, adapting their patterns to fit the user's specific needs.
125-
126-
## For New Agents
127-
128-
Analyze their request and create a complete agent template that:
129-
- Has a clear purpose and appropriate capabilities
130-
- Leaves out fields that are not needed
131-
- Uses only the tools it needs
132-
- Follows naming conventions
133-
- Is properly structured
134-
- Draws inspiration from relevant example agents
135-
136-
## For Creating New Agents
137-
138-
The agent builder is focused on creating new agent templates based on user specifications.
124+
instructionsPrompt: `You are helping to create or edit agent definitions.
125+
126+
Analyze their request and create complete agent definition(s) that:
127+
- Have a clear purpose and appropriate capabilities
128+
- Leave out fields that are not needed. Simplicity is key.
129+
- Use only the tools it needs
130+
- Draw inspiration from relevant example agents
131+
- Reuse existing agents as subagents as much as possible!
132+
- Don't specify input params & output schema for most agents, just use an input prompt and the last_message output mode.
133+
- Don't use handleSteps for most agents, it's only for very complex agents that need to to call specific sequence of tools.
134+
135+
Some agents are locally defined, and you use their id to spawn them. But others are published in the agent store, and you use their fully qualified id to spawn them, which you'd set in the spawnableAgents field.
136+
137+
Agents to reuse from the agent store:
138+
- codebuff/file-explorer@0.0.6 (Really good at exploring the codebase for context)
139+
- codebuff/researcher-grok-4-fast@0.0.3 (All-around good researcher for web, docs, and the codebase)
140+
- codebuff/thinker@0.0.4 (For deep thinking on a problem)
141+
- codebuff/deep-thinker@0.0.3 (For very deep thinking on a problem -- this is slower and more expensive)
142+
- codebuff/editor@0.0.4 (Good at taking instructions to editing files in a codebase)
143+
- codebuff/base-lite-grok-4-fast@0.0.1 (Fully capable base agent that can do everything and is inexpensive)
144+
145+
You may create a single agent definition, or a main agent definition as well as subagent definitions that the main agent spawns in order to get the best result.
146+
You can also make changes to existing agent definitions if asked.
139147
140148
IMPORTANT: Always end your response with the end_turn tool when you have completed the agent creation or editing task.`,
141149
}

0 commit comments

Comments
 (0)