Browse commands

/impeccable polish

Polish

Ретельний фінальний прохід між хорошим та відмінним.

Коли використовувати

/impeccable polish — це останнє, що ви запускаєте перед відправленням. Він вишукує дрібні деталі, що відокремлюють випущену функцію від відшліфованої: зміщення на півпікселя, нестабільні інтервали, забуті стани фокусу, переходи завантаження, що блимають, текст, що дрейфує в тоні. Він також узгоджує функцію з вашою дизайн-системою, замінюючи жорстко задані значення на токени, підмінюючи кастомні компоненти на спільні та виправляючи будь-який відхід від встановлених патернів.

Зверніться до нього, коли функція функціонально завершена, нічого не зламано, але щось все ще не те. Також зверніться до нього, коли функція відхилилася від дизайн-системи і її потрібно повернути в русло.

Як це працює

Polish починає з виявлення дизайн-системи (токени, шкала інтервалів, спільні компоненти), потім методично працює через шість вимірів:

  1. Візуальне вирівнювання та інтервали: дотримання сітки з точністю до пікселя, стабільна шкала інтервалів, оптичне вирівнювання іконок.
  2. Типографіка: стабільність ієрархії, довжина рядків, вдови та сироти, кернінг заголовків.
  3. Колір та контраст: використання токенів, паритет тем, співвідношення WCAG, індикатори фокусу.
  4. Стани взаємодії: hover, focus, active, disabled, loading, error, success. Кожен стан врахований.
  5. Переходи та рух: плавне easing, без збоїв макета, повага до prefers-reduced-motion.
  6. Текст: стабільний голос, правильний час, без рядків-заглушок, без випадкових TODO.

Навичка чітка в одному: polish — це останній крок, а не перший. Якщо функція не є функціонально завершеною, її полірування — марна трата часу.

Спробуйте

/impeccable polish the pricing page

Здоровий вигляд:

Visual alignment: fixed 3 off-grid elements (8px baseline)
Typography: tightened h1 kerning, fixed widow on testimonial
Interaction: added hover state on FAQ items, focus ring on email input
Motion: softened modal entrance, added reduced-motion fallback
Copy: removed one "Lorem ipsum" stray, aligned button voice

П’ять дрібних виправлень, без перезаписів. Це форма хорошого проходу полірування.

Підводні камені

  • Полірування незавершеної роботи. Якщо в коді є TODO, ви не готові. Запускайте /impeccable polish лише на завершених функціях.
  • Ставлення до polish як до редизайну. Polish вдосконалює існуюче. Якщо ви виявили, що переробляєте архітектуру макета, вам потрібен був /impeccable critique або /impeccable layout.
  • Запуск /impeccable polish без /impeccable audit спочатку. Polish ловить проблеми на основі відчуттів. Audit ловить вимірні. Використовуйте обидва.