design-review-solo

What problem does it solve?

This Skill provides a streamlined way to conduct direct design reviews, ideal for single-agent scenarios, eliminating the need for subagents and ensuring a focused evaluation of design artifacts and code.

Core Features & Use Cases

• Direct Review: Offers a direct and inline design review without the use of subagents.
• Effective Diff Resolution: Automatically resolves the scope and effective diff from the current context, including remote default branch changes and staged, unstaged, and untracked files.
• Real Context Review: Delivers an in-depth review by grounding the analysis in the actual design artifacts, code context, and surrounding system documentation.
• Structured Review Passes: Facilitates a structured review with four specific passes to cover boundaries, domain invariants, evolution, and simplicity in design.
• Candidate Issue Validation: Validates every potential issue with concrete evidence, ensuring a grounded and evidence-based review.
• Comprehensive Reporting: Reports all issues, including severity, location, and architectural judgments, maintaining a concise and clear documentation of the review.
• Use Case: Use this Skill when reviewing design artifacts such as software architecture proposals, API boundaries, or design-sensitive code diffs to ensure adherence to best practices and standards.

Quick Start

Run a design review for the 'system-architecture.pdf' file directly within this session without invoking subagents.