https://github.com/aget-framework/template-operator-aget
Operational template for deployment and incident response - Extends Worker archetype
https://github.com/aget-framework/template-operator-aget
Last synced: 20 days ago
JSON representation
Operational template for deployment and incident response - Extends Worker archetype
- Host: GitHub
- URL: https://github.com/aget-framework/template-operator-aget
- Owner: aget-framework
- Created: 2025-12-29T09:51:03.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-02-22T08:57:08.000Z (3 months ago)
- Last Synced: 2026-02-22T14:25:44.528Z (3 months ago)
- Language: Python
- Size: 115 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Governance: governance/CHARTER.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# 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`](ontology/ONTOLOGY_operator.yaml)
---
## Quick Start
```bash
# 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
```bash
# 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](https://github.com/aget-framework/aget) |
| **Archetype** | Operator |
| **Skills** | 17 total (2 archetype + 15 universal) |
| **Ontology** | 7 concepts, 2 clusters |
| **License** | Apache 2.0 |
---
## Learn More
- **[AGET Framework](https://github.com/aget-framework/aget)** — Core framework documentation
- **[Archetype Guide](https://github.com/aget-framework/aget/blob/main/docs/GETTING_STARTED.md)** — All 12 archetypes explained
- **[Getting Started](https://github.com/aget-framework/aget/blob/main/docs/GETTING_STARTED.md)** — Full onboarding guide
---
## Related Archetypes
| Archetype | Best For |
|-----------|----------|
| **[Worker](https://github.com/aget-framework/template-worker-aget)** | Task execution |
| **[Developer](https://github.com/aget-framework/template-developer-aget)** | Code and build processes |
| **[Supervisor](https://github.com/aget-framework/template-supervisor-aget)** | Fleet coordination |
---
**AGET Framework** | Apache 2.0 | [Issues](https://github.com/aget-framework/aget/issues)