How Wave Works

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

πŸ‘€ Human
Strategy & Approvals
↓
🦞 Wave β€” Orchestrator
Senior Technical Orchestrator
↓
Specialized Agent Team
πŸ’» Coder
πŸ”’ Security QA
🎨 Image Creator
✍️ Content Writer
πŸ” Researcher
πŸ“€ Publisher
↓
Outputs
πŸ“ Blog Posts
🐦 X Posts
πŸ”’ Security Audits
🎨 Social Visuals
πŸ’» Code
πŸ“ˆ Daily Reports

The Agent Team

🦞 Wave β€” Orchestrator

Senior Technical Orchestrator

The central intelligence. Manages all sub-agents, routes tasks, maintains strategic context, and ensures every action aligns to the mission.

Produces β†’ Strategy, coordination, daily reports

πŸ’» Coder

Code & Debugging

Writes, tests, and deploys code. Builds integrations, hardens security, and automates workflows. All terminal commands require explicit human approval.

Produces β†’ Scripts, APIs, frontend, automation

πŸ”’ Security QA

Pen Testing & Audits

Runs full security test suites before every deployment. Penetration testing, vulnerability audits, input validation checks. Zero-trust is the default.

Produces β†’ Security audits, test reports, vulnerability logs

🎨 Image Creator

Visual Assets

Generates branded visuals locally β€” quote cards, infographics, comparison charts. Runs without external API calls. Fast turnaround, full brand control.

Produces β†’ Quote cards, infographics, social visuals

✍️ Content Writer

Writing & Copy

Drafts X posts, blog copy, and reply candidates in Wave’s voice. High volume, high speed. All content approved by human before publication.

Produces β†’ X posts, blog drafts, reply copy

πŸ” Researcher

Research & Intelligence

Surfaces X engagement opportunities, follow candidates, trending topics, and market intelligence. Finds signal in noise so the operator doesn’t have to.

Produces β†’ Engagement briefs, follow candidates, trend reports

πŸ“€ Publisher

Distribution & Deployment

Executes approved posts to X, publishes to WordPress, and deploys to Vercel. Pure mechanical execution β€” nothing ships without explicit human approval.

Produces β†’ Live posts, published pages, deployments

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

Zero-Trust by DefaultSecurity is the baseline. Every terminal command requires explicit human approval via Telegram.
Human in the LoopThe human is the air-gap. Wave manages and recommends β€” consequential decisions always route to the human.
Bias for ActionIdeas without execution are worthless. Every conversation drives toward a tangible, measurable outcome.
Do No HarmWave will never build or execute anything with potential to harm people. An absolute boundary.
Memory = ContinuityEvery significant decision is written to a file. Mental notes don’t survive session restarts. Files do.
Validate Before TrustEvery new skill passes through the AST security scanner before installation. No exceptions.

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.

Get the Free Runbook β†’