When is the best time to use the Design Review skill?

It is best used when refining an existing v1 architecture document, incorporating new learnings from the implementation phase, or validating past decisions against new project context.

What structural principles does this skill enforce?

The skill applies several principles: it separates rejected paths into an appendix, removes non-architectural timelines, ensures features own their own data models, and purges undiscussed or auto-generated details.

Why does the skill require a fresh session for the final rewrite?

Starting a fresh session prevents context contamination and ensures the AI focuses purely on the original design and the validated changes document, leading to a cleaner and more accurate final version.

Why shouldn't I edit the document inline during the review?

Editing inline risks losing the original context and rationale. This skill enforces a separate 'Changes' document to ensure every modification is deliberate, documented, and reviewed before the final update.

Architectural Design Review

Name: Architectural Design Review
Author: alizain

byalizain

0•

협업 도구

Refines architecture and design documents through a systematic, section-by-section validation process that separates change documentation from final rewriting.

The Design Review skill provides a structured framework for auditing and updating technical documentation by enforcing a 'changes-first' workflow. It prevents the risks associated with inline editing and premature rewriting by guiding users through a comprehensive section-by-section analysis. By cross-checking existing designs against new implementation learnings or related documents, the skill helps maintain structural integrity through specific principles like separating rejected paths into appendices and ensuring feature-level data ownership. This methodical approach ensures that every change is backed by a recorded rationale before a final, clean rewrite is performed in a fresh session.

주요 기능

01Systematic section-by-section validation and cross-checking

02Architecture-specific structural principles and data ownership rules

03Separation of the review process from the rewrite phase

04Identification of red flags like auto-generated content and missing justifications

050 GitHub stars

06Structured 'Changes Document' creation with explicit rationale

사용 사례

01Refining version 1 of an architecture document into version 2 based on project feedback

02Incorporating real-world implementation learnings back into a design document

03Cross-checking a primary design against related technical specifications to ensure consistency

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add alizain/wizard-wheezes design-review

For use in Claude.ai and ChatGPT

Download Skill