Back to all work

HR Intelligence Platform

8 specialist agents, 28 MCP tools, RAG, and 1,909 tests — an enterprise-style HR platform built as a production-readiness study.

I build practical AI products that can move toward production work: testable systems, verifiable results, and workflow logic that survives more than a demo.

The HR Intelligence Platform is a personal project for learning multi-agent systems, RAG, and AI-assisted product development. I use AI tools, but I do not let them own the product judgment. The dashboard link below hits the live Cloud Run deployment (HTTP 200, checked July 2026).

Hi there How can I help your team today?
Policy question
Submit request
Check status
HR analytics
BambooHR sandbox employee data Benefits and policy inquiry Agent flow trace ready for review
8 specialist agents across policy, leave, benefits, compliance, analytics, onboarding, payroll, and recruitment
28 MCP tools with 8 resources and 5 prompts exposed through FastMCP
1,909 tests across unit, integration, API, agent-flow, and browser layers
Cloud Run GCP Cloud Run deployment path with Docker, CI/CD, Prometheus, Grafana, and LangSmith tracing
Project Evidence

Real media and repo receipts

The proof comes straight from the repository and the running system: a committed demo capture, working UI screenshots, and raw API responses. The Cloud Run deployment is live — the dashboard responds with HTTP 200 (last checked July 2026).

Open verified repo
Positioning

What this project proves about me

This project is built for the work AI consultants, AI product engineers, and founding engineers actually do: not only building features, but turning messy workflows into reliable product systems.

Practical AI product judgment

I can turn a vague workflow into a concrete product direction: who uses it, what problem it solves, what data it needs, and what result should be verifiable.

AI tools as leverage

I use Codex, Claude, and browser agents to move faster, but I keep ownership of the plan, product logic, validation, and final judgment.

Production-minded delivery

I think beyond the demo: integrations, sandbox data, UAT, agent tests, browser tests, deployment, observability, security, and maintenance.

Founder-like learning speed

I learned across agent orchestration, RAG, MCP, GCP, CI/CD, dashboard workflows, and testing while keeping the project pointed toward a usable product outcome.

Context

Why I built this project

Problem

HR teams answer repetitive policy, benefits, and employee workflow questions. A useful AI product should centralize company knowledge, support 24/7 inquiry, reduce admin time, and still respect workflow logic, integrations, and private data.

My role

Independent AI/full-stack builder. I shaped the product idea, chose the RAG approach, wrote prompts, directed the AI coding workflow, deployed the system, and judged whether the result was ready enough to showcase.

What I built

A supervisor-routed LangGraph system, Flask API, FastMCP server, ChromaDB knowledge layer, PII masking, RBAC, BambooHR sandbox data ingestion, observability, and browser-tested dashboard flows.

Why it matters

It shows how I turn uncertainty into a product path: make the idea concrete, reduce HR inquiry time, test the logic, and move the work toward a production-like system with verifiable results.

What I Verified From The Repo

Evidence beyond the README

I checked the repository structure instead of relying only on the project claim. Everything below can be inspected directly by a recruiter, collaborator, or technical reviewer.

Agent and tool surfaces

Source folders include specialist agents, router logic, MCP servers, a FastMCP tool registry, BambooHR, Workday, and custom HRIS connectors.

RAG and security layers

The repo includes HR policy knowledge bases, ChromaDB/RAG services, PII stripping, JWT auth, RBAC, rate limiting, request logging, sanitization, and security headers.

Docs and reports

Architecture docs, API reference, demo summary, verification report, development notes, and testing reports give a review trail for the system design.

Testing surfaces

The repo contains unit tests, integration tests, E2E chatbot tests, Playwright browser tests, and manual screenshots for MCP, HRIS, and benefits flows.

Learning Curve

The hard part was building confidence from 0 to 1

This project became a way to learn the system behind the system: how a platform works, how cloud deployment works, and how to use AI coding tools without letting them decide the product for me.

0 to 1 uncertainty

As a new grad, the hardest part was digesting a large amount of information quickly and still making practical decisions. I had to build while not fully knowing whether the product, workflow, or validation path would work.

AI coding workflow

I used Codex, Claude, and Playwright to inspect, refine, and test the product. The learning was not "AI writes code for me"; it was how to give AI a concrete plan, review its output, and keep the system aligned with the product goal.

From demo to working evidence

AI can create a polished demo quickly, but that does not mean the product works under real workflows or data. Adding sandbox BambooHR data, tests, and browser checks made the showcase more believable.

Production readiness mindset

The project pushed me to think beyond features: service integration, UAT, logic flow, observability, CI/CD, security, and the maintenance work that makes an AI product usable after the first demo.

Architecture

How a question moves through the system

For a non-technical reader, the platform helps teams manage employee information, company knowledge, benefits, and HR inquiries through a 24/7 chatbot. For technical readers, the value is in routing, retrieval, tools, testing, and traces.

Architecture flow: an employee question is classified by the supervisor router, routed to one of eight specialist agents, which calls the MCP layer of 28 tools including BambooHR and returns a grounded answer with citations. The router, agents, and MCP layer all emit traces to an observability rail with Prometheus and a defect log. intent route tool call grounded answer trace trace trace Employee question Supervisor router Specialist agent ×8 MCP layer 28 tools · BambooHR Response + citations 1 2 3 4 5 Observability — traces · Prometheus · defect log
Every hop is observable: intent, route, tool call, trace.
Evaluation

Testing is part of the story

I learned that AI-assisted tests can still miss important logic. The stronger approach was a test pyramid: unit, integration, system, browser, agent-flow, and human review.

Human review Manual checks helped catch workflow gaps that automated AI testing could mark as passing.
Agent and system tests Router, specialist agents, MCP calls, API behavior, integration paths, and system flows were tested.
Browser confidence Playwright and browser-based checks let AI coding tools inspect the actual product surface.
Testing Reality

Evidence includes what broke

The 1,909-test claim is useful, but the more honest signal is that testing exposed problems too. One 60-query E2E report surfaced router and confidence issues, which made the project more credible as a learning artifact.

System coverage Unit, integration, E2E, API, browser, and agent-flow tests show serious hardening effort.
Known gaps surfaced A 60-query chatbot report exposed router/confidence mismatches instead of hiding imperfect behavior.
Product lesson Testing is not only pass/fail proof; it is how I learn where the AI workflow is still fragile.
Findings from this project

Notes from building this system

View all findings
02
What I learned from testing multi-agent flows

Study Note - AI-assisted tests can pass too easily, so human review and scenario coverage still matter.

04
How RAG changed product trust

Finding - Source-backed answers made the chatbot less like a demo and more like a system with evidence.

06
What MCP taught me about agent interfaces

Technical Deep Dive - MCP made integrations easier to inspect, reuse, and reason about as agent-facing interfaces.

07
Why HR AI needs PII masking early

Finding - BambooHR-style employee data reminded me that privacy has to be part of the workflow design early.

08
How I think about routing between agents

Study Note - A good router is a product judgment call: who should answer, what data is needed, and when to stop.

Next

What I would improve next

Clearer workflow demonstration Show the complete path from HR question to agent routing, data access, answer, and review trace.
Security and observability depth Make privacy, RBAC, traces, alerts, and maintenance signals easier to inspect from the product.
More integrations and prompt iteration Add more MCP surfaces, improve prompts, and make sandbox data more realistic for validation.