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
kubectl gt polecat logs <rig>/<name>	Stream logs
kubectl gt sling <bead> <rig>	Dispatch work
kubectl gt convoy list	List convoys
kubectl gt auth sync	Sync Claude creds

All commands support -o json and -o yaml output.

---

Templates (YAML Alternative)

If you need declarative YAML (GitOps), templates are in templates/:

Template	Use
polecat-minimal.yaml	Minimal K8s polecat (5 vars)
polecat-kubernetes.yaml	Full K8s polecat (all options)
convoy.yaml	Batch tracking
secret-*.yaml	Credentials

Validate: ./scripts/validate-template.sh <file>

---

Quick Checks

kubectl gt rig list -n gastown-system          # List rigs
kubectl gt polecat list -n gastown-system      # List polecats
kubectl gt auth status -n gastown-system       # Check creds
kubectl get secrets -n gastown-system          # Check secrets

---

Common Errors

Error	Fix
rig not found	Create rig first: kubectl gt rig create <name> --git-url ...
secret not found	Create secrets: kubectl create secret generic git-creds ...
missing gitRepository	Fixed in v0.4.1 - sling now fetches from Rig
Stuck in Working	Check logs: kubectl gt polecat logs <rig>/<name>

---

JIT Load References

Load these when you need deeper context:

Topic	Reference
Full CRD specs	.claude/references/CRD_REFERENCE.md
Kubernetes mode	.claude/references/KUBERNETES_MODE.md
Troubleshooting	.claude/references/TROUBLESHOOTING.md
Anti-patterns	FRICTION_POINTS.md
Full templates	templates/*.yaml