Skip to content
RHL AIArchitecture

Architecture

A 3-tier decoupled monorepo architecture unifying agent intelligence, developer CLI execution, and production automations.

MONOREPO TOPOLOGY

rhl-ai/
├── skills/                     # [TIER 1: INTELLIGENCE]
│   ├── code-reviewer/          # Declarative markdown skill schemas
│   ├── frontend-performance/   # Decision trees, evidence heuristics
│   └── pr-description-writer/  # PR templates, verification, visual evidence
├── packages/                   # [TIER 2: EXECUTION]
│   ├── cli/                    # @rhl-ai/cli binary (Commander + ESM)
│   ├── scaffold/               # @rhl-ai/scaffold template generator
│   ├── skills/                 # @rhl-ai/skills parser & validator
│   └── utils/                  # @rhl-ai/utils shared helpers
├── projects/                   # [TIER 3: AUTOMATION]
│   └── github-whatsapp-bot/    # create-github-whatsapp-notifier
└── apps/                       # [PRESENTATION]
    └── landing-page/           # Product site & documentation catalog
TIER 01

Intelligence Tier

Decoupled prompt schemas and behavioral heuristics.

Contains pure markdown and YAML frontmatter skill specifications. Separated from compiled code, portable across LLM agent executors, and carrying zero bundle overhead.

code-reviewerskills/code-reviewer/SKILL.md

Multi-axis code review heuristics and 3-tier severity classification.

frontend-performance-engineerskills/frontend-performance-engineer/SKILL.md

Core Web Vitals diagnostic loops, pattern selection, and evidence rules.

pr-description-writerskills/pr-description-writer/SKILL.md

Evidence-backed PR descriptions with real verification and annotated visual proof.

TIER 02

Execution Tier

Strict TypeScript CLI binary, package scaffolding, and utilities.

The core npm packages that power local development workflows. Built with native ESM, strict type checking, and Turborepo compilation caching.

@rhl-ai/clipackages/cli

Central command-line interface for skill management and application bootstrapping.

@rhl-ai/scaffoldpackages/scaffold

Template generator engine producing strict TypeScript project scaffolding.

@rhl-ai/skillspackages/skills

Monorepo skill discovery, parser, and validator logic.

@rhl-ai/utilspackages/utils

Shared logging, formatting, and file-system helpers.

TIER 03

Automations Tier

Webhook microservices and external notification bridges.

Autonomous integration services that bridge development events (GitHub PRs, CI failures, releases) to real-time developer communication channels.

create-github-whatsapp-notifierprojects/github-whatsapp-bot

Standalone webhook server dispatching GitHub event alerts to WhatsApp via Twilio.