Building an AI Code Review CLI with Claude: A Non-Traditional Pathway

GrandCru is a code review CLI tool that was developed and shipped to npm by a former military officer with no formal computer science background. This tool provides technical feedback on code by employing a unique method that pairs structured data analysis with creative communication.

Key Details

• The tool is launched via the command grandcru review src/, delivering feedback from a playful French wine sommelier persona.
• It utilizes a dual-channel Zod schema; one channel handles strict data like issue type, severity, line number, and suggested fixes, while the other provides narrative feedback with 'sommelier remarks' on the code's quality.
• Claude AI facilitates structured outputs by using constrained decoding, ensuring consistency in the JSON format generated during code reviews.
• The Zod .describe() function on each field acts as a system prompt to maintain the personality of the feedback within the JSON structure, preventing what the creator calls 'JSON lobotomy'.
• GrandCru reviewed its own codebase, identifying critical issues such as missing input validation and unsanitized string interpolation, and rated its own quality with a whimsical score of 79/100, indicating that it 'needs decanting before service'.

This tool is particularly interesting for those exploring unconventional pathways into tech development, utilizing AI like Claude to rapidly generate, understand, and improve code structures.