How ojaskrisshnan/pm_pilot_multi_agent works
PMPilot takes a manager’s project brief through authenticated project setup, a dependency-aware 17-agent SDLC run, human approval gates, and persisted deliverables and metrics. The frontend provides project and workflow workspaces; its orchestration client can use the FastAPI run API, while the backend engine coordinates agent execution and LLM inference. The README documents major review, reporting, analytics, and artifact capabilities. Some feature routes and UI wiring are unsampled, so those links are shown only where supported by the README or excerpts.
Main entry points: database.py Relational Database · main.py FastAPI Application · App.tsx Application Shell · engine.py Run Orchestrator
Components 21
Project Workspace
- Application Shell
src/App.tsx - Project Dashboard
src/components/ProjectsDashboard.tsx - Workflow Workspace
src/components/WorkflowWorkspace.tsx - Review & Insights
src/components/ApprovalsView.tsx - API Client
src/api/client.ts - Workflow Client Engine
src/engine/OrchestrationEngine.ts - Project State
src/engine/ProjectState.ts
Backend API
- FastAPI Application
backend/app/main.py - Authentication Routes
backend/app/routers/auth.py - Project Routes
backend/app/routers/projects.py - Run & Approval Routes
backend/app/routers/runs.py - Feature Routes
backend/app/routers
Agent Execution
- Run Orchestrator
backend/app/orchestration/engine.py - 17-Agent Definitions
backend/app/agents/definitions.py - Agent Runtime
backend/app/agents/runtime.py
LLM Providers
- Provider Router
backend/app/providers/router.py - LLM Provider Adapters
backend/app/providers
Project State
- Relational Database
backend/app/database.py - Project & Run Records
backend/app/models
Other components
- Manager / Employee
- Cloud / Local LLMs
Connections 26
- Manager / Employee → Application Shell: uses
- Application Shell → Project Dashboard: shows projects
- Application Shell → Workflow Workspace: opens workflow
- Application Shell → API Client: checks session
- Project Dashboard → API Client: manages projects
- Workflow Workspace → Workflow Client Engine: dispatches runs
- Workflow Workspace → Review & Insights: presents reviews
- Workflow Client Engine → API Client: starts and polls
- Workflow Client Engine → Project State: updates workflow
- API Client → FastAPI Application: sends REST requests
- FastAPI Application → Authentication Routes: mounts routes
- FastAPI Application → Project Routes: mounts routes
- FastAPI Application → Run & Approval Routes: mounts routes
- FastAPI Application → Feature Routes: mounts routes
- Run & Approval Routes → Run Orchestrator: controls runs
- Run Orchestrator → 17-Agent Definitions: loads definitions
- Run Orchestrator → Agent Runtime: executes agents
- Agent Runtime → Provider Router: requests inference
- Provider Router → LLM Provider Adapters: selects provider
- LLM Provider Adapters → Cloud / Local LLMs: requests inference
- Run Orchestrator → Relational Database: persists run state
- Relational Database → Project & Run Records: stores records
- Authentication Routes → Relational Database: reads and writes users
- Project Routes → Relational Database: reads and writes projects
- Feature Routes → Relational Database: serves deliverables and metrics
- Run & Approval Routes → Relational Database: reads run status