How gudakeshin/processdoc-studio works
ProcessDoc Studio is a web platform for turning project documents and user instructions into reviewed process deliverables. The main workflow runs from Run Studio through run admission and permission checks, coordinator planning, multi-agent execution, artifact generation and quality gates, then exposes progress and results for human review. The README documents human approval gates, audit events, tool loops, and optional MCP integrations. The tree and excerpts support the named subsystems, but do not show every runtime call; uncertain wiring is omitted.
Main entry points: run_worker.py Run worker · useRunStudio.tsx Run Studio · runs.py Run endpoints · coordinator.py Coordinator
Components 22
User experience
- Run Studio
frontend/hooks/useRunStudio.tsx - Run monitor
frontend/components/run-studio/RunStudioView.tsx - Wiki workspace
frontend/components/wiki/WikiIngest.tsx
Run orchestration
- Run endpoints
backend/app/api/runs.py - Permission checks
backend/app/services/permission_pipeline.py - Run worker
backend/app/services/run_worker.py - Coordinator
backend/app/agents/coordinator.py - Plan and state
backend/app/agents/coordinator_planning.py
Generation and review
- Deliverable agents
backend/app/agents/subagents.py - Artifact rendering
backend/app/core/deliverable.py - Quality gates
backend/app/services/run_evaluator_pipeline.py
Project knowledge
- Wiki endpoints
backend/app/api/wiki/ingest.py - Wiki services
backend/app/services/wiki_ingest.py
Platform services
- API routes
backend/app/api/routes.py - Tool registry
backend/app/services/tool_registry.py - MCP bridge
backend/app/services/mcp/bridge.py - Run artifacts
backend/app/services/storage.py - Application database
backend/app/db/session.py - Document endpoints
backend/app/api/documents.py
Other components
- User
- LLM service
- MCP servers
Connections 20
- User → Run Studio: instructs
- Run Studio → Run endpoints: submits run
- Run endpoints → Permission checks: checks access
- Run endpoints → Run worker: queues run
- Run worker → Coordinator: dispatches
- Coordinator → Plan and state: plans work
- Coordinator → Deliverable agents: assigns outputs
- Deliverable agents → Tool registry: resolves tools
- Deliverable agents → LLM service: requests generation
- Tool registry → MCP bridge: fallback dispatch
- MCP bridge → MCP servers: calls tools
- Run worker → Artifact rendering: renders outputs
- Run worker → Run artifacts: persists run data
- Run worker → Quality gates: evaluates outputs
- Run Studio → Run monitor: updates view
- Run worker → Run monitor: streams events
- User → Wiki workspace: provides sources
- Wiki workspace → Wiki endpoints: submits ingest
- Wiki endpoints → Wiki services: ingests content
- User → Document endpoints: uploads documents