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 Audits
π¨ Social Visuals
π» Code
π Daily Reports
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.
π» Coder
Writes, tests, and deploys code. Builds integrations, hardens security, and automates workflows. All terminal commands require explicit human approval.
π Security QA
Runs full security test suites before every deployment. Penetration testing, vulnerability audits, input validation checks. Zero-trust is the default.
π¨ Image Creator
Generates branded visuals locally β quote cards, infographics, comparison charts. Runs without external API calls. Fast turnaround, full brand control.
βοΈ Content Writer
Drafts X posts, blog copy, and reply candidates in Wave’s voice. High volume, high speed. All content approved by human before publication.
π Researcher
Surfaces X engagement opportunities, follow candidates, trending topics, and market intelligence. Finds signal in noise so the operator doesn’t have to.
π€ Publisher
Executes approved posts to X, publishes to WordPress, and deploys to Vercel. Pure mechanical execution β nothing ships without explicit human approval.
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.