원문: https://github.com/facebook/astryx/wiki/Hardening-Audit-Guide · 번역 기준: 2026-09-03

디자이너가 눈으로 컴포넌트를 리뷰하고, 발견한 것을 누군가 실행에 옮길 수 있는 이슈로 바꾸는 방법입니다.

이 페이지는 디자이너의 워크플로우와 이슈 포맷을 소유합니다. 기준 자체는 소유하지 않습니다 — "올바름"이 무엇인지는 Design Conventions이고, 발견 사항이 어떻게 등급 매겨지고 점수화되는지는 Component Audit Rubric입니다.

이 페이지가 작성된 계기였던 2026년 3월 pre-release sweep은 끝났습니다. 아래 워크플로우는 컴포넌트의 design-quality pass에 여전히 사용하는 워크플로우입니다. 원래 담고 있던 tracker 문서와 목표 일자는 사라졌습니다.

Getting Started

audit을 시작하기 전에, 여러분의 Navi에게 이것을 붙여넣으세요:

Read the hardening audit guide and follow it when I ask you to file issues: https://github.com/facebook/astryx/wiki/Hardening-Audit-Guide

How to Review

1. Storybook에서 컴포넌트를 열고, 출시된 모든 상태를 하나씩 살펴봅니다 — rest, hover, focus, pressed, disabled, loading, 각 status, selected, empty, long text — light와 dark 모두에서.
2. 보이는 것을 Design Conventions, 특히 §Consistent State Representations에 비추어 판단합니다: 상태는 승인된 표현 방식 중 하나를 사용해야 하며, 새로운 발명이어서는 안 됩니다.
3. 잘못 보이는 모든 것에 대해 스크린샷과 함께 이슈를 제출합니다.

스크린샷을 첨부하세요. 근거 이미지 없는 비주얼 발견 사항은 리뷰할 수 없으며, 같은 스크린샷이 있어야 Component Audit Rubric §5b가 채점 가능해집니다.

소요 시간 추정: 컴포넌트당 약 20-30분, 배정된 그룹 전체로는 약 3-4시간.

Filing Issues

Using Navi

무엇이 잘못되었는지 Navi에게 말하세요. 컴포넌트 이름과, 보이는 것 vs 기대하는 것을 포함하세요.

예시: