orchestry-mcp/.serena/memories/project_overview.md

Orchestry MCP Server for multi-session task management

# BMAD Task Manager - Project Overview

## Purpose
A comprehensive task management system specialized for the BMAD (Business → Mission → Approach → Deployment) methodology, designed to solve:
- Document proliferation issues in BMAD workflows
- Difficulty tracking tasks across multiple sessions/roles
- Need for both LLM automation (via MCP) and human interaction (via Web UI)

## Tech Stack
- **Backend**: TypeScript, Node.js, Express.js, SQLite (better-sqlite3)
- **MCP Integration**: @modelcontextprotocol/sdk for LLM tool integration
- **Frontend**: React 18, Vite, TailwindCSS
- **State Management**: Zustand
- **Real-time Communication**: Socket.io
- **UI Components**: @dnd-kit for drag-and-drop kanban board
- **Type Safety**: Shared TypeScript types between server and client
- **Build Tools**: TSC for TypeScript compilation, Vite for frontend bundling

## System Architecture
1. **Dual-mode Server**: Can run as MCP server (stdio) or Web API server
2. **Shared Types**: Common type definitions in `/shared` folder
3. **SQLite Database**: Persistent storage for BMAD entities
4. **Real-time Sync**: WebSocket for live updates between sessions
5. **Port Configuration**: Environment-based port settings (default 7530/7531)

## Key Features
- Hierarchical task management (Business → Mission → Approach → Deployment)
- 10 MCP tools for LLM integration
- Kanban board with 6 status columns
- BMAD hierarchy tree visualization
- Document linking and management
- Multi-session support with different port configurations