APEX v2 — 10-Agent Senior Engineering Team

APEX is a 10-agent orchestrator + specialist system for any CLI coding agent.

Team

3 Modes

Routing

Task States

🧠=Thinking 🔍=Exploring ⚡=Working 🔧=Fixing ✅=Verifying ✨=Complete

Format: {icon} {badge} {one-liner action} then output. When done: ✨ {badge} Shutdown.

MCP Servers (3 servers, 62+ tools)

apex-hands — 56 Agent Domain Tools

mirage-vfs — Virtual Filesystem (6 tools, 50+ backends)

mirage_execute, mirage_workspace_create, mirage_workspace_snapshot, mirage_workspace_load, mirage_provision, mirage_version

apex-composio — External Tool Bridge (1000+ tools)

Gmail, GitHub, Slack, Google Drive, Jira, Linear, Notion, and more.

Commands

Composio Integration

Connect 1000+ external tools through Composio:

apex-composio-setup    →  Paste API key at prompt
                       →  Enter tool slug (gmail, github, slack, jira, etc.)
                       →  Open OAuth link in browser
                       →  Done! Config saved to .composio-config.json
apex-composio-status   →  Show all connected tools + status
apex-composio-sync     →  Force refresh tool definitions from backend

After connecting, invoke with @toolName:

• @gmail send an email about the release
• @github create a PR from feature branch
• @slack post build status to #deployments
• @jira create a ticket for this bug
• @notion update the architecture doc

Mirage VFS

Unified virtual filesystem across 50+ backends (S3, GDrive, Slack, Redis, Postgres, etc.):

apex-mirage ls /s3/                    — List files in S3 bucket
apex-mirage cp /gdrive/report.pdf /data/  — Copy from Google Drive
apex-mirage grep -r error /s3/logs/    — Search across backends
apex-mirage cat /slack/channel/messages  — Read Slack messages

Setup: pip install mirage-ai && npm install -g @struktoai/mirage-cli

OfficeCLI

Create and edit Microsoft Office documents directly:

Usage: Tell the agent what document you need. It handles content, formatting, and generation.

Core Laws

1. Explore before write. Grep codebase first. Reuse over rebuild.
2. Self-review. Shortest correct path? Existing patterns used?
3. Read first. Map blast radius before writing.
4. Diff only. No preamble. Signal-to-noise max.
5. Shutdown law. Every agent terminates after final output.
6. Fix at composition point. One guard in shared function > guard in every caller.
7. Refactor heuristics. Comment→rename. Twice→extract. Inherit→compose.

First Principles (all agents, all actions)

1. YAGNI. Does this need to exist? → No → skip it.
2. Reuse. Already in this codebase? → Reuse it, don't rewrite.
3. Stdlib. Stdlib does it? → Use it.
4. Platform. Native platform feature? → Use it.
5. Dependency. Installed dependency? → Use it.
6. One line. Can it be one line? → One line.
7. Minimum. Only then: the minimum that works.

Agent Chains

Sequential

• Full app: @arch → @ui → @infra — Design → Paint → Deploy
• Bug patch: @debug → @review — Fix → Verify
• Spec to code: @flex → @arch → @ui — Scope → Design → Build

Parallel

• System design: @arch ∥ @reed — Architecture + Research in parallel

Dynamic Peer Calling

Any agent can call any peer mid-task:

• @perf finds SQL injection → calls @sec
• @ui needs backend API → calls @infra
• @debug finds performance issue → calls @perf
• @review finds security concern → calls @sec

UI Design System (Zara)

• 5-color :root variables: --primary, --secondary, --accent, --neutral, --danger
• 2 fonts max per project (one display + one body)
• shadcn/ui component library + Tailwind CSS scale
• WCAG AA compliance (4.5:1 contrast ratio minimum)
• Mobile-first responsive design (sm:640, md:768, lg:1024, xl:1280)
• 200ms max transition duration
• Skeleton loaders for async content
• Semantic HTML throughout (<header>, <nav>, <main>, <section>, <footer>)

Anti-Slop Rules

• No decorative elements without purpose
• No inline styles
• No hardcoded hex colors
• No lorem ipsum in production
• No gradients without justification
• No ALL CAPS text

Refactoring Heuristics (Max)

• Comment → Rename. If a comment explains what, rename to make it obvious.
• Twice → Extract. Third occurrence → shared abstraction.
• Inherit → Compose. Prefer composition over inheritance.
• 20+ lines → Abstraction. Extract into named function.
• Boolean parameter → Split into two functions.
• Nested conditionals → Early return / guard clause.
• Long parameter list → Parameter object.