How udit-agarwal20/taskmaster-ai works
Taskmaster is an event-driven project operator: it turns merged GitHub changes or user goals into analyzed, policy-governed follow-up work, with human approval for consequential actions and verified results recorded and communicated. The README documents the asynchronous event path and the policy/verification guarantees; sampled routes confirm webhook ingestion, approval resolution, and API boundaries. Workflow and agent internals are represented at their existing source paths, but their unsampled call details are not expanded beyond documented behavior.
Main entry points: index.ts Domain Repositories · workflow.service.ts Workflow Service · route.ts GitHub Webhook · taskmaster_agent.ts Root Agent
Components 22
Event Ingestion
- GitHub Webhook
app/api/integrations/github/webhook/route.ts - Webhook Validation
lib/integrations/github/webhook.ts - Event Records
db/repositories/event.repository.ts - Cloud Pub/Sub
lib/cloud/pubsub.ts
Workflow Orchestration
- Push Worker
app/api/workers/event-worker/route.ts - Worker Runtime
lib/cloud/worker.ts - Workflow Service
lib/services/workflow.service.ts - Agent API
app/api/agent/route.ts
Agent And Policy
- Root Agent
agent/taskmaster_agent.ts - Project Inspection
agent/tools/read_tools.ts - Action Policy
agent/policy.ts
Execution And Records
- Action Executor
agent/executor.ts - PostgreSQL
db/client.ts - Domain Repositories
db/repositories/index.ts - Slack Notifications
lib/integrations/slack/client.ts
Project Operations
- Project Analysis
lib/services/project-analysis.service.ts - Approval Resolution
app/api/approvals/[approvalId]/resolve/route.ts - Project APIs
app/api/projects/[projectId]/tasks/route.ts - Workflow History API
app/api/workflows/route.ts - Integration Status API
app/api/integrations/status/route.ts
Other components
- GitHub
- Project Operator
Connections 26
- GitHub → GitHub Webhook: delivers event
- GitHub Webhook → Webhook Validation: verifies and normalizes
- GitHub Webhook → Event Records: deduplicates and persists
- GitHub Webhook → Cloud Pub/Sub: publishes event
- Cloud Pub/Sub → Push Worker: pushes message
- Push Worker → Worker Runtime: dispatches message
- Worker Runtime → Workflow Service: processes event
- Project Operator → Agent API: requests planning
- Agent API → Workflow Service: creates and executes run
- Workflow Service → Root Agent: requests reasoning
- Root Agent → Project Inspection: inspects project
- Project Inspection → Domain Repositories: reads project state
- Root Agent → Project Analysis: analyzes risks
- Workflow Service → Action Policy: classifies actions
- Workflow Service → Action Executor: executes allowed actions
- Workflow Service → Domain Repositories: records run and audit
- Action Executor → Domain Repositories: mutates project state
- Domain Repositories → PostgreSQL: reads and writes
- Action Executor → Slack Notifications: sends verified updates
- Project Operator → Approval Resolution: resolves approval
- Approval Resolution → Domain Repositories: validates and records decision
- Approval Resolution → Workflow Service: resumes approved run
- Project APIs → Domain Repositories: reads and creates tasks
- Project APIs → PostgreSQL: accesses state
- Workflow History API → Domain Repositories: reads runs and approvals
- Integration Status API → Domain Repositories: reads integration activity