PROJECT 002 // PATCHAI Engineering / Developer Productivity
CASE STUDY & SYSTEM ARCHITECTURE

An AI teammate for your engineering team.

PATCH connects directly to Git repositories and Azure DevOps work items via the Model Context Protocol (MCP) to give engineering teams context-aware pull-request reviews, change-impact analysis, and linked work-item verification without leaving their workflow.

CORE TECHNOLOGY STACK
TypeScript
Node.js
MCP
Git APIs
Azure DevOps REST APIs
LLM APIs
EDITION 002 // 006DRAG TO ORBIT 3D COLLECTIBLE
THE PATCH // COLLECTIBLE SCULPT

An orange mechanical robot repairing a circuit board.

FINISH: POLISHED DESIGNER RESIN & INDUSTRIAL COMPOSITE
01 // THE BUSINESS PROBLEM

WHY LEGACY WORKFLOWS BREAK DOWN.

Code reviews often suffer from missing context: reviewers have to cross-reference diffs against Azure DevOps tickets, architectural conventions, and related modules manually.

PAIN 01

Large pull requests stall in review queues because understanding the intent and blast radius takes too long.

PAIN 02

Requirements in Azure DevOps work items drift from what is actually implemented in a branch.

PAIN 03

Generic AI code review bots comment on trivial syntax while missing repo-specific patterns and ticket acceptance criteria.

02 // THE SOLUTION OVERVIEW

HOW PATCH SOLVES IT.

PATCH uses MCP tools to inspect the full repository tree, git history, and linked Azure DevOps work items before producing structured PR summaries and targeted review findings.

WIN 01

Correlates code diffs with Azure DevOps user stories, acceptance criteria, and linked bug reports.

WIN 02

Traverses call sites and module imports via MCP tools rather than looking only at isolated diff hunks.

WIN 03

Produces concise PR briefings, risk flags, and actionable review comments directly in the team's workflow.

03 // KEY SYSTEM CAPABILITIES

BUILT FOR PRODUCTION REALITY.

6 CORE MODULES // PATCH

CAPABILITY 01PR REVIEW

Pull-Request Analysis

Summarizes structural changes, affected modules, and potential regression areas across multi-file diffs.

MODULE STATUSSPECIFIED
CAPABILITY 02GIT CONTEXT

Git Repository Inspection

Navigates file trees, blame history, and symbol references to understand surrounding code context.

MODULE STATUSSPECIFIED
CAPABILITY 03AZURE DEVOPS

Azure DevOps Work-Item Integration

Fetches linked epics, stories, and tasks to verify that code changes align with stated acceptance criteria.

MODULE STATUSSPECIFIED
CAPABILITY 04SUMMARIES

AI-Generated Code Review Summaries

Generates human-readable walkthroughs, sequence notes, and targeted inline review observations.

MODULE STATUSSPECIFIED
CAPABILITY 05MCP

MCP Tool Integration

Exposes standardized Model Context Protocol servers for Git, Azure DevOps, and internal linters.

MODULE STATUSSPECIFIED
CAPABILITY 06INSIGHTS

Development Workflow Insights

Surfaces bottlenecks, recurring review themes, and unlinked changes across active sprints.

MODULE STATUSSPECIFIED
04 // END-TO-END WORKFLOW ILLUSTRATION

FROM INPUT TRIGGER TO VERIFIED OUTPUT.

STEP 01
Webhook Listener

Receive PR Event

Captures branch refs, changed file list, and linked Azure DevOps work-item IDs.

STAGE ARTIFACT
Review Job Payload
STEP 02
MCP Tool Layer

Fetch Repo & Ticket Context

Reads work-item acceptance criteria, diff hunks, and referenced source files.

STAGE ARTIFACT
Contextual Workspace Snapshot
STEP 03
Review Agent

Analyze Impact & Specs

Evaluates logic changes, edge cases, and alignment with the work item.

STAGE ARTIFACT
Structured Findings
STEP 04
DevOps Publisher

Publish PR Briefing

Posts a clear change walkthrough, spec checklist, and targeted review notes.

STAGE ARTIFACT
PR Summary & Annotations
05 // AI ENGINEERING APPROACH

DETERMINISTIC GUARDRAILS + APPLIED INTELLIGENCE.

High-signal reviews require repository context and product intent. We avoid noisy line-by-line nitpicking in favor of architectural and requirement-aware analysis.

PILLAR 01

Model Context Protocol (MCP) First

All repository and Azure DevOps capabilities are encapsulated as modular MCP tools so the agent can pull surrounding files on demand.

PILLAR 02

Ticket-to-Diff Alignment

By reading the linked Azure DevOps work item alongside the diff, PATCH highlights missing acceptance criteria before QA.

PILLAR 03

Noise Suppression

Deterministic formatters and linters handle style; the LLM focuses on logic, edge cases, security, and cross-module impact.

06 // INTERACTIVE TECHNICAL ARCHITECTURE BLUEPRINT

SYSTEM ARCHITECTURE & DATA FLOW.

An MCP-centered agent host that orchestrates read-only tool calls across Git and Azure DevOps REST APIs to assemble rich context before running review reasoning.

Illustrative reference architecture — supports webhook-triggered PR events or interactive CLI/IDE invocations.
ACTIVE LAYER: 01 · TRIGGERSPR Webhook & CLI Trigger

Receives pull-request lifecycle events or developer on-demand review requests with branch and ticket identifiers.

PR Webhook & CLI Trigger —[PR metadata + SHA]→ Context-Gathering Review Agent