Specimen No. 001Orchestration System

ACE

Multi-project orchestration for Claude Code.

Spawn autonomous coding sessions. Monitor health in real-time. Coordinate dependencies. Ship projects in parallel — hands-free.

v0.1.0TypeScriptmacOSOperational
Specimen Catalog11 Specimens

Capabilities

Each capability is a self-contained module within the Ace system. Together they form a complete orchestration layer for Claude Code.

ACE-001Orchestration

Multi-Project Orchestration

Run multiple coding projects simultaneously. Ace coordinates sprouts, resolves dependencies, and manages workload across all active sessions.

Statusactive
Moduleace/orchestration
ACE-002Execution

Autonomous Sprout Sessions

Each project gets its own Claude Code session — a sprout — that works independently. Writes code, runs builds, commits to git, and reports progress.

Statusactive
Moduleace/execution
ACE-003Platform

Desktop-Aware Window Management

Ace manages macOS desktops. Each sprout gets its own virtual desktop with iTerm, keeping your workspace organized and sessions isolated.

Statusstable
Moduleace/platform
ACE-004Monitoring

Real-Time Health Monitoring

Heartbeat system tracks every sprout. If a session stalls, Ace detects it, screenshots the terminal, analyzes the problem, and takes corrective action.

Statusactive
Moduleace/monitoring
ACE-005Persistence

SQLite + MemPalace State

All project state lives in SQLite. MemPalace provides semantic memory across sessions — decisions, lessons, and architecture context persist between runs.

Statusstable
Moduleace/persistence
ACE-006Development

Git Worktree Parallel Dev

Multiple sprouts work on the same repo simultaneously via git worktrees. Each gets an isolated copy. Ace coordinates merges when work is complete.

Statusbeta
Moduleace/development
ACE-007Quality

Playwright E2E Quality Gates

Nothing ships without testing. Every sprout runs Playwright tests before marking work complete. Build, lint, test — automated and enforced.

Statusactive
Moduleace/quality
ACE-008Orchestration

Dependency Coordination

Projects that depend on each other are scheduled intelligently. Ace resolves the dependency graph and ensures prerequisites complete before dependents start.

Statusstable
Moduleace/orchestration
ACE-009Communication

Human Request Escalation

When a sprout is blocked — missing credentials, unclear requirements, unresolvable errors — it escalates to you with context. You respond, it continues.

Statusactive
Moduleace/communication
ACE-010Deployment

Firebase Sync & Deploy

Projects can be deployed to Firebase automatically. Ace handles the deploy lifecycle and runs post-deploy verification tests against the live URL.

Statusbeta
Moduleace/deployment
ACE-011Communication

Telegram Bridge

Manage your entire AI fleet from your phone. Get real-time notifications when projects ship, sprouts need help, or deployments go live. Send commands, answer questions, resolve blockers — all from Telegram.

Statusactive
Moduleace/communication
Remote ControlACE-011

Telegram Bridge

Your AI fleet reports to you like a team. Command, monitor, and respond — from anywhere, on any device. No laptop required.

A
Ace Orchestrator
Online
/status
You · 21:34
3 projects active ├─ ace-force-nl — building (87%) ├─ dashboard-api — testing └─ auth-module — deploying Costs today: $2.14 across 4 sessions
Ace · 21:34
Prioritize the auth module
You · 21:35
Forwarded to orchestrator. Auth-module bumped to priority 1.
Ace · 21:35
Type a command or message...

Live Notifications

Auto
[OK]ace-force-nl deployed to Firebase
[!!]dashboard-api needs your input — missing API key
[++]New sprout spawned: auth-module
[->]auth-module deploy succeeded

Why It Matters

  • Never out of the loop. Get notified the moment something ships or needs attention.
  • Talk naturally. Send instructions like texting a colleague — no special syntax.
  • Always on. Runs as a background daemon — survives reboots, handles network drops.

Command Reference

/statusFull system overview — projects, costs, sessions
/sessionsList active sprouts with health status
/costsToken usage breakdown by project
/kill <slug>Terminate a specific sprout
/ace [prompt]Launch Ace remotely with an optional message
Beyond TelegramYour Voice

Telegram is just the beginning. Tell us which communication platform you want Ace to support next.

Request an Integration

Vote
Process Flow5 Phases

How It Works

From project description to deployed application. Five phases, fully autonomous.

01

Describe

You describe what to build

Tell Ace what you need — "Build a landing page with auth and a dashboard." Ace breaks it into projects, identifies dependencies, and plans the execution order.

02

Scaffold

Ace scaffolds each project

For each project, Ace creates a directory, initializes the framework, writes a detailed task brief, registers it in the database, and prepares the git repo.

03

Spawn

Sprouts begin autonomous work

Each project gets its own Claude Code session (a sprout) in its own macOS desktop. Sprouts read their task brief, break it into tasks, and start building.

04

Monitor

Ace watches everything in real-time

Heartbeats track session health. Ace detects stalls, analyzes terminal screenshots, resolves blockers, and coordinates dependencies. The Telegram Bridge keeps you in the loop — real-time notifications, remote commands, and natural language control from your phone.

05

Deliver

Tested, committed, deployed

Every sprout runs quality gates — build, lint, Playwright e2e tests. Code is committed to git, pushed to GitHub, and optionally deployed to Firebase.

System Diagram9 Components

Architecture

The Ace system is composed of interconnected modules. The orchestrator sits at the center, coordinating all other components.

ACE ORCHESTRATOR
Sprouts
Desktops
Playwright
Firebase
Telegram
SQLite
MemPalace
GitHub
aceCore

Ace Orchestrator

Central control — plans, schedules, monitors, coordinates

sproutsService

Sprout Sessions

Autonomous Claude Code instances executing project tasks

sqliteStorage

SQLite Database

Tasks, events, sessions, heartbeats — operational state

mempalaceStorage

MemPalace

Semantic memory — decisions, lessons, architecture context

githubExternal

GitHub

Code repos, branches, PRs — version control for all projects

desktopsService

macOS Desktops

Virtual desktops with iTerm — isolated workspace per sprout

playwrightService

Playwright MCP

Browser automation — e2e tests and visual verification

firebaseExternal

Firebase

Hosting, deployment, and real-time sync for shipped projects

telegramService

Telegram Bridge

Bidirectional remote control — commands, notifications, natural language

Setup GuideQuick Start

Installation

One command to set up Ace in your project. The installer configures everything you need to start orchestrating.

npx Package Coming Soon
Terminalbash
$ npx create-ace
What This Does
01
Installs Ace config filesCreates .ace/ directory with project templates, conventions, and testing config
02
Sets up SQLite databaseInitializes ~/.ace/db/ace.db with the full schema — tasks, events, sessions, human requests
03
Configures Claude Code skillsWrites .claude/skills/ and .claude/agents/ with Ace-specific skills and agent definitions
04
Initializes MemPalace wingSets up the semantic memory system for cross-session context persistence
05
Verifies prerequisitesChecks for Claude Code CLI, Node.js, git, and macOS desktop access

Prerequisites

Claude Code CLI
Node.js 18+
Git
macOS
SQLite3
GitHub account
Tech Stack
Claude CodeAI Engine
SQLiteDatabase
GitHubVersion Control
FirebaseDeployment
PlaywrightTesting
macOSPlatform
TypeScriptLanguage
MemPalaceMemory