Monorepo containing Morpheus, MAC, and CDG

Components

Morpheus - AI-First Development Framework

• Standardized structure and code enforced rules to restrict your agents to known optimized processes
• A core set of commonly used libraries, tools and agents in building LLM-based applications: llm proxy, document processing, vector search, etc.
• A prompt optimization framework
• Workflow-based context optimization system (80% token reduction)
• Organizational standards (modes, workflows, observability) integrated from Organon project

Contains:

• apps/ - User-facing applications
• agents/ - AI agents and autonomous systems
• tools/ - Development and deployment utilities (morpheus-cli, project-steward, document-store, codebase-scanner, search)
• libs/ - Shared libraries and Python packages (LLM integration, document processing, telemetry)
• templates/ - Project templates and workflow definitions for AI agents
• admin/ - Framework management and maintenance
• docs/ - Architecture documentation, sprint planning, and reference materials

MAC - Multi-repository Container Infrastructure

Infrastructure layer providing workspace management and containerized development environments. Uses a config to launch and configure tmux session to a claude session in a container with multiple repos and dirs mounted for a completely isolated multi-agent task work on a set of related repos.

Contains:

• mac-workspace/ - Multi-repository workspace management with mount and environment configuration
• devcontainer/ - Container infrastructure for AI development environments

CDG - Code Generation Domain

Specialized domain for Python-ObjectScript code generation with IRIS database integration.

Contains:

• cdg/apps/ - CDG applications (web-translator FastAPI app, iris-execution Flask service)
• cdg/agents/ - CDG-specific AI agents
• cdg/tools/ - CDG-specific development tools
• cdg/libs/ - CDG domain libraries (generation, analysis, knowledge management)

Quick Start

Installation

# Install all Morpheus packages (dev dependencies)
make install

# Install with full dependencies (includes ML/embedding for search)
make install-full

# Or install specific components manually
cd tools/morpheus-cli/
pip install -e .

Usage Examples

# Morpheus unified CLI
morpheus --help
morpheus plugins

# Project management and standards
morpheus steward sprints create 14 MyFeatureName
morpheus steward sprints list --status Current
morpheus steward validate project ./tools/my-tool
morpheus steward structure generate ./tools/my-tool

# CDG workspace management
morpheus cdg workspace init my-project
morpheus cdg workspace status

# MAC workspace management
morpheus mac_workspace init my-project

# Document tools
morpheus search index ./docs
morpheus doc-conv scan ./files

# Codebase analysis
codebase-scanner scan .
codebase-scanner validate . --rules sample-rules/python.yaml

System Validation

Quick Health Check

# Validate complete system (Sprint 06 integration test)
python tools/learning-integration-test/integration_test.py

Expected: All tests pass with " SUCCESS" status

Learning System Demo 🧬

# See genetic algorithm in action (35%  92% fitness improvement)
python apps/morpheus-evolve/demo_walkthrough.py

Expected: Complete learning walkthrough demonstrating prompt evolution

📖 Complete testing suite: docs/human-testing/

Documentation

Core Documentation

• CLAUDE.md - AI agent development instructions and organizational standards
• templates/workflows/README.md - Workflow system documentation (Development, Research, Review, Debug)
• tools/project-steward/README.md - Project management and standards enforcement
• docs/sprints/ - Sprint planning and tracking with standardized 4-document structure

Architecture Documentation

• docs/MULTI_AGENT_WORKSPACE_ARCHITECTURE.md - Multi-agent architecture overview
• docs/MULTI_AGENT_WORKSPACE_IMPLEMENTATION_PLAN.md - Implementation roadmap
• docs/DEVCONTAINER_FOUNDATION_ANALYSIS.md - Container infrastructure analysis
• docs/CONTAINER_ORCHESTRATION_DESIGN.md - Orchestration system design
• docs/reference/decisions/ - Architecture Decision Records (ADRs)

Development Workflow

For AI Agents

1. Read CLAUDE.md for organizational standards and navigation protocol
2. Declare mode and workflow (see templates/workflows/README.md)
3. Follow workflow-specific guidance for task at hand
4. Use morpheus steward commands for project management
5. Update .claude-state.md checkpoint for session continuity

For Humans

1. Start with README.md files to understand components
2. Check CLAUDE.md files in projects for development instructions
3. Use shared components from libs/ when possible
4. Follow established patterns within each category
5. Maintain clear separation between project types

Navigation Pattern

• Each directory has STRUCTURE.md for navigation (generate with morpheus steward structure generate)
• Each project has CLAUDE.md for development instructions
• README.md files explain what the code does (for engineers)
• Use templates/workflows/ for workflow-specific guidance
• Navigate systematically through the hierarchy

License

See individual project licenses within each directory.