polish

仕上げ

許可された対象と範囲内でのみ調整を行ってください。

仕上げは改善であり、気付かれないようにデザインを変更することではありません。既存のビジュアル表現、コンテンツ、動作、および範囲外のすべてを維持してください。コンセプト自体が誤っている場合は、その旨を伝え、変更をこっそり持ち込むのではなく、再設計または bolder を推奨してください。

検出結果は欠陥を示す証拠であり、品質の証明ではありません。実際に描画された画面と、実際の操作経路を確認してください。

1. システムを把握する

DESIGN.md と、代表的なデザイントークン、共有コンポーネント、パターン、隣接するフローを確認してください。正式なシステムがない場合は、プロジェクト内の一貫した規約に従ってください。

修正する前に、乖離を次のように分類してください。

• トークン不足： システムに再利用可能な値が必要です。
• 単独実装： 既存の共有コンポーネントまたはパターンに置き換えるべきです。
• コンセプトの不一致： フロー、情報アーキテクチャ、または階層が、比較対象となる製品領域と異なっています。
• 局所的な欠陥： 実装が単に未完成、または一貫していません。

原因を、正しい範囲の中で最も限定的なレベルで修正してください。拘束力のあるシステム原則を推測できない場合は、確認してください。

2. 証拠を集める

代表的な画面サイズで、実際に機能を使ってください。Web の場合はデスクトップとモバイル、ネイティブプラットフォーム（ios／android／adaptive）の場合は、プロジェクトでサポートされている検証ツールを使い、シミュレーター、エミュレーター、または実機で、リリース対象のデバイスクラスを確認してください。次の点を判断してください。

• 操作経路が機能的に完成しているか
• 期待される品質基準と、利用できる時間
• 既知の制約や、意図的に未完成としている作業
• ユーザーが実際に遭遇する状態、コンテンツの長さ、役割、入力方法

過去のレビューがある場合は、その指摘を使う前に、対象と評価されたリビジョンを確認してください。古い指摘は再確認すべき手がかりであり、現在の欠陥一覧ではありません。いずれの場合も、独自に確認してください。

3. 優先順位を付ける

機能上の欠陥と見た目の欠陥を分け、次の順に修正してください。

1. 操作の破損や阻害、データ損失、誤解を招く状態、アクセシビリティを損なう操作経路
2. 読み込み中、空、エラー、成功、無効、権限に関する状態の欠落
3. フロー、階層、レスポンシブ対応、デザインシステムとの乖離
4. 見た目やモーションの不整合
5. コードやアセットの整理

一部分だけを完璧にし、他の部分を同じ品質基準より低いままにしないでください。

4. 操作経路全体を仕上げる

フローと階層

• 隣接する機能のメンタルモデル、用語、開示方法、ルーティング、保存動作、楽観的または悲観的なパターンに合わせてください。
• すべての要素を同じ強さにせず、主要なタスクと現在の状態が明確に分かるようにしてください。
• 初期表示、画面遷移、空の状態、復旧経路がつながり、個別の画面として孤立しないようにしてください。

レイアウトと文字

• プロジェクトのグリッドと間隔のスケールに合わせ、数値上だけでなく視覚上の配置も整えてください。
• 関連するコンテンツは密にまとめ、異なるグループ間には十分な余白を設けてください。
• 同じ役割の文字スタイルは一貫させ、文字数、折り返し、ローカライズによる拡張、ズーム、フォントの読み込みを検証してください。
• 現在のスクリーンショットだけでなく、サポート対象のすべてのビューポートを確認してください。

色、画像、アイコン

• セマンティックトークンを使用し、テーマ間で色の意味を安定させてください。
• すべての状態で、テキスト、コントロール、フォーカスのコントラストを確認してください。
• アイコンのファミリー、線の太さ、サイズ、視覚的な位置合わせに一貫性を持たせてください。
• 画像によるレイアウトシフトを防ぎ、正しいアスペクト比、レスポンシブ対応の画像ソース、役に立つ代替テキストを使用してください。

インタラクションと状態

• すべてのコントロールに、適切なデフォルト、ホバー、フォーカス、アクティブ、無効、読み込み中、エラー、成功時の動作を用意してください。
• キーボードフォーカスを視認できる状態に保ち、論理的なタブ順序、ラベル、プラットフォームに適したタッチターゲットを確保してください。
• モーションに一貫性を持たせ、中断可能かつ高いパフォーマンスを保ってください。仕上げを目立たせるためだけにアニメーションを追加しないでください。
• 製品で起こり得る場合は、長いコンテンツ、コンテンツの欠落、ローカライズ済みコンテンツ、オフライン、低速、権限が制限された状況を検証してください。

コンテンツとコード

• 用語、表記、句読点、事実に関する記述の一貫性を保ちます。主張を変更する前に確認してください。
• デバッグ出力、デッドコード、未使用のインポート、古いスタイル、仕上げの過程で生じた重複を削除します。
• システムがパターンを管理している場合は、独自の実装を共有コンポーネントに置き換えます。
• 真に再利用可能な値はトークンに昇格させます。ローカルの例外を1つ処理するためだけに、システムの抽象化を作成しないでください。

5. 検証して仕上げる

マウス、キーボード、必要に応じてタッチを使い、経路全体をもう一度確認します。次の点を確認してください。

• Web ではモバイル、中間、ワイドの各レイアウト、ネイティブでは両方の対応する向きにおけるスマートフォンとタブレットのサイズクラス。
• 読み込み中、空、エラー、成功、無効、長いコンテンツ、コンテンツ欠落の各状態。
• ズーム、コントラスト、フォーカス、セマンティクス、スクリーンリーダー向けの名前。
• あらゆる環境でのコンソールエラー、レイアウトシフト、操作のレイテンシー、画像の読み込み。Web では対応ブラウザー、ネイティブでは対応 OS バージョン、実行時の警告、フレーム落ち。
• DESIGN.md、周辺機能、ユーザーのスコープとの整合性。

プロジェクトに関連する QA コマンドを、許可された検証ホストで実行します。 スキャンで問題が見つからなくても、目視による判断の代わりにはなりません。

最後にソースの差分を確認し、意図しない変更、孤立したコード、冗長な値、一時的な成果物を取り除きます。機能が完全に実装され、経路全体で一貫して仕上がった場合にのみリリースしてください。