gk-design-refine

What problem does it solve?

It removes the manual back-and-forth of polishing a UI design variant by turning refinement requirements into concrete updated artifacts, while keeping the design brief and GitHub workflow in sync.

Core Features & Use Cases

• Refine a single variant: Apply a chosen variant letter plus refinement requirements to generate refined.html and SUMMARY.md, then update the design brief.
• Refine all unprocessed decisions: Run a batch workflow that discovers design folders with DECISION.md and no refined.html/SUMMARY.md, refines them sequentially, and then performs the issue-linking/unblock pass after review.
• Unblock dependent work: Link refinements to the appropriate GitHub design issue and clear any “Design needed” gates once the user approves the refined artifacts.

Example use case: You’ve decided to accept variant B for a component and you have new refinements like updated empty states and status badges; you want those applied consistently across all required states and documented for implementation.

Quick Start

Use gk-design-refine with argument B plus your refinement requirements for the active design folder to generate refined.html and SUMMARY.md and update the design brief accordingly.