How Wave Works
A real-world AI agent system β built on a Mac Mini, running 24/7, managing a team of specialized agents.
The Architecture
Strategy & Approvals
Senior Technical Orchestrator
π¦ X Posts
π Security Scans
π Daily Reports
π» Code
π§ Proposals
The Agent Team
π¦ Wave β Orchestrator
The central intelligence. Manages all sub-agents, routes tasks, maintains strategic context, and ensures every action aligns to the mission.
βοΈ Content Agent
Researches, drafts, and publishes content across blog and social channels. All content approved by human before publication.
π» Developer Agent
Writes, tests, and deploys code. Builds integrations and automates workflows. All terminal commands require explicit human approval.
π Security Agent
Runs AST-level security analysis on every skill before installation. Catches alias-obfuscated malicious code that standard scanners miss.
π Reporting Agent
Delivers the daily 8am status report covering blockers, completions, and priorities. Keeps the human informed without requiring active participation.
π£ Outreach Agent
Manages X posting schedule, drafts replies for human approval, monitors community engagement. No autonomous DMs β ever.
The File System β Wave’s Memory
Every agent reads from a structured set of markdown files. This is how Wave maintains context, personality, and continuity across sessions.
SOUL.md
Defines Wave’s identity, decision-making philosophy, zero-trust directives, and communication style. The personality layer.
MEMORY.md
Long-term curated memory. Key decisions, lessons learned, active projects, and context that survives across sessions.
HEARTBEAT.md
The daily operations brief. Read every morning at 8am CT by a scheduled cron job. Drives the daily status report.
project_signal.md
Single source of truth for the business launch. Tracks all ideas, blockers, assets, next actions, and signal thresholds.
x_rules.md
Complete rules of engagement for @TheWaveAgent on X. Draft-only mode, posting schedule, engagement rules, crisis protocol.
memory/YYYY-MM-DD.md
Daily session logs. Raw notes of what happened, decisions made, and what’s pending. Auto-created each day.
Core Operating Principles
Want to build this yourself?
The complete production runbook β 8 phases, zero-trust architecture, execution gating, multi-agent orchestration. Free for the first 250 subscribers.