Fork: 0
hasegawa / SmTIAS-Evaluation
Transfer to URL with SHA Find file
Newer
Older
SmTIAS-Evaluation / CLAUDE.md
@TIAS2301\user TIAS2301\user on 17 Aug 5 KB [update] MiniTias ローカル参照コピーを廃止し SmTIAS-Capture リポジトリの直接参照ルールを追加
Raw Blame History

SmTIAS-Evaluation

SmTIAS（定量撮影モード）の白板画像から照明均一性を評価するツール群．PNG / DNG(RAW_SENSOR) を入力に，CoV・max/min 比・中心周辺勾配・動径 min/max 比などの指標算出と可視化を行う．

開発進捗

最新: 後側ロフト w=0.5（従来）vs w=1.4 の実機評価を実施（TEST_05・compare_composite_vs_sum.py/compare_loft_housings.py 新規）．全灯均一性は従来同等以上（CoV 0.0695→0.0617，増光は暗部選択的 +13%）で TEST_10 シミュ予測を検証，全灯実測 ≈ 単灯加算（比 1.031）も確認．次は output/results 側の whiteboard 分離 ＋ 単灯バランス逆転（下>左>右）の要因切り分け ※ 本欄は最新ステップ 1 行のみ上書き更新．詳細な進捗履歴（動機・設計判断・失敗パターン）は docs/PROGRESS.md に追記する．運用ルールは GUIDE_05「進捗記録の運用ルール（CLAUDE.md / PROGRESS.md）」を参照．

必須ルール（コード実装時）

  • コーディング規約は GUIDE_06，テスト方針は GUIDE_08，エラーハンドリングは GUIDE_09 を参照

Git 運用（GUIDE_04 準拠）

  • ブランチ名: feature//fix//docs//chore/ + 英単語 2〜4 語（kebab-case）
  • コミットメッセージ: [add]/[update]/[fix]/[remove]/[clean] + 日本語
  • コミット・push 後は gh pr create で PR を作成する
  • /commit はユーザーが明示的に指示した時のみ実行する．Claude が自発的に /commit や git commit を呼んではならない（/implement 完了後も，案内するだけで自分ではコミットしない）
    • 例外: /auto-refactor（無人運転のリファクタ／ドキュメント整理ループ）はユーザー承認済みの例外として refactor/ 専用ブランチに自律コミットする．ただし push・PR・マージ・main への操作はしない（取り込みは人間が /commit push 等で行う）

エージェントチーム（GUIDE_05 準拠）

  • 実装は /implement <タスク> で開始する（コーディング → テスト → リファクタリング → ドキュメント更新）
  • Phase 1 後に人間が動作確認，Phase 2 でテスト失敗時のみ方針判断
  • Phase 2 成功後は Phase 3 → Phase 4 まで自動で進む（Phase 4 で更新がある場合のみ確認）
  • テスト・リファクタリングをスキップしない

手動確認が必要な作業（自分で完了させないこと）

以下は実装完了後にユーザーへ報告し，確認・実施を依頼すること．

  • 外部サービスの設定（コンソール操作，セキュリティルール変更等）
  • 実機・ブラウザでの動作確認
  • ストアへのアップロード・リリース作業

外部リポジトリ参照（SmTIAS-Capture）

SmTIAS 実機アプリ（旧称 MiniTIAS）の仕様・実装を参照する必要があるときは，GitHub リポジトリ https://github.com/rintoHasegawa/SmTIAS-Capture（private）を gh CLI（gh api / gh search code 等）で直接参照する（常に main の最新を見る）．以前あったローカルコピー MiniTias/ は廃止済みなので復活させない．広範囲のコード調査が必要になった場合のみ，scratchpad に一時クローンして検索し，終わったら削除する．

ドキュメント

設計・規約に関する情報は docs/ にある． コードを書く前に関連するファイルを読むこと．

01_GUIDE（規約・ルール）

  • プロジェクト立ち上げフロー: docs/01_GUIDE/GUIDE_01_プロジェクト立ち上げフロー.md
  • ドキュメント作成規約: docs/01_GUIDE/GUIDE_02_ドキュメント作成ガイド.md
  • ファイル命名規則: docs/01_GUIDE/GUIDE_03_ファイル命名規則.md
  • Git 運用ルール: docs/01_GUIDE/GUIDE_04_Git運用ルール.md
  • エージェント運用ルール: docs/01_GUIDE/GUIDE_05_エージェント運用ルール.md
  • コーディング規約: docs/01_GUIDE/GUIDE_06_コーディング規約.md
  • ディレクトリ構造規則: docs/01_GUIDE/GUIDE_07_ディレクトリ構造規則.md
  • テスト方針: docs/01_GUIDE/GUIDE_08_テスト方針.md
  • エラーハンドリング方針: docs/01_GUIDE/GUIDE_09_エラーハンドリング方針.md

02_ENV（環境）

  • 技術スタック: docs/02_ENV/ENV_01_技術スタック.md
  • 環境構築手順: docs/02_ENV/ENV_02_環境構築手順.md
  • 管理者用環境構築手順: docs/02_ENV/ENV_03_管理者用環境構築手順.md

03_PLAN（計画）

  • 要件定義書: docs/03_PLAN/PLAN_01_要件定義書.md
  • 開発ステップ: docs/03_PLAN/PLAN_02_開発ステップ.md

04_SPEC（仕様・設計）

  • アーキテクチャ設計: docs/04_SPEC/SPEC_01_アーキテクチャ設計.md
  • 照明均一性評価アルゴリズム: docs/04_SPEC/SPEC_02_照明均一性評価アルゴリズム.md
  • TIAS 白板撮影プロトコル: docs/04_SPEC/SPEC_03_TIAS白板撮影プロトコル.md
  • 白板撮影データ仕様: docs/04_SPEC/SPEC_04_白板撮影データ仕様.md

05_TECH（技術設計）

  • DNG 対応要求仕様: docs/05_TECH/TECH_01_DNG対応要求仕様.md
  • TIAS 撮影条件: docs/05_TECH/TECH_02_TIAS撮影条件.md

06_TEST（テスト・評価報告）

  • 照明均一性評価報告書: docs/06_TEST/TEST_01_照明均一性評価報告書.md
  • PNG/DNG 評価比較報告書: docs/06_TEST/TEST_02_PNG_DNG評価比較報告書.md
  • 外乱光影響評価報告書: docs/06_TEST/TEST_03_外乱光影響評価報告書.md
  • 単灯照明比較評価報告書: docs/06_TEST/TEST_04_単灯照明比較評価報告書.md
  • 後側ロフト w=1.4 実機評価報告書: docs/06_TEST/TEST_05_後側ロフトw1p4実機評価報告書.md