Project Overview

Maverick is a custom-built AI agent orchestration platform that manages complex software development workstreams across multiple projects. It exposes a Discord bot as a control plane, routing work through a structured intake → planning → implementation → verification → review lifecycle. Workstream state is persisted in SQLite and survives across sessions. Multiple AI execution backends (Codex, Claude Code) are supported via configuration.

How It Works

Every task begins with a structured intake that scopes the work, identifies risks, and surfaces operator decisions before any code is written. A decision-gated planning pipeline collects structured answers via Discord and synthesizes them into an execution prompt. Codex or Claude Code executes the plan in an isolated worktree. After execution, a verification agent runs checks and a review agent produces a structured handoff summary.

Key Features

  • Specialized agent layer: planning, intake, goal-framing, system modeling, incident triage, epic context, daily brief generation
  • Persistent workstream state machine backed by SQLite — fully resumable across sessions
  • Discord bot control plane: workstream creation, approval gates, status queries, and daily briefing delivery
  • Pluggable execution backends (Codex, Claude Code) selected per-project via configuration
  • Daily brief scheduler aggregating git history, workstreams, approvals, calendar items, and tagged notes
  • Multi-project support with per-project doctrine files (AGENTS.md) and epic lane branch hygiene

Technical Architecture

TypeScript Node.js Discord.js Claude AI SDK SQLite (better-sqlite3) Express Vitest Pino

Current Status

Active personal tool; drives development of its own codebase and several other projects. Private repository.