Polish

Apply refinements only within the authorized target and scope.

Polish is refinement, never concealed redesign. Preserve the incumbent visual world, content, behavior, and everything outside scope. If the concept itself is wrong, say so and recommend redesign or bolder instead of smuggling in a replacement.

A detector result is defect evidence, not proof of quality. Inspect the rendered experience and real interaction path.

1. Establish the system

Read DESIGN.md and representative tokens, shared components, patterns, and neighboring flows. If no formal system exists, use coherent project conventions.

Classify each drift before fixing it:

• missing token: the system needs a reusable value;
• one-off implementation: an existing shared component or pattern should replace it;
• conceptual mismatch: the flow, information architecture, or hierarchy differs from comparable product areas;
• local defect: the implementation is simply incomplete or inconsistent.