Repository navigation
docs(design-principles): 不要なセカンダリラベルや説明を避け、レイアウトに説明させるルールを追加 - #26
Merged
Merged
Conversation
原則「削る」に、部品を組み合わせたページで適用するルールを追加した。 - 必須: 見出し・配置・まとまりで伝わることを、小見出し・補助ラベル・説明文で繰り返さない - 必須: 項目どうしの関係(グループ・主従)はレイアウトで示し、説明文で補わない - 必須: 削るのは重複した表示だけ。入力欄の見えるラベル(WCAG 3.3.2)と構造(1.3.1)、アイコンだけの操作の名前は残す - 推奨: 補足文が要りそうなら、先に配置・見出し・ラベルの語を直す - 出典カタログ(ゲシュタルトの近接・共通地域)、ルールブック 01・05、DESIGN.md の Don't に反映 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Yb44feYKDNj2ukQeT2j8Ks
This was referenced Oct 23, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
変更内容
design-principles の原則「削る」に、部品を組み合わせたページで適用するルールを追加しました(既存の「削る」は「主タスクに不要な説明を置かない」までで、重複したラベルとレイアウトで伝える点は書かれていませんでした)。
必須
fieldset/legendや区画の見出しで名前を付ける推奨: 補足文が要りそうなら、先に配置・見出しの段・ラベルの語を直す。補足は形式や制約など見た目から分からないことに使う
あわせて、出典カタログ(ゲシュタルトの近接・共通地域の吸収先)、ルールブック 01(対応表)・05(
supportTextをラベルの言い換えに使わない)、DESIGN.md の Don't に反映しました。特化ルール(社内向けツールの「まれな手続きには説明を残す」など)とは、優先順位どおり特化ルールが勝つので矛盾しません。既存のストーリーの補足文はすべて制約・形式を伝えるもので、違反はありませんでした。Storybook プレビュー
なし(文書のみ)
完了の定義
make checkとmake testが通る(CI で確認)docs/decisions/に ADR を足した(原則の追記のみで不要)改善ループ
docs/improvement/log.mdに 1 行追記したGenerated by Claude Code