โœฆ v0.1.0 โ€” Open Source ยท MIT

Ship Working Code.
Every Time.

Maestro is an AI build verification tool that runs a 14-point Guardian pipeline on your code. Catches bugs Cursor, Claude Code, and Copilot miss. Auto-fixes what it can. Guarantees output works before delivery.

$ pip install maestro-guard && maestro-guard check index.html
๐Ÿ“ Spec โ†’ ๐Ÿ—๏ธ Build โ†’ ๐Ÿ›ก๏ธ Guardian (14 Checks) โ†’ ๐Ÿ”ง Auto-fix โ†’ โœ… Verified
maestro-guard check index.html
$ maestro-guard check index.html
โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
Maestro Guardian โ€” 14-point check
โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
โœ“ JS Syntax Check
โœ“ DOM Reference Validation
โœ“ Console Error Detection
โœ“ Inline XSS Vector Scan
โœ“ HTML Validation
โœ“ CSS Selector Integrity
โœ— Spec Fulfillment: concept drift detected
โš  Auto-fix applied: MOCK_DATA โ†’ real template
โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
Score: 78/100 ยท Verdict: PASS (with fixes)
โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
14
Guardian Checks
85
Tests Passing
7
Bug Patterns Auto-Fixed
5
Review Perspectives

What Maestro Catches

AI coding tools generate great code โ€” but they also generate silent, subtle bugs. Maestro finds them before they reach production.

๐Ÿ”

Broken DOM References

Catches IDs, classes, and selectors referenced in JS but missing from HTML. The #1 hidden bug in AI-generated UIs.

๐Ÿ•ต๏ธ

Console Errors in Production

Detects leftover console.errors, debug logs, and dev-only code that LLMs leave behind. Blocks them from shipping.

๐Ÿ›ก๏ธ

XSS & Security Vectors

Flags inline event handlers, innerHTML usage, and missing CSP headers โ€” the most common AI-generated security gaps.

๐Ÿ“

Spec Fulfillment Gate

LLM-powered verifier reads your original spec and checks if the output actually implements what was asked โ€” not just "does it compile?"

๐Ÿ”ง

Auto-Fix Pipeline

15+ bug patterns auto-detected and fixed: MOCK_DATA left in production, template literals broken, e.target_N patterns, and more.

๐Ÿ‘๏ธ

5-Perspective Code Review

Each build is reviewed by 5 AI agents: Security, UX, Code Quality, SEO, and Business Viability โ€” with heuristic fallback when LLMs are unavailable.

How It Works

Three commands. One pipeline. Zero guesswork.

1

Write Your Spec

Define what you want to build in a simple markdown spec. Maestro uses it as ground truth for verification.

2

Build With Any AI Tool

Use Cursor, Claude Code, Copilot, or Codex โ€” whatever generates the best code for you. Maestro is tool-agnostic.

3

Guardian Verifies

Run maestro-guard check โ€” 14 checks, auto-fixes, and spec fulfillment gate. Pass or don't ship.

The Guardian Pipeline

Every check must pass at 100/100 or delivery is blocked. Here's what runs on every file:

14 Checks Across 5 Dimensions

โœ“ JS Syntax Validation
โœ“ DOM Reference Integrity
โœ“ Console Error Detection
โœ“ Inline Event Handler Scan
โœ“ HTML Semantic Structure
โœ“ CSS Selector Validation
โœ“ Server Response Validation
โœ“ Content-Security-Policy
โœ“ Magic Number Detection
โœ“ Truncation Detection
โœ“ Comment Density Analysis
โœ“ Loading State Detection
โœ“ Accessibility Check
โœ“ Spec Fulfillment Gate

Open Source. MIT. Zero Dependencies.

Maestro Guard weighs nothing. Pure Python stdlib. No npm, no Docker, no cloud service. Drop it in any CI/CD pipeline.

View on GitHub โ†’

Stop Shipping Broken AI Code

Maestro catches what your AI coding tool misses. One command. Every build. Guaranteed.

๐Ÿ“ฆ Install Maestro โ†’

pip install maestro-guard ยท Open Source ยท MIT