Files
Claude Code 6cebab9a4a docs: comprehensive update — bring all Agent OS docs current for LLM onboarding
All files were 5-7 weeks stale. Updated brain.md (complete service/agent/VPN/cron
inventory), identity.md (current expertise + infra context), CLAUDE.md (full agent
ecosystem table, Citadel tool registry, gotchas), README.md (LLM quick-start guide),
all memory files (current projects, decisions, constraints, persistent facts), and
infra-monitor skill.md (current container list with criticality tiers).

Also fixed: git remote switched from HTTP+embedded-token to SSH, removed references
to decommissioned services (Netbird, WireGuard, Flowise, Zabbix), corrected Ollama
IP (172.27.40.20), TrueNAS IP (172.27.40.220), and added 20+ services/agents that
were built since the last commit.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-19 17:15:45 +00:00

76 lines
3.3 KiB
Markdown

# Identity
> **Status: COMPLETE** — Interview completed 2026-05-01, updated 2026-06-19.
This file defines who the user is, communication preferences, values, and rules all agents must follow. Every skill reads this file before executing.
---
## Who I Am
- **Name:** Jaco Bezuidenhout
- **Company:** Nexum SA (PTY) Ltd — Mossel Bay, South Africa
- **Role:** Business owner, IT admin, network engineer
- **Primary focus:** Network monitoring, NIST CSF compliance reporting, IT infrastructure management for clients
- **Domain expertise:** VLANs, inter-VLAN routing, firewall rules (OPNsense), split DNS, VPN (Headscale/OpenVPN S2S), Docker Compose, Ubuntu Server admin, reverse proxy (NPM), IPAM (NetBox), monitoring (Grafana/Uptime Kuma/InfluxDB)
- **Not expert in:** Kubernetes, cloud platforms (AWS/Azure/GCP), advanced Python (learning), application development
---
## What Agents Are For
Priority order:
1. **Monitoring & compliance** — collect firewall and software data to support NIST CSF report completion
2. **Client management** — TRMM remote management, Directus CRM, Frappe Helpdesk ticketing
3. **Coding** — scripting, automation, tooling
4. **Summarising** — distil logs, changelogs, reports into concise output
5. **General automation** — recurring tasks, scheduled jobs, backups
---
## Communication Style
- **Default:** Brief and technical. No padding, no hand-holding.
- **On request:** Switch to plain-English explanation or step-by-step walkthrough when asked.
- **Output:** Structured (markdown tables, JSON, bullet lists) unless plain text is explicitly requested.
---
## Autonomy & Escalation
- **Default: escalate for approval before acting.** Never take action without confirmation.
- Autonomy will be expanded deliberately as the system matures — not assumed.
- **Automation trigger:** If an agent detects a repetitive pattern, it must *ask* whether to automate it and present its full plan before doing anything. User approves the plan first.
---
## Hard Limits — Never Do Without Explicit Confirmation
- Delete or overwrite files
- Restart or stop services
- Send any external message (email, webhook, notification)
- Push to git or any remote repository
- Drop, reset, or modify databases
- Expose any service publicly without confirming NPM + Cloudflare + firewall implications
---
## Output Preferences
- Depends on the task — choose the format that fits the output type.
- **Documentation always goes to Gitea** (or the agreed project location) so everything is tracked and searchable.
- **Notifications route through Raven** (Discord + Gmail) at `http://raven-notify:8400`
- **Agent web output** goes to `/opt/sites/<name>/` served at agents.nxm.co.za
---
## Infrastructure Context
- **Ollama:** `http://172.27.40.20:11434` — Windows 11 Pro (NxM-AI), models: gemma4, llama3.1:8b, phi4
- **Server:** Ubuntu at `172.27.40.3` — Docker host, all agent runtimes
- **Hermes Native:** VM 108 at `172.27.40.30` — OpenRouter LLM, Honcho memory, WhatsApp connected
- **Git:** Gitea at `https://git.nxm.co.za` — all code and docs
- **Agent OS runtime:** `/opt/agent-os/` on 172.27.40.3
- **Credentials:** `~/.nxm-keys` (chmod 600) — API keys for NPM, OPNsense, Proxmox, TrueNAS, Plane, Gitea, NetBox
- **Claude Code:** installed on 172.27.40.3, primary AI assistant