gsp-project-review

Validates codebase implementation against design intent using BUILD-LOG.md and git diff.

49|4|Updated Feb 20, 2026
One-click install
npx skills add https://github.com/jubscodes/get-shit-pretty --skill gsp-project-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsp-project-review
Source: https://github.com/jubscodes/get-shit-pretty/tree/main/gsp/skills/gsp-project-review
Command: npx skills add https://github.com/jubscodes/get-shit-pretty --skill gsp-project-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured QA review that validates the actual codebase implementation against design intent, surfacing mismatches between design artifacts and what was built so teams can decide if a build is shippable or needs revision.

Core Features & Use Cases

  • Cross-reference build claims and reality: Reads BUILD-LOG.md and runs git diff to confirm which files were actually changed and whether the build produced the claimed artifacts.
  • Design and brand alignment: Loads project design chunks and brand pattern files to verify token usage, component coverage, and imagery style against the brand system.
  • Accessibility and quality checks: Performs token audits, Grep/Glob searches for hardcoded values, accessibility checks (or references prior audits), and writes an acceptance report plus actionable issues.
  • Automated reviewer spawn: Spawns a gsp-project-reviewer agent with an included methodology to write acceptance-report.md, issues.md, and an INDEX.md into the project's review directory.

Quick Start

Run the gsp-project-review skill to generate an acceptance report and issue list by validating the project's BUILD-LOG.md, design chunks, and git diff against the codebase.

Frequently Asked Questions about gsp-project-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate my codebase against design intent to find frontend mismatches?

To validate codebase implementation against design intent, cross-reference your BUILD-LOG.md claims and git diff with project design chunks. This surfaces mismatches between design artifacts and built components so teams can decide if a build is shippable or needs revision.

What is a design system QA review for front-end engineering projects?

A design system QA review verifies token usage, component coverage, and imagery style against brand pattern files. It performs token audits and searches for hardcoded values to ensure the actual codebase implementation aligns with the established brand system.

How do I check for hardcoded values and verify accessibility in a design system?

To check for hardcoded values and verify accessibility, run Grep and Glob searches across the codebase and reference prior audits. This identifies skipped design tokens and accessibility issues, producing an actionable issues list for remediation.

Can I automate a design review process using git diff and a BUILD-LOG.md file?

Yes, you can automate the design review process by spawning a reviewer agent that reads BUILD-LOG.md and runs git diff. The agent applies a structured methodology to verify changed files and generate acceptance reports without manual intervention.

What deliverables do I get from a codebase design alignment review?

From a codebase design alignment review, you get an acceptance-report.md, an issues.md file, and an INDEX.md written to your project's review directory. These deliverables document coverage checks, accessibility status, and actionable mismatches.

How do I cross-reference build claims with actual git changes in a project?

To cross-reference build claims with actual git changes, read the BUILD-LOG.md file and execute a git diff. This confirms which files were actually changed and whether the build produced the artifacts claimed by the developer.