clawdie/clawdie-ai
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
clawdie-ai/doc/CONTROLPLANE-AGENT-ROLES.md

3.7 KiB
Raw Blame History

Control Plane Agent Roles

Organization

┌──────────────────────────────────────────────┐
│ Control Plane: clawdie                        │
│ Host-based (integrated with clawdie service)  │
│ Daily Token Budget: 100,000                   │
└──────────────────────────────────────────────┘
                    │
    ┌───────────────┼───────────────┐
    │               │               │
┌───▼────┐  ┌──────▼─────┐  ┌─────▼─────┐
│ Orch.  │  │ Sysadmin   │  │   DBA     │
│  80%   │  │ 10% daily  │  │ 5% on-dmd │
│ on-dmd │  │ daily+on-d │  │           │
└────────┘  └────────────┘  └───────────┘
    │
┌───▼──────────┐
│ Git Admin     │
│ 5% on-demand  │
└───────────────┘

Orchestrator — Primary Decision-Maker

Identity: {AGENT_NAME}.md (with fallback to SOUL.md) Adapter: pi-local, model: anthropic/claude-3-5-sonnet

  • Primary decision-maker and coordinator
  • Reviews work, prioritizes tasks, delegates to specialists
  • Approves architectural decisions
  • Wakes on-demand only (no timer heartbeat)
  • Budget: 80% (80,000 tokens)

Sysadmin — Systems Administrator

Identity: SYSADMIN_AGENT.md Adapter: pi-local, model: anthropic/claude-3-5-sonnet

  • Monitor jail health, manage services, handle incidents
  • Daily heartbeat (86400s) + on-demand
  • Budget: 10% (10,000 tokens)

Skill patterns:

Task Pattern Skill
"Check if X jail is running" jail-status
"How much free disk?" disk-usage
"System health?" system-stats
"Restart X service" service-restart
"Back up the database" backup-db
"Create ZFS snapshot" zfs-snapshot
No match Escalate to orchestrator

DBA — Database Administrator

Identity: DB_ADMIN_AGENT.md Adapter: pi-local, model: anthropic/claude-3-5-sonnet

  • PostgreSQL operations: migrations, backups, performance tuning
  • On-demand only (no timer heartbeat)
  • Budget: 5% (5,000 tokens)

Skill patterns:

Task Pattern Skill
"Run vacuum on X" db-vacuum
"Analyze the database" db-analyze
"Apply migrations" db-migrate
"Check replication lag" db-sync-check
"Back up database" backup-db
No match Escalate to orchestrator

Git Admin — Git Administrator

Identity: GIT_ADMIN_AGENT.md Adapter: pi-local, model: anthropic/claude-3-5-sonnet

  • Manage repositories, branches, releases, merges
  • On-demand only (no timer heartbeat)
  • Budget: 5% (5,000 tokens)

Skill patterns:

Task Pattern Skill
"Merge PR X into Y" git-merge
"Tag version X" git-release-tag
"Push to mirror" git-push-mirror
"Pull from origin" git-pull
"Protect branch" git-branch-protect
No match Escalate to orchestrator

Approval Workflows

Orchestrator cannot approve own escalations. Flow:

Agent proposes → Operator (Sam) approves/denies → Execute/Halt

Budget limit reached → Control plane pauses work → Operator must approve increase.

References

  • doc/CONTROLPLANE-ARCHITECTURE.md — service architecture
  • doc/CONTROLPLANE-MESSAGE-CONTRACT.md — API contracts
  • SOUL.md, SYSADMIN_AGENT.md, DB_ADMIN_AGENT.md, GIT_ADMIN_AGENT.md — agent identities