Overview
overview.md
Dev Orchestrator
Structured development workflow automation for Claude Code
Key Features:
- • Complexity-based workflow dispatch (0-10 scale)
- • Enforced TDD + Multi-layer quality gates
- • Jira integration automation (status, hours, QA notes)
- • Git worktree isolation for task independence
- • Real-time progress tracking via Task System
Why Dev Orchestrator
before-after.log
Before
Manual workflow steps
Skipped tests
No code review
Manual Jira updates
Context switching chaos
Unclear task progress
After
Auto-dispatch by complexity
TDD enforced at each step
Multi-layer quality gates
Automated status tracking
Isolated Git Worktrees
Real-time Task System
Architecture
architecture.md
Loading diagram...
Complexity-Driven Dispatch
Tasks are analyzed for complexity (0-10) and automatically routed to Fast Track, Standard, or Full workflow.
Phase-Based Execution
Six standardized phases with mandatory checkpoints ensure nothing is skipped.
Workflow Demo
workflow-full.sh
Tech Stack
Claude Code Task System
- TaskCreate: Initialize workflow tasks
- TaskUpdate: Mark status
- TaskList: Query current state
Subagent Orchestration
- Independent subagent per task
- Automatic context isolation
- Inter-agent code review
TDD Enforcement
- RED → GREEN → REFACTOR
- Mandatory test-first cycle
Jira Automation
- Fetch ticket details
- Status transitions
- Log dev hours
Components
components.md
Skills
/orchestrate-from-jira
- Main orchestrator, triggers on Jira URL detection
/jira-pilot
- Jira operations: status, comments, dev hours
/workflow-engine
- Routes to Fast/Standard/Full based on complexity
/writing-plans-tdd
- TDD-enforced implementation planning
/bitbucket-pr
- Create PR via Bitbucket REST API
/agent-browser
- Browser automation for Jira/GitHub login
Agents
jira-pilot
- Fetches ticket info, manages status, logs hours
code-reviewer
- Quality gate: lint, spec alignment, defect detection
complexity-analyzer
- Analyzes task complexity (0-10 scale)
Hooks
SessionStart
- Initializes workflow context on session start
UserPromptSubmit
- Auto-detects Jira URL and triggers orchestration
Hooks System
hooks.json
Dev Orchestrator leverages Claude Code's hook system for seamless workflow automation.
{
"hooks": {
"session_start": {
"command": "bash hooks/session-start.sh"
}
}
}
Zero Configuration
- Skills auto-available after installation
Context Awareness
- Detect project type automatically
Visual Feedback
- Workflow graph on every session