FRONTEND.md

このファイルは、エージェントが予測不能にUIパターンを発明しないように、安定したフロントエンドの期待値を定義します。

UIの原則

• 新しさよりも明確さを最適化する。
• インタラクションフローを発見可能かつ再開可能に保つ。
• 一回限りのバリアントよりも、少数の再利用可能なコンポーネントを優先する。
• アクセシビリティチェックは仕上げ作業ではなく、通常の検証の一部である。

ガードレール

• デザインシステムまたはコンポーネントライブラリを docs/references/ に文書化する。
• 主要なユーザー向けの状態を記録する：空、読み込み中、成功、エラー、リトライ。
• コピー、キーボード動作、視覚的階層をフロー全体で一貫させる。
• UIバグを修正した場合、対応する検証ステップを追加または更新する。

検証の期待値

• 重要なユーザージャーニーの証拠をキャプチャする。
• ブラウザまたはランタイムの検証ステップを関連するプランに記録する。
• 視覚的リグレッションが頻発する場合、スクリーンショットまたはDOMチェックを標準化する。