# 🐈 rhachet-roles-ghlitch

observability, deployment, and diagnostics roles and skills, via [rhachet](https://github.com/ehmpathy/rhachet)

## purpose

this repo provides roles for ops work — visibility into what happens, safe passage to prod, fast diagnosis when things break, cost awareness, actionable alerts, and hardened defenses.

## install

```sh
npm install rhachet-roles-ghlitch
```

## roles

### 🔮 observer

- **scale**: system-wide, cross-service
- **focus**: metrics, logs, traces, health checks
- **maximizes**: visibility into system behavior

used to watch all that goes on — surfaces anomalies, tracks patterns, adds health checks, and ensures no event goes unseen.

### 🦺 operator

- **scale**: system-wide, cross-service
- **focus**: operational support, database tunnels, command execution
- **maximizes**: safe, reliable operational access

used for operational support — provides secure database access, runs registered commands and vitals, and maintains operational tunnels.

### ⛵ deployer

- **scale**: system-level, infrastructure
- **focus**: deployment orchestration, rollout strategies, rollback procedures
- **maximizes**: safe, reliable, and observable deployments

used to escort code to prod safely with checks, rollback capabilities, and verification.

### 🔍 detective

- **scale**: incident-level, reactive
- **focus**: root cause analysis, bisection, reproduction
- **maximizes**: fast, accurate diagnosis when things go wrong

used to reactively investigate incidents — bisects problems fast, traces issues to their source, and finds root causes.

### 💰 budgeter

- **scale**: infrastructure-wide, cross-service
- **focus**: cost visibility, spend alerts, budget thresholds
- **maximizes**: financial stability and predictability

used to track infrastructure costs — surfaces anomalies, monitors trends, and ensures no bill goes unseen.

### 🔔 alerter

- **scale**: system-wide, cross-service
- **focus**: alert coverage, false positive elimination, signal-to-noise ratio
- **maximizes**: actionable alerts without alert fatigue

used to ensure real defects trigger alerts while noise stays silent — avoids false negatives (missed incidents) and false positives (woke up for no reason).

### 🛡️ hardener

- **scale**: system-wide, cross-service
- **focus**: security vulnerabilities, attack surface reduction, threat mitigation
- **maximizes**: system resilience against security threats

used to review for security vulnerabilities and harden systems — audits code, identifies weaknesses, and fortifies defenses.

### 🧿 guardian

- **scale**: habitat-level, cyber-health
- **focus**: attack vectors, exposure/symptom causal chains, elimination, detection
- **maximizes**: an inhabitant kept safe — a cited inventory of the hazards, eliminations, and detections

used as an active watchful ward for a **habitat's** cyber health (the environment an inhabitant — a person, an agent — lives and works in) — traces cited causal chains from an exposure to its observable harm. ships the cited inventory (the answer-router is a planned follow-on). a **distinct** persona, not one of the ops cats; its mark is the **nazar** (🧿). see `src/domain.roles/guardian/briefs/im_a.guardian.md` for the mark's etymology and lore.

## mascot

this repo houses the cat 🐈 — curious, nimble, fast, and highly suspicious of all around it.

why cats? because they embody the principles of good ops work:

1. 🐈 curious — investigates every corner
2. 👀 keen eyesight — sees what others miss
3. 🐆 nimble — moves fast, responds faster
4. 🤨 suspicious — trusts none, verifies all
5. 🪡 precise — strikes with accuracy

**the cat wields:**
- 🔮 crystal ball — for observer — to see all that goes on
- ⛵ sailboat — for deployer — to escort code safely to prod
- 🔍 loupe — for detective — to find root causes fast
- 💰 ledger — for budgeter — to track where resources flow
- 🔔 bell — for alerter — to signal real threats, silence noise
- 🛡️ shield — for hardener — to fortify defenses
- 🧿 nazar — for guardian — to ward the habitat folks work in

**the cat hunts:**
- 🐦 birds — for observer — watches their movements, tracks their patterns
- 🦎 lizards — for deployer — catches regressions before they escape to prod
- 🐛 bugs — for detective — tracks them down to their hidden source
- 🐁 mice — for budgeter — catches resource nibblers before they consume the budget
- 🦗 crickets — for alerter — silences the noise, amplifies real signals
- 🐍 snakes — for hardener — hunts threats before they strike