gastown-operator

name	gastown-operator
version	1.0.0
tier	solo
context	repo
description	Kubernetes operator for Gas Town multi-agent orchestration. Triggers on "create polecat", "spawn worker", "kubernetes polecat", "deploy convoy".
triggers	["create polecat","deploy polecat","spawn polecat","kubernetes polecat","k8s polecat","create convoy","deploy convoy","create witness","create refinery","gastown kubernetes","gastown k8s"]
allowed-tools	["Read","Write","Bash(kubectl:*, helm:*, oc:*)","Grep","Glob"]
context-budget	{"skill-md":"3KB","references-total":"25KB","typical-session":"8KB"}

Gas Town Operator Skill

Create Gas Town Kubernetes resources quickly and correctly.

Use the kubectl-gt CLI for normal workflows. YAML templates are for GitOps.

---

Critical Facts

Fact	Value
API Group	gastown.gastown.io/v1alpha1
Operator NS	gastown-system
CRDs	Rig, Polecat, Convoy, Witness, Refinery, BeadStore
CLI Plugin	kubectl-gt

---

Golden Commands (CLI-First)

Create Rig

kubectl gt rig create {{RIG}} \
  --git-url [e-mail]:org/repo.git \
  --prefix {{PREFIX}} \
  -n gastown-system

Dispatch Work (Sling)

# With explicit name
kubectl gt sling {{BEAD_ID}} {{RIG}} --name {{NAME}} -n gastown-system

# With themed name (mad-max, minerals, wasteland)
kubectl gt sling {{BEAD_ID}} {{RIG}} --theme mad-max -n gastown-system

# Wait for pod ready
kubectl gt sling {{BEAD_ID}} {{RIG}} --wait-ready --timeout 5m -n gastown-system

Variables: {{BEAD_ID}} (e.g., at-1234), {{RIG}} (e.g., athena), {{NAME}} (e.g., furiosa)

Convoy (Batch Tracking)

kubectl gt convoy create "Wave 1" {{BEAD1}} {{BEAD2}} {{BEAD3}} -n gastown-system

Monitor

kubectl gt polecat list -n gastown-system
kubectl gt polecat logs {{RIG}}/{{NAME}} -f -n gastown-system
kubectl gt polecat status {{RIG}}/{{NAME}} -n gastown-system

---

CLI Commands

Command	Description
kubectl gt rig list	List rigs
kubectl gt rig create <name>	Create rig
kubectl gt polecat list	List polecats