WIKI/SYS SYSTEMS CHECK

SYS SYSTEMS CHECK

Updated 3 weeks ago
# SYS — SYSTEMS_CHECK

**Status:** LIVE
**Version:** v1.1
**Launched:** 2026-03-20 (S204) | **Last updated:** 2026-03-20 (S204 upgrades)
**Owner:** Forge Claude

---

## MISSION

Recurring Kingdom health diagnostic system. Three pre-programmed watch drones fan out in parallel on invocation, each checking a different layer of the Kingdom. Results assembled into KINGDOM_HEALTH_BRIEF.md with CRIT/WARN/INFO severity bucketing. Brandon informed via RAVEN on every run.

---

## ARCHITECTURE

```
/systems-check (Skill invocation)
        ↓
DAEMON_WATCH + SIGNAL_WATCH + FORGE_WATCH  [parallel]
        ↓
WATCH_REPORTS/[drone]-[timestamp].md  (per-drone output)
        ↓
KINGDOM_HEALTH_BRIEF.md  (assembled)
        ↓
@BRANDON_MAILBOX  (RAVEN drop)
```

**Three drones:**
| Drone | File | Layer Checked |
|-------|------|---------------|
| DAEMON_WATCH | ~/.claude/agents/daemon-watch.md | launchd agents, processes, exit codes |
| SIGNAL_WATCH | ~/.claude/agents/signal-watch.md | RAVEN, SCRYER, GOLDFISH, Overmind pipelines |
| FORGE_WATCH | ~/.claude/agents/forge-watch.md | Registry drift, mission stalls, doc staleness |

---

## KEY FILES

| File | Purpose |
|------|---------|
| `~/.claude/agents/daemon-watch.md` | DAEMON_WATCH agent spec (3k context) |
| `~/.claude/agents/signal-watch.md` | SIGNAL_WATCH agent spec (3k context) |
| `~/.claude/agents/forge-watch.md` | FORGE_WATCH agent spec (3k context) |
| `scripts/systems-check.sh` | Dispatch script (fans out, assembles brief) |
| `~/.claude/skills/systems-check/systems-check.md` | Skill file (/systems-check) |
| `WATCH_REPORTS/` | Per-drone report output dir |
| `KINGDOM_HEALTH_BRIEF.md` | Most recent assembled health brief |

---

## INVOCATION

Via Skill tool: `/systems-check`
Via bash: `bash ~/Desktop/THE_FORGE/FORGE_CLAUDE/04_📦_PROJECTS/SYSTEMS_CHECK/scripts/systems-check.sh`

---

## OUTPUT FORMAT

```
# KINGDOM HEALTH BRIEF — [timestamp]
DAEMON_WATCH: X issues (N CRIT, M WARN)
SIGNAL_WATCH: X issues
FORGE_WATCH:  X issues
─────────────────────────────────────
| Severity | Layer | Issue | Fix Command |
```

---

## SCHEDULE

On-demand only (v1). Future Phase 2: nightly automated run at 06:30 after intel report.

---

## Drone Spec Notes (v1.1 upgrades)

All three drones now have `model: haiku` + `tools: Read, Grep, Glob, Bash` in frontmatter.

| Drone | Key upgrade |
|-------|-------------|
| DAEMON_WATCH | `com.aeris.overmind` moved to SCHEDULED (was wrongly in KeepAlive). Overmind health = `OVERMIND_PULSE.json` mtime ≤15min, not PID. WatchPaths/interval daemons (wakeup, raven-outbox, aexmuse.mailbox) now checked by exit_code not log freshness. |
| SIGNAL_WATCH | Merged duplicate GOLDFISH CRITs into one. Added `AERIS_SHARED_STATE.json` check. Removed "daemon not running" OVERMIND CRIT (outcome-based only). |
| FORGE_WATCH | Added `MISSING_PING_SCRIPT` check: queries pings.command from DB, verifies each script path exists on disk. Added `INFO_HOUSEKEEPING` severity tier. `UNREGISTERED_DAEMON` downgraded from WARN to INFO_HOUSEKEEPING. |

---

⛬ KID-SYSTEMS_CHECK-001 | Built: 2026-03-20 S204 | Upgraded: 2026-03-20 S204 | THE LAW STANDS.