⚙️ Vault運用

2026-07-23_作業ログ

最終更新 2026年07月23日 ／ 90_Meta/Claude作業ログ/2026-07-23_作業ログ.md

作業ログ 2026-07-23

14:31 - /handoff 実行（全テーマ）

このセッションで扱ったテーマ（全部）

  1. mikke! の残作業引き継ぎ〜完成 — システム作業 — 完了・ver168 本番反映済み
  2. mikke! の撮影ツール根治（メニュー写り込み／PC・SP別FV／文字重なり） — システム作業 — 完了・採用ゲート新設
  3. mikke! の色判定（ベース／アクセント）作り直し — システム作業 — 完了・17件修正
  4. TERASU Lab を mikke デザインへ全面刷新 — システム作業 — プレビュー進行中・本番未反映
  5. Lab と mikke の違い・使い分けの認識合わせ — 相談 — 結論あり

テーマ別の詳細

1. mikke! の残作業引き継ぎ〜完成（ver164〜168）

背景: セッション開始時、smilebaton の撮り直し3枚と調査スクリプトが未コミットで残っていた。

やったこと（本番反映済み）
- ver164: 詳細ページの「← 一覧にもどる」が href="/" 固定で絞り込みが落ちる件を根治／ページの種類で絞った時のサムネ見切れ（4:3枠に915x635をcoverで入れて左右27px切れ）を contain で解消
- ver165: 採用ゲート新設・メニュー写り込み根治・PC/SP別FV根治・チップの :visited 色
- ver166: 絞り込みで先頭へ戻る／色ドットをリンク化／フッターCONTACT US中央／fondeskの重なり根治／下層発掘の階層限定／色17件修正
- ver167: fondesk の一覧サムネを詳細FVから作り直し
- ver168: 絞り込みのスクロールバー非表示（機能は維持）

現在地: ~/dev/lab-terasu / 本番 https://mikke.scale-group.co.jp/ = ver168。大串「これでMikke完成！！」

2. 撮影ツールの根治（今日いちばん重い作業）

根治した3つ
- メニュー写り込み: 犯人は <ul id="Menu-Group">（fixed・opacity:0・リンク15本）。reveal の正規表現が megamenu 等しか見ておらず素通り。→ 名前ではなく構造で判定（浮いていてリンク3本以上の透明要素は畳まれたメニュー）。全902ページ走査→12サイト94枚撮り直し
- PC/SPで別のFV: 「アクティブなスライドを撮る」方式が原因。PCとSPは読み込みの進み方が違うので必ずズレる。→ 必ず1枚目を撮る。器の判定も名前でなく「子が同じ位置に積み重なっているか」
- fondeskの文字重なり: ul.tp-Mv_List > li.tp-Mv_ItemNN。同じクラスが同じ位置に複数見えているものを1つに絞る処理を追加（キーに大きさを入れない＝文字数差で高さが288/283/260と変わり素通りしていた）

** 採用ゲート（大串承認・恒久）
「壊れないツール」ではなく崩れた画像を保存しない**方式へ転換。撮影直前に実ページを検査し ①リンク5本以上の浮いたパネルが見えている ②同じ位置に可視のテキスト/画像が重なっている を検出したら保存しない。

新設ツール: tools/shot_common.mjs（共通前処理）／tools/scan_menu_leak.mjs（全ページ走査）

** 失敗の記録（正直な反省）: 修正→別の崩れ を計4回出した（ヘッダー消失／FV単色化／全面白飛び／メニュー展開）。いずれも機械判定で検出し元画像に復元、本番には出していない。サムネ撮影ツール(shoot_mikke.mjs)への共通処理適用は3回失敗して差し戻し**＝fondeskだけ詳細FVをサムネに流用するルールにした。

3. 色判定の作り直し

  • 旧 audit_colors.py はサムネURLの ?v= をパスから落とし忘れて FileNotFoundError＝「色は必ず機械監査を通す」ルールが実質機能していなかった（修正済み）
  • 直しても、ピクセル方式は写真の色とデザインの色を区別できず169件中136件が要確認＝使えない（Will Style は空の写真で blue 98%、でも実際は白基調で登録は正しい）
  • → DOM方式を新設（tools/audit_colors_dom.mjs＝画面の各点で実際に見えている背景色を読む）。これも「FV全体が画像だと下地の色しか残らない」外し方がある
  • → 外し方の性質が真逆な2方式が同じ色を指した時だけ信用する（tools/audit_colors_final.py）。136件→17件に絞り込み、9件はベース色修正、8件はベース/アクセント入れ替え

4. TERASU Lab を mikke デザインへ全面刷新（進行中）

プレビュー: https://lab-v2.lab-terasu.pages.dev/ ／ 本番 lab.terasu.scale-group.co.jp は一切触っていない

作り: build_lab.py を新設し、build_mikke.py を import して同じ部品を共有（見た目のコピーではない＝片方だけ直る事故を構造的に防ぐ）

大串の決定事項
- タブは「参考HP」「セクション」の2本だけ。タブUIは mikke の .mk-tabs（画面いっぱい・等分割）を使う
- サムネが無いもの（用語集等）はリスト表示のまま・トンマナだけ合わせる
- 作りは生成方式に寄せる
- 参考パーツ集／動き／推しページは入れない（使っていない）
- フォント図鑑・配色は mikke へ飛ばさず Lab にコピーして作る
- 運営会社・お問い合わせ・フッターCTAは削除（内部向けには不要）
- 制作実績は https://terasu.scale-group.co.jp/works/ へ飛ばす
- お気に入りは「探す」から出して探すの左に配置
- 追加者は さき／大串／細川 の3名だけ（旧「制作部署」→「さき」に改名。migrated・claude は廃止し79件を大串へ統一）
- セクションの分類は大串指定の30分類（ヘッダー／FV／悩み・課題解決／…／背景画像コンテンツ）
- 絞り込みの並び: 参考HP＝アクセントカラーの直下に追加者・追加日／セクション＝追加者・追加日・分類（性質は削除）
- セクション詳細のプレビュー表示はE案（デバイス幅切替）を採用（6案を実物で比較して選定）
- 編集は案A＝チップは絞り込みリンクをやめ、その場で編集できるプルダウンにする

入っているもの: 参考HP169件＋詳細169ページ／セクション95件＋詳細95ページ（プレビュー＋実装コード＋コピー）／配色・フォント（mikkeと同一）／用語集138／コマンド集5／CTA65／レイアウト40

** 未解決（次の一歩）
- セクション詳細のデバイス幅切替が効かない。ボタンの選択状態は変わり width:390px !important も入るが計算後の幅が変わらない。テンプレCSSとの噛み合いが未特定
- サイト上での直接編集機能（案A）が未着手。設計は合意済み＝①worker の /api/contributors を拡張してKVに保存 ②チップにホバーでプルダウン→即保存→全員に反映 ③一覧の絞り込みはKVを読んでから判定 ④KVからJSONへ書き戻すコマンド**を作ってデータを1つに揃える（大串は「KV＋書き戻し」を選択）

5. Lab と mikke の使い分け（相談・結論）

TERASU Lab mikke!
誰が見る 社内・制作担当 社外の一般
目的 制作を速くする道具箱 集客・ブランド
単位 素材がバラバラ（10種の引き出し） サイト1件
使い方 引きに行く 眺めて探す

Lab は同じリポ（lab-terasu）に同居。Lab→mikke の自動同期は 2026-07-17 に廃止済み。

このセッション全体の大串FB（重要なやつ全部）

  • 「写真の取り方、取るタイミング変えないとこの問題はずっと治らない」 → 撮影は必ず1枚目・採用ゲートで担保、という方針転換の起点
  • 採用ゲートを承認（崩れた画像は保存しない）
  • 「どうしてもできないものは詳細ページと同じ撮り方にしてOK。でも他のサムネは変えたくない」 → FV流用は1サイト単位、一括置換は禁止
  • 「トンマナは全部mikkeに合わせたい」「超慎重にやっていきたい」
  • 「情報量がめっちゃ欲しい」（Labにはセクションの実コードが入るのがマスト）
  • 「プレビューとコードが超便利機能」
  • タブは「一時期4分割で画面いっぱいに横幅取ってたやつ」が好み
  • ロゴは背景透過・白ver/黒verで同じ大きさ・配置
  • 用語集の見づらさ（CSS未注入＋見出しが濃茶に化ける）を指摘 → デザイン刷新
  • 絞り込みを押したら結果の先頭へ戻る（下までスクロールしてから絞ると毎回いちばん下になる）
  • 色ドットも押したらその色で絞り込めるように
  • スタディサプリの下層0件は大串の見落とし（対応不要）

恒久ルール化したもの（/mikke コマンド更新済み・配布チェック PASS 6/6）

  • 撮影は必ず1枚目／器の判定は名前でなく構造／reveal後にもう一度1枚化
  • 同じタグ・同じクラスが同じ位置に複数見えていたら1つに絞る（キーに大きさを入れない）
  • 採用ゲート（崩れた画像は保存しない）
  • 下層発掘は登録URLの階層内に限定
  • 色監査は性質が真逆の2方式を突き合わせ、一致した時だけ信用する
  • サムネがどうしても撮れないサイトは詳細FVを流用してよい（1サイト単位・一括置換禁止）
  • 追加者はさき／大串／細川の3名だけ（migrated・claude は作らない）

20:02 - /handoff 実行（全テーマ）

このセッションで扱ったテーマ（全部）

  1. TERASU Lab の全面刷新 — システム作業 — 本番公開済み・継続改善中
  2. リポ分離（案B: core + Lab + mikke） — システム作業 — 完了・3リポ稼働
  3. 分類の直接編集（サイト上でチップから編集） — システム作業 — 完了
  4. セクションの命名規則とサムネ刷新 — システム作業 — 完了（97件書き換え・104件撮り直し）
  5. コマンド整備（/mikke /section /hp-flow） — システム作業 — 完了
  6. mikke! への越権デプロイと巻き戻し事故 — 事故対応 — 復旧済み・要共有
  7. 未決の選定（削除UI・レスポンシブ48件） — 相談 — 大串の判断待ち

テーマ別の詳細

1. TERASU Lab の全面刷新

本番 https://lab.terasu.scale-group.co.jp/ に公開済み（参考HP172件・セクション99件）。
- カードUI統一（参考HPとセクションを同一構造に）／フッター削除／ナビ整理
- 追加者・追加日を会社名の行の右端へ（はみ出し0件・実測）
- サムネのホバーで2択（サイトへ／詳細をみる）。矢印は削除
- 配色・アニメーション・レイアウトを左サイドバー絞り込みに統一
- 絞り込みを開閉式に（A案・▶→▼の90°回転）。色の14色グリッドも開閉対象
- 追加日に「新着」（7日以内）を新設。追加者は複数選択可
- セクション一覧: サムネ右下に再生ボタン（押すとその場で実物が動く）
- セクション詳細: 分類/参考元リンク/PC＋スマホ横並び/コード見やすさ。HP詳細と同寸（gap44px・戻る余白114px）を実測で一致
- favicon をテラキャラに（白背景を透過・顔の白は保持）／OGPをLab用に差し替え
- 文字選択の色・チップのvisited沈み・お気に入りの外すボタンを修正

2. リポ分離（案B）

  • scale-group-jp/terasu-web-core … 共通（build_mikke.py・テンプレ・参考HPデータ・撮影画像・tools）
  • scale-group-jp/terasu-lab … Lab本体（push で本番自動デプロイ）
  • scale-group-jp/mikke … mikke!（deploy_mikke.sh でデプロイ）
  • 旧 lab-terasu は自動デプロイ停止・参照用に残置
  • 生成物が分離前と1バイトも変わらないことをハッシュで検証してから切替
  • core が private のため CI に読み取りトークン(CORE_READ_TOKEN)を設定（Deploy keyは組織で無効）

3. 分類の直接編集

チップ・色ドット・追加者・追加日を押すとプルダウン（C案リスト型）が開き、選ぶと即KVへ保存→全員に反映。
- worker に /api/meta を新設（KVキー 'meta'）
- 一覧・詳細の両方で編集可（.lab-editable）
- tools/sync_meta.py で KV→正本JSON へ書き戻し
- 対象: 業種31/サイト種別8/雰囲気14/ベース色15/アクセント色2色まで/追加者3/追加日/セクション分類30

4. セクションの命名規則とサムネ

  • 命名規則を「分類｜会社名［：説明］」に統一。97件を書き換え（会社名はURLから機械収集）
  • add_section.py に --kinds 必須・URL注記の禁止・18字チェックを追加
  • サムネを shoot_section.mjs + normalize_thumbs.py に刷新（4:3・2倍・採用ゲート）。104件撮り直し
  • 詳細用PC画像(1440×1000)とスマホ画像を各103件撮影
  • tools/check_responsive.mjs を新設（PC/タブレット/スマホの3幅で検品）

5. コマンド整備

  • /mikke v3.0: リポ分離に追従（作業場所・ビルド・デプロイ・Lab反映の6-2を新設）
  • /section v2.0: 作業パスを terasu-lab へ全面修正＋命名規則＋サムネ刷新を反映
  • 両方に「起動時にコマンド定義を最新化＋現行ver表示」を追加（hp-flow と同じ設計）
  • /hp-flow v2.4: 流用ルートを撤廃（大串指示）
  • 配布チェック PASS 6/6（両コマンド）

6. 事故と復旧（要共有）

  • mikke! を ver174 として本番デプロイした（このセッションは Lab 専用だと分かる前）。mikke!セッションと衝突の可能性
  • 巻き戻し2回: ①ver169→168（他セッションの追加2件が消失→ver170で復旧）②追加者統一が未コミットで消失（52件+27件を再実施）
  • お気に入りページを一時的に全損（onerror属性内のクォートでJSが構文エラー）→修正済み
  • 絞り込みが空になる不具合（isOpen未定義）→修正済み
  • 対策: 生成物の全スクリプトを構文チェックしてからデプロイする運用に

このセッション全体の大串FB（重要なやつ全部）

  • 「Labだけ／mikkeだけ」が大半。共通(core)を触るのは「両方に」と言った時だけ。触る前に確認する
  • mikke! の修正は mikke セッション、Lab の修正は Lab セッション
  • 提案は歓迎、勝手な着手はNG。デザインは候補を実物で作って見せてから決める
  • 完了報告に「次は?[1][2][3]」を付けない
  • Lab は preview 免除＝直接prod OK（グローバル指示書の除外表に追記済み）