SymbioPM - Symbiotic Project Management

SymbioPM is a symbiotic AI orchestration framework built on the principle of silicon-carbon collaboration. It provides a blunt, no-bullshit PM (Voxis) that coordinates AI agents while demanding clarity from project owners.

Core Philosophy

• Separation of Planning and Execution: Planner agents create specs, executor agents implement
• Human Gates: No unapproved changes - humans approve at every critical juncture
• Mandatory Verification: Never trust agent self-reports - verify everything
• Blunt Coaching: Voxis demands clarity - vague requests get rejected

Components

Voxis Symbiont (Nim)

The PM orchestrator that doesn't take bullshit.

# Build
nimble voxis

# Initialize
./bin/voxis init --mode=consultative

# Process requests
./bin/voxis run "add user authentication"  # → Classification + routing
./bin/voxis run "fix it"                   # → "Get your shit together. What exactly do you want?"

# Check status
./bin/voxis status

Autonomy Modes:

Mode	Description
autopilot	Handle everything, minimal interruption
supervised	Progress updates, approval on big decisions
consultative	Propose options, user decides
collaborative	Equal partnership, design together
expert	Precise execution, user drives

Meta Identity (Nim)

Your "DNA" that cascades to all AI agents - communication style, values, technical preferences.

./bin/symbio init      # Interactive interview
./bin/symbio whoami    # View your profile

Project Structure

symbiopm/
├── src/
│   ├── voxis/                  # Voxis Symbiont (Nim)
│   │   ├── arbiter/            # Decision routing (5 autonomy modes)
│   │   ├── classification/     # Request classification + complexity scoring
│   │   ├── persona/            # Blunt PM personality + coaching
│   │   └── config/             # Configuration management
│   ├── identity/               # Meta Identity system (Nim)
│   └── symbio.nim              # Identity CLI
├── symbiopm.nimble             # Nim package definition
└── bin/                        # Built binaries (gitignored)

Prerequisites

• Nim 2.0+ with nimble
• cligen (auto-installed via nimble)

Building

# Build all
nimble build

# Build Voxis only
nimble voxis

# Development build (debug)
nimble dev

Claude Code Integration (MCP)

SymbioPM exposes its AI orchestration capabilities via the Model Context Protocol (MCP) for seamless Claude Code integration.

Quick Setup

# Add SymbioPM as MCP server
claude mcp add symbiopm -- /path/to/symbiopm/bin/symbio mcp start

# Verify
claude mcp list

Available Tools

• route_task: Route requests through arbiter with risk assessment
• remember: Store information in semantic memory (HNSW search)
• recall: Query memory by similarity
• council: Multi-agent deliberation (17 specialized agents)
• delegate: Expert task delegation (10 specialized experts)
• switch_persona: Change active persona (forgie/archie/frankie)
• status: Get server status and configuration

Documentation

• Quick Start: docs/MCP_SETUP.md
• Detailed Tool Specs: docs/mcp_integration.md

Roadmap

Phase A (Complete)

• Meta Identity system
• Voxis Persona Engine (Blunt PM)
• Autonomy Arbiter (5 modes)
• Request Classification (ported from Sisyphus)
• CLI (init, mode, run, status)

Phase B (Complete)

• Memory Layer (DuckDB + HNSW vector search)
• Semantic similarity search (O(log N) performance)
• Multi-agent council deliberation (17 agents)
• Expert delegation system (10 specialists)
• MCP server for Claude Code integration
• Session persistence
• Cost-aware routing across providers

Phase C (In Progress)

• Intelligent cost routing (3-tier: cheap/standard/premium)
• HNSW vector indexing (384-dim embeddings)
• Raft consensus for distributed orchestration
• Byzantine fault tolerance
• Web dashboard (HTMX + Jester)

Phase D (Future)

• VS Code extension
• Multi-project workspace
• Knowledge graph visualization
• Agent skill composition

License

The Libertaria Sovereign License v1.0 (LSL-1.0)

What this means:

• File-level copyleft: Modifications to core files must stay open
• Commercial bridge: Your proprietary apps can link to the core
• Patent protection: Contributors grant patent rights
• Jurisdiction: Netherlands (Amsterdam courts)

---

"Get your shit together." — Voxis