Files

T

Claude Code 52f43fa2c5 docs: rewrite CLAUDE.md as standalone project brief

Symlink to ~/.claude/CLAUDE.md removed — global config is now independent.
This file is now the agent-os project context only: current phase, Phase 3
infra-monitor spec, directory structure, and pending Gitea SSH key action.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-05-16 11:51:17 +00:00

2.9 KiB

Raw Blame History

Agent OS — Project CLAUDE.md

What This Project Is

Personal Agentic Operating System. Tool-agnostic AI foundation for scheduled skills, monitoring, and automation.

Runtime: /opt/agent-os/ on 172.27.40.3
Gitea: git.nxm.co.za/admin/agent-os
Edit clone (server): /home/nxm/Documents/agent-os/ (clone pending)

Current Phase

Phase	Status
1 — NFS export + Kubuntu mount	✓ DONE 2026-05-01 (NFS no longer needed — consolidated to server)
2 — Identity interview → identity.md populated	✓ DONE 2026-05-01
3 — infra-monitor skill	NEXT
4 — Cron scheduling (hourly heartbeat + daily digest)	Pending Phase 3
5 — Future skills (backup monitor, peer health, log digest)	Future

Phase 3 — infra-monitor (NEXT)

Skill scaffold at skills/infra-monitor/skill.md. Ready to implement after spec update.

Goal: Docker container state + system resource checks. Complements Varys (HTTP reachability) — do not duplicate.

Before building:

Update skills/infra-monitor/skill.md — container list is stale (has Flowise, missing Open WebUI + all new agents)
Correct Ollama URL: now http://172.27.40.20:11434 (migrated from 172.27.6.139)
Decide: Docker one-shot container (consistent with bran/varys) or host cron + shell script?

Output targets:

/opt/sites/infra-monitor/index.html — web dashboard at agents.nxm.co.za/infra-monitor/
/opt/agent-os/logs/infra-monitor/last-run.json — machine-readable, read by Varys watchdog
Raven alert on critical: http://raven-notify:8400

Schedule: hourly heartbeat (Docker + Ollama only) + daily 07:00 full digest

Directory Structure

/opt/agent-os/
├── CLAUDE.md                   ← this file (project brief, tracked in Gitea)
├── identity.md                 ← populated Phase 2
├── brain.md
├── memory/
│   ├── active-projects.md      ← update at end of each session
│   ├── persistent.md
│   ├── recent-decisions.md
│   ├── constraints.md
│   └── notes-from-last-run.md
├── context/
├── skills/
│   └── infra-monitor/          ← Phase 3 target
│       ├── skill.md            ← spec (stale container list — update before building)
│       ├── learnings.md
│       ├── eval.json
│       ├── last-output.md
│       └── context/handoff.md
└── logs/

Architecture

LLM inference: Kubuntu Ollama at http://172.27.40.20:11434
All agent output: /opt/sites/<name>/ served at agents.nxm.co.za
Log standard: /opt/agent-os/logs/<skill>/last-run.json
Notifications: Raven at http://raven-notify:8400

Pending — Gitea SSH Key (security debt)

Server remote uses HTTP with embedded token. Before next token rotation:

Add SSH key for nxm@172.27.40.3 to Gitea (Admin → Settings → SSH Keys)
cd /opt/agent-os && git remote set-url origin gitea-local:admin/agent-os.git

2.9 KiB Raw Blame History