Squadhouse

Squadhouse connects a Next.js 16 customer platform, AI-assisted service delivery, and an internal CRM with a WhatsApp bridge and shared Supabase data contract.

“Connect the public platform, AI-assisted service delivery, and the internal lead operation as one product system.”

product and operational engineering

decisions.md (squadhouse)

# challenge, architectural choices, and technical outcomes

focus platform · web

context: web

Build the customer-facing product on Next.js 16.

I worked across the public experience and service flows using the App Router, React 19, Tailwind, motion, transactional email, and a tested component layer. The platform presents the product while supporting the operational path behind each lead.

focus agents · six roles

context: six roles

Build scoped agents for the operating workflow.

Six Claude Code agents cover bounded stages of lead research, qualification, proposal production, and follow-up preparation. Deterministic scripts validate the parts a model should not improvise, and every agent stops before contacting a person: outreach remains a human action.

focus evaluation · 19 checks

context: 19 checks

Test risky agent behavior like product code.

The proposal agent has a 19-assertion eval suite across rich and sparse source-material cases. The checks emphasize harmful overreach: no invented claims, no wrong-business assets, no unexpected routes, declared image provenance, and a buildable result.

focus migration · cutover

context: cutover

Make the source-of-truth change explicit.

I built migration and validation scripts for moving leads and dossiers from GitHub issues into Supabase. Phone reconciliation runs before WhatsApp pairing because phone numbers link messages to leads; backups and history checks are explicit cutover steps.

selected architecture · 1 deep dive

role / challenge / choices / outcomes

A Next.js customer experience connected to lead intake, AI-assisted delivery, and a WhatsApp-aware internal board.

My contribution: Full-product architecture and implementation across the public web experience, service flows, CRM, messaging integration, and migration runbook.

product

Platform

CRM board

Platform walkthrough

technical outcomes

scoped agents

agent eval assertions

CRM workspaces

human

outreach gate

explore the product → Squadhouse

retrospective.md

This work made operational details part of the product architecture. Lead identity, message history, migration order, backups, and the human workflow in the CRM determine whether the whole system is dependable.

open product →