How rbkmen/qa-orchestrator works
QA Orchestrator is a deterministic MCP service that tracks bounded, content-free QA review sessions; the host agent retains evidence gathering, model execution, findings, and final decisions. The principal flow is host-selected triage and review routing, ordered primary-review transitions, optional risk-triggered deep review, and final synthesis/outcome recording. The server exposes tools through a service layer, which delegates workflow state to the orchestrator and loads policy, profiles, and optional persistence. README-documented host instruction templates are included. Relationships follow excerpts, the source index, or README; unsampled implementation details are not inferred.
Main entry points: service.py Orchestrator Service · orchestration.py Session Workflow · server.py MCP Tools · cli.py CLI Setup
Components 12
MCP Interface
- MCP Tools
src/qa_orchestrator/server.py - Orchestrator Service
src/qa_orchestrator/service.py - CLI Setup
src/qa_orchestrator/cli.py - MCP Launcher
src/qa_orchestrator/mcp_launcher.py
Review Workflow
- Workflow Contracts
src/qa_orchestrator/contracts.py - Session Workflow
src/qa_orchestrator/orchestration.py
Policy And Profiles
- Settings
src/qa_orchestrator/config.py - Model Policy
src/qa_orchestrator/model_policy.py - Review Profiles
src/qa_orchestrator/review_profiles.py
Session State
- SQLite Session Store
src/qa_orchestrator/session_store.py
Host Guidance
- Host Rule Templates
client-rules
Other components
- Host Agent
Connections 17
- Host Agent → MCP Tools: calls tools
README.md - MCP Tools → Orchestrator Service: routes requests
src/qa_orchestrator/server.py - Orchestrator Service → Session Workflow: delegates workflow
src/qa_orchestrator/service.py - Orchestrator Service → Model Policy: loads policy
src/qa_orchestrator/service.py - Orchestrator Service → Review Profiles: builds catalog
src/qa_orchestrator/service.py - Orchestrator Service → SQLite Session Store: configures persistence
src/qa_orchestrator/service.py - Orchestrator Service → Settings: reads settings
src/qa_orchestrator/service.py - Session Workflow → SQLite Session Store: persists sessions
src/qa_orchestrator/orchestration.py - Session Workflow → Workflow Contracts: uses types
src/qa_orchestrator/orchestration.py - Session Workflow → Model Policy: uses selection
src/qa_orchestrator/orchestration.py - Session Workflow → Review Profiles: uses profiles
src/qa_orchestrator/orchestration.py - Review Profiles → Workflow Contracts: defines catalog
src/qa_orchestrator/review_profiles.py - CLI Setup → Settings: reads settings
src/qa_orchestrator/cli.py - CLI Setup → Model Policy: configures models
src/qa_orchestrator/cli.py - CLI Setup → MCP Tools: starts service
src/qa_orchestrator/cli.py - MCP Launcher → MCP Tools: starts server
src/qa_orchestrator/mcp_launcher.py - Host Rule Templates → Host Agent: guides reviews
README.md