Skip to content

refactor: 古い参照・重複・使われていないコードを整理する - #28

Merged
tkc310 merged 5 commits into
mainfrom
refactor/remove-slop
Oct 24, 2026
Merged

tkc310 merged 5 commits into
mainfrom
refactor/remove-slop

Conversation

@tkc310

@tkc310 tkc310 commented Oct 23, 2026

Copy link
Copy Markdown
Owner

変更内容

#26 → #27 の後にマージしてください。 このブランチは #27 の上に作っています(同じファイルを触るため)。先の 2 つがマージされるまでは、差分にそれらのコミットも出ます。

全体を見直し、古い参照・矛盾・重複・使われていないコードを整理しました。振る舞いと見た目は変えていません。

古い参照・矛盾

  • 存在しない make ターゲット(check:contrast)、ds-improve のトークンと contrast.rules.json のパス、factory.md の README の節名、ワークフローのコメント(pnpm storybook:preview・pnpm release:* → make、手順の置き場所)、publish-preview.ts の使い方
  • DESIGN.md の「作業前に必ず読むもの」が全文を読む指示で、AGENTS.md・docs/skills.md の「必要な節だけ」と食い違っていた(古いパスも)→ ds-build-ui の読み方を指すように
  • DESIGN.md の 'use client' の対象が古いケバブケースの名前で手書きされていた → ルールブック 04 へ
  • トークンを変えた後の手順が 6 か所で別々に書かれていた → make generate に統一

削除

  • Makefile と重複していた pnpm スクリプト(storybook:preview・factory:create・release:version・release:publish・preview:publish)と、create.mjs でそれを消すだけの処理
  • design-review に混ざっていたコードレビューの項目と Next.js 専用の項目(「next/link を使っているか」など)。画面デザインのレビューに限りました。「提案だけ行い修正はしない」は残しています
  • 使われていない関数(dimensionToString・relFromRepo・srcDir・oklchToHex・Layout)と、内部でしか使わない export

重複を正本へのリンクに

  • DESIGN.md の共通規約 ↔ ルールブック 04、ファイル構成のツリー(COMPONENT_STRUCTURE.md だけに)、06 章「AI エージェントが回す場合」↔ ds-improve、factory.md の流れと設定例 ↔ ds-factory、make check の説明
  • トークンの CSS 化の規則(rem 変換・影・時間・字間・テーマのセレクタ)を packages/tokens/scripts/lib/css.ts に集め、build.ts とスライドで共有。スライドのトークン CSS は、影の色の書き方が tokens.css と同じ rgb(… / …) になっただけで、ほかは変更前と一致することを確認

小さな修正

  • create.mjs: lstat の二重呼び出しをやめ、--force で既にあるシンボリックリンクがあっても落ちないように(生成と --force の上書きを実行して確認)
  • make clean でスライドの出力(dist/)も消す

Storybook プレビュー

なし(コンポーネントとトークンの値は変更なし)

完了の定義

  • PR のタイトルが Conventional Commits の形式
  • make check と make test が通る(CI で確認。build.ts は手元で Style Dictionary を入れられず未実行)
  • changeset を追加した(利用者に影響が無いため不要)
  • ライト / ダークの両方で見た目を確認した(スライドの見本を再描画して確認)
  • キーボードで操作でき、フォーカス表示が見える(該当なし)
  • 新しい semantic カラーを足した場合 → 追加なし
  • 値や方針を変えた場合、docs/decisions/ に ADR を足した(方針の変更なし)

改善ループ

  • docs/improvement/log.md に 1 行追記した
  • 再発防止として追加したもの: 変換の規則を 1 か所(lib/css.ts)にまとめ、重複していた手順を正本だけに置いた

Generated by Claude Code

tkc310 and others added 5 commits October 23, 2026 11:25
原則「削る」に、部品を組み合わせたページで適用するルールを追加した。

- 必須: 見出し・配置・まとまりで伝わることを、小見出し・補助ラベル・説明文で繰り返さない
- 必須: 項目どうしの関係(グループ・主従)はレイアウトで示し、説明文で補わない
- 必須: 削るのは重複した表示だけ。入力欄の見えるラベル(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
…8341/design-md を追加

- レジストリ item `design-md`: リポジトリ直下に DESIGN.md、docs/design-principles/ に原則の全文を置く
- プロダクト用 DESIGN.md(templates/PRODUCT-DESIGN.md)を、コードから読み取れない考え方だけの構成に書き直した(プロダクトの前提・画面領域ごとの方向性・大事にすること・外した必須)。トークンや部品の一覧は載せない
- 原則の要約(判断の順序・ルールの強さ・方向性と各原則の必須)は scripts/sync-product-design.ts が docs/design-principles から生成し、make check で鮮度を検査
- build-registry-css.ts を build-registry-assets.ts に改名し、DESIGN.md と原則(ファクトリーの部分を除く)も registry-assets/ に作る
- README のクイックスタート、ds-build-ui、DESIGN.md、ルールブック 01、design-principles/README を更新。ADR-0019、changeset、改善ログ

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Yb44feYKDNj2ukQeT2j8Ks
- 古い参照を修正: 存在しない make ターゲット(check:contrast)、ds-improve のトークンと contrast.rules.json のパス、factory.md の README の節名、ワークフローのコメント(pnpm → make、手順の置き場所)、publish-preview.ts の使い方
- トークンを変えた後の手順を make generate に統一(CONTRIBUTING・03・06・operations・ds-improve・ds-factory)
- Makefile と重複していた pnpm スクリプト(storybook:preview・factory:create・release:*・preview:publish)と、create.mjs のその削除処理を外した
- design-review から、コードレビュー・Next.js 専用の項目を外した(画面デザインのレビューに限る)
- DESIGN.md の「作業前に必ず読むもの」(全文を読む指示・古いパス)と、古い名前の 'use client' の一覧を直した
- 重複を正本へのリンクに: DESIGN.md の共通規約とルールブック 04、ファイル構成のツリー(COMPONENT_STRUCTURE.md)、06 章と ds-improve、factory.md と ds-factory、make check の説明
- トークンの CSS 化の規則を packages/tokens/scripts/lib/css.ts に集め、build.ts とスライドで共有。build.ts の cssVar も cssVarName を使う
- 使われていない関数(dimensionToString・relFromRepo・srcDir・oklchToHex・Layout)と、内部でしか使わない export を削除
- create.mjs: lstat の二重呼び出しをやめ、--force で既にあるシンボリックリンクがあっても落ちないようにした
- make clean でスライドの出力(dist/)も消す

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Yb44feYKDNj2ukQeT2j8Ks
# Conflicts:
#	docs/improvement/log.md
#	package.json
@tkc310
tkc310 merged commit 9a1a6e7 into main Oct 24, 2026
3 checks passed
@tkc310
tkc310 deleted the refactor/remove-slop branch October 24, 2026 02:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant