speckit-brutalreview

What problem does it solve?

This Skill conducts a rigorous, end-to-end audit that surfaces critical code, UX, security, performance, and product strategy issues with concrete, file-referenced findings and prioritized remediation steps.

Core Features & Use Cases

• Automated project scanning: Detects project type, file statistics, and tech stack to tailor the review scope.
• Live app auditing: Guides starting dev servers, exercising core flows, responsive checks, accessibility quick-checks, and captures annotated screenshots.
• Codebase dissection & security analysis: Produces file-and-line-referenced findings for architecture, code quality, security vulnerabilities, performance bottlenecks, and testing gaps.
• Report generation: Creates a dated markdown review with embedded screenshots and a structured appendix for follow-up work.
• Use Case: A maintainer preparing for a production release who needs a prioritized, evidence-backed list of fixes and product recommendations.

Quick Start

Run the brutalreview skill on the repository to generate a dated markdown review in .specify/reviews and save screenshots to .specify/reviews/screenshots/.