Loading...
Loading...
Manage agent fleet through CRUD operations and lifecycle patterns. Use when creating, commanding, monitoring, or deleting agents in multi-agent systems, or implementing proper resource cleanup.
npx skill4agent add melodic-software/claude-code-plugins agent-lifecycle-managementImplementation Note: Full lifecycle management requires Claude Agent SDK with custom MCP tools. This skill provides design patterns for SDK implementation.
Create --> Command --> Monitor --> Aggregate --> Delete
| | | | |
v v v v v
Template Prompt Status Results Cleanuptemplatenamesystem_promptmodelallowed_toolscreate_agent(
name="scout_1",
template="scout-fast",
# OR
system_prompt="...",
model="haiku",
allowed_tools=["Read", "Glob", "Grep"]
)agent_idpromptcommand_agent(
agent_id="scout_1",
prompt="""
Analyze the authentication module in src/auth/.
Focus on:
1. Current implementation patterns
2. Security considerations
3. Potential improvements
Report findings in structured format.
"""
)# Check status
check_agent_status(
agent_id="scout_1",
verbose_logs=True
)
# List all agents
list_agents()
# Read agent logs
read_agent_logs(
agent_id="scout_1",
offset=0,
limit=50
)| Status | Meaning |
|---|---|
| Ready for commands |
| Processing prompt |
| Waiting for input |
| Permission needed |
| Finished |
delete_agent(agent_id="scout_1")"Treat agents as deletable temporary resources that serve a single purpose."
1. Create scout agent
2. Command: Analyze codebase
3. Monitor until complete
4. Aggregate scout findings
5. Delete scout
6. Create builder agent
7. Command: Implement based on findings
8. Monitor until complete
9. Aggregate build results
10. Delete builderPhase 1: Scout
- Create scouts (parallel)
- Command each with specific area
- Aggregate findings
Phase 2: Build
- Create builder
- Command with scout reports
- Monitor implementation
Phase 3: Review
- Create reviewer
- Command to verify implementation
- Generate final report
Cleanup: Delete all agentsCreate: scout_1, scout_2, scout_3 (parallel)
Command each with different area
Monitor all until complete
Aggregate all findings
Delete all scouts
Create: builder_1, builder_2 (parallel)
Command each with different files
Monitor all until complete
Aggregate all changes
Delete all builders---
name: scout-fast
description: Quick codebase reconnaissance
tools: [Read, Glob, Grep]
model: haiku
---
# Scout Agent
Analyze codebase efficiently. Focus on:
- File structure
- Key patterns
- Relevant code sections
Report findings concisely.---
name: builder
description: Code implementation specialist
tools: [Read, Write, Edit, Bash]
model: sonnet
---
# Builder Agent
Implement changes based on specifications.
Follow existing patterns.
Test your changes.
Report what was modified.---
name: reviewer
description: Code review and verification
tools: [Read, Grep, Glob, Bash]
model: sonnet
---
# Reviewer Agent
Verify implementation against requirements.
Check for issues and risks.
Report findings by severity.{
"agent_id": "scout_1",
"template": "scout-fast",
"status": "executing",
"created_at": "2024-01-15T10:30:00Z",
"last_activity": "2024-01-15T10:32:15Z",
"context_tokens": 12500,
"cost": 0.05,
"tool_calls": 15
}| Trigger | Action |
|---|---|
| Work complete | Delete immediately |
| Error state | Delete and report |
| Timeout | Delete and warn |
| User abort | Delete all |
## Lifecycle Implementation
### Agent Templates
[List of templates with configurations]
### CRUD Tools
| Tool | Implementation | Parameters |
| --- | --- | --- |
| create_agent | ... | ... |
| command_agent | ... | ... |
| check_agent_status | ... | ... |
| list_agents | ... | ... |
| delete_agent | ... | ... |
### State Schema
[JSON schema for agent state]
### Cleanup Logic
[When and how agents are deleted]| Anti-Pattern | Problem | Solution |
|---|---|---|
| Keeping dead agents | Resource waste | Delete when done |
| Long-lived agents | Context accumulation | Fresh agents per task |
| Generic agents | Unfocused work | Specialized templates |
| Missing cleanup | Dead agents accumulate | Always delete |
| Reusing agents | Context contamination | Create fresh |
"The rate at which you create and command your agents becomes the constraint of your engineering output.""One agent, one prompt, one purpose - then delete."