Skip to content

aget-framework/template-operator-aget

Repository files navigation

Template: Operator Agent

Maintain system health with incident handling and operational playbooks

Version: v3.12.0 | Archetype: Operator | Skills: 2 specialized + 15 universal


Why Operator?

The Operator archetype ensures operational reliability for systems and services. Unlike development-focused agents, operator agents specialize in:

  • Incident response — Handle issues with structured triage, investigation, and resolution
  • Playbook execution — Run standard operating procedures with tracking and verification
  • System health — Maintain operational continuity through proactive monitoring

For evaluators: If you need an AI that can handle incidents methodically and execute operational procedures reliably, the Operator archetype brings SRE discipline to your workflow.

Domain knowledge that compounds: Operator agents build persistent understanding of your operational environment — recurring incidents, effective runbooks, system dependencies, and resolution patterns. Unlike tools that start fresh each session, your agent accumulates operational context that makes each incident response faster and each playbook execution more reliable.


Skills

Operator agents come with 2 archetype-specific skills plus the universal AGET skills.

Archetype Skills

Skill Description
aget-handle-incident Handle incidents with structured triage, impact assessment, and resolution tracking. Documents timeline and actions.
aget-run-playbook Execute operational playbooks with step verification and rollback options. Tracks completion and exceptions.

Universal Skills

All AGET agents include session management, knowledge capture, and health monitoring:

  • aget-wake-up / aget-wind-down — Session lifecycle
  • aget-create-project / aget-review-project — Project management
  • aget-record-lesson / aget-record-observation — Learning capture
  • aget-check-health / aget-check-kb / aget-check-evolution — Health monitoring
  • aget-propose-skill / aget-create-skill — Skill development
  • aget-save-state / aget-file-issue — State and issue management

Ontology

Operator agents use a formal vocabulary of 7 concepts organized into 2 clusters:

Cluster Concepts
Incident Management Incident, Severity, Resolution, Timeline
Operations Playbook, Step, Runbook

This vocabulary enables precise communication about operational activities.

See: ontology/ONTOLOGY_operator.yaml


Quick Start

# 1. Clone the template
git clone https://github.com/aget-framework/template-operator-aget.git my-operator-agent
cd my-operator-agent

# 2. Configure identity
# Edit .aget/version.json:
#   "agent_name": "my-operator-agent"
#   "domain": "your-domain"

# 3. Verify setup
python3 -m pytest tests/ -v
# Expected: All tests passing

Try the Skills

# In Claude Code CLI
/aget-handle-incident   # Respond to an incident
/aget-run-playbook      # Execute operational procedure

What Makes Operator Different

Aspect Ad-hoc Response Operator Agent
Incidents Reactive chaos Structured triage and resolution
Procedures Manual steps Verified playbook execution
Documentation Post-hoc Real-time timeline
Rollback Improvised Planned reversion paths
Domain memory Starts fresh each session Accumulates operational expertise over time

.claude/ Directory

Directory Purpose Owner
.claude/skills/ Slash command definitions Framework + Agent
.claude/agents/ Subagent definitions Agent
.claude/rules/ Path-scoped context rules Agent

Skills are provided by the template. Agents and rules directories are scaffolded for your customization.


Framework Specification

Attribute Value
Framework AGET v3.12.0
Archetype Operator
Skills 17 total (2 archetype + 15 universal)
Ontology 7 concepts, 2 clusters
License Apache 2.0

Learn More


Related Archetypes

Archetype Best For
Worker Task execution
Developer Code and build processes
Supervisor Fleet coordination

AGET Framework | Apache 2.0 | Issues

About

Operational template for deployment and incident response - Extends Worker archetype

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages