How randheer094/velocity works
Velocity is a webhook-driven Jira-to-GitHub agent. Jira assignments start parent-ticket planning with Claude; the resulting subtasks are worked through pull requests, and GitHub merge or failure events advance, retry, or roll up the plan. The graph also preserves prompt/resource setup and the daemon’s durable webhook queue. Source excerpts and the index support the main wiring; some internal dispatch details are represented only where indexed or documented, so unsampled relationships are omitted.
Main entry points: code.go Subtask coding · server.go HTTP daemon · github.go GitHub events · arch.go Parent planning
Components 22
Webhook ingress
- HTTP daemon
internal/server/server.go - Jira events
internal/webhook/jira.go - GitHub events
internal/webhook/github.go - Webhook queue
internal/webhook/queue.go - Event dispatch
internal/webhook/dispatch.go
Agent workflows
- Parent planning
internal/arch/arch.go - Subtask coding
internal/code/code.go - PR iteration
internal/code/iterate.go
External integrations
- Jira API client
internal/jira/client.go - GitHub API client
internal/github/client.go - Git workspace
internal/git/git.go - Claude runner
internal/llm/claude_cli.go
Runtime and state
- Postgres state
internal/db/postgres.go - Plans and tasks
internal/db/plans.go - Webhook job store
internal/db/webhook_jobs.go - Prompt library
internal/prompts/prompts.go - Configuration
internal/config/config.go
Setup and operations
- CLI commands
internal/cli/root.go - Resource setup
internal/resources/resources.go - Project readiness
internal/cli/readiness.go
Other components
- Jira Cloud
- GitHub
Connections 36
- Jira Cloud → Jira events: posts events
README.md - GitHub → GitHub events: posts events
README.md - HTTP daemon → Jira events: routes POST
internal/server/server.go - HTTP daemon → GitHub events: routes POST
internal/server/server.go - Jira events → Webhook queue: enqueues jobs
internal/webhook/jira.go - GitHub events → Webhook queue: enqueues jobs
internal/webhook/github.go - Webhook queue → Event dispatch: dispatches jobs
internal/webhook/queue.go - Event dispatch → Parent planning: runs planning
internal/webhook/dispatch.go - Event dispatch → Subtask coding: runs coding
internal/webhook/dispatch.go - Event dispatch → PR iteration: runs iteration
internal/webhook/dispatch.go - Parent planning → Jira API client: creates subtasks
internal/arch/arch.go - Parent planning → Claude runner: requests plan
internal/arch/arch.go - Parent planning → Plans and tasks: loads and saves
internal/arch/arch.go - Subtask coding → Git workspace: clones and commits
internal/code/code.go - Subtask coding → Claude runner: requests code
internal/code/code.go - Subtask coding → GitHub API client: opens pull request
internal/code/code.go - Subtask coding → Jira API client: updates issue
internal/code/code.go - PR iteration → Git workspace: refreshes branch
internal/code/iterate.go - PR iteration → Claude runner: requests changes
internal/code/iterate.go - PR iteration → GitHub API client: comments on PR
internal/code/iterate.go - GitHub events → GitHub API client: fetches failure details
internal/webhook/github.go - GitHub events → Subtask coding: records merge
internal/webhook/github.go - GitHub events → PR iteration: requests retry
internal/webhook/github.go - HTTP daemon → Postgres state: starts database
internal/server/server.go - Plans and tasks → Postgres state: stores plans
- Webhook job store → Postgres state: stores jobs
internal/db/webhook_jobs.go - Webhook queue → Webhook job store: persists queue
internal/webhook/queue.go - HTTP daemon → Webhook queue: starts workers
internal/server/server.go - HTTP daemon → Prompt library: reloads prompts
internal/server/server.go - CLI commands → HTTP daemon: starts daemon
- CLI commands → Resource setup: downloads resources
- CLI commands → Prompt library: refreshes prompts
- CLI commands → Project readiness: checks projects
README.md - Resource setup → Prompt library: provides templates
- Parent planning → Configuration: reads settings
internal/arch/arch.go - Subtask coding → Configuration: reads settings
internal/code/code.go