Skip to content

CLAUDE.md

Latest commit

 

History

History
156 lines (124 loc) · 5.89 KB

CLAUDE.md

File metadata and controls

156 lines (124 loc) · 5.89 KB

言語設定

重要：このプロジェクトでは、Claude Codeは必ず日本語で回答してください。技術用語は必要に応じて英語のまま使用可能です

作業実行方針

重要：すべての作業実行は以下の方針に従ってください

  • すべての実行はタスクに分割して行う
  • 複雑な作業や調査が必要な場合はサブエージェント（Task tool）を使用して実行する
  • 並列実行可能なタスクは積極的に並列化する

開発フロー

Git/GitHub運用

  • GitHub Flowを採用し、ブランチベースの開発を実施します
  • ghコマンドを使用してissueの作成、PRの作成・管理を行います
  • 作業前に適切なissueを作成し、ブランチ名はissue番号を含めてください
  • コミットメッセージは簡潔かつ明確に記述します
  • PRマージ前にレビューコメントがある場合は対応します

Issue作成ガイドライン

必須項目
  • タイトル: 実装する機能・修正する問題を明確に記載
  • 説明: 背景、目的、受け入れ条件を具体的に記述
  • ラベル設定（必須）:
    • enhancement: 新機能追加
    • bug: バグ修正
    • documentation: ドキュメント関連
    • ci/cd: CI/CD関連
    • refactor: リファクタリング
    • test: テスト関連
推奨項目
  • 優先度ラベル: priority/high, priority/medium, priority/low
  • 作業規模ラベル: size/small, size/medium, size/large
  • コンポーネントラベル: ui, backend, database, api
  • 関連Issue: 既存のIssueとの関連性を明記

PR作成ガイドライン

必須項目
  • 関連Issue設定:
    • Closes #123: Issue完全解決
    • Fixes #123: バグ修正
    • Relates to #123: 部分的関連
  • ラベル設定: 対応するIssueのラベルを継承
  • レビュー準備: コードレビューに必要な情報を記載
PR説明テンプレート
## 概要
このPRの目的と変更内容を簡潔に説明

## 関連Issue
Closes #[Issue番号]

## 変更内容
- [ ] 変更項目1
- [ ] 変更項目2

## テスト
- [ ] 新しいテストを追加
- [ ] 既存のテストが通ること確認
- [ ] 手動テスト完了

## その他
- 特記事項があれば記載

Claude Code使用時の特別ルール

Issue作成
  • タイトルと説明にClaude Codeで実装予定であることを明記
  • 受け入れ条件を具体的かつ検証可能な形で列挙
  • 技術的制約や要件を詳細に記載
PR作成
  • コミットメッセージに「🤖 Generated with Claude Code」を含める
  • 自動生成されたコードの説明コメントを適切に配置
  • レビュー時の注意点を明記
コミットメッセージフォーマット
type: 簡潔な変更内容の説明

詳細な説明（必要に応じて）

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

テストフレームワーク

  • **Swift Testing（SwiftTest）**を使用します
  • XCTestは使用しません
  • テストカバレッジは100%を目標とし、すべてのテストが通ることを確認します
  • 新規機能開発時は必ず対応するテストを作成します

終了前チェックリスト

  1. SwiftFormatの実行: make formatコマンドでコードフォーマットを統一
  2. テストの実行: すべてのSwiftTestが100%通ることを確認
  3. ビルドの確認: エラーなくビルドが完了することを確認
  4. 不要なコードの削除: デバッグ用コード、コメントアウトされた古いコード等を削除

アーキテクチャ

全体構造

本プロジェクトはClean Architecture + MVVMパターンを採用しています。

レイヤー構成

1. Domain層 (Domain/)

  • Entity: ビジネスエンティティ（ObservationData, DevicePairing, SensingSession等）
  • Repository: データアクセスインターフェース（DataRepository, SwiftDataRepository）
  • Usecase: ビジネスロジック（CalibrationUsecase, SensorManager, ConnectionManagementUsecase等）
  • DataModel: 永続化モデル（SwiftData用のPersistent〜モデル）
  • Utils: ユーティリティクラス（AffineTransform, LeastSquaresCalibration等）

2. Presentation層 (Presentation/)

  • Scenes: 画面単位のView/ViewModel
    • FloorMapTab: フロアマップ関連画面
    • SensingTab: センシング関連画面
    • SettingsTab: 設定画面
    • MainTab: メインタブコンテナ
    • Common: 共通画面（Welcome等）
  • Components: 再利用可能なUIコンポーネント
  • Router: ナビゲーション管理（NavigationRouter, SensingFlowNavigator）

3. Devices層 (Devices/)

  • UWBデバイス関連の通信・制御ロジック

データフロー

  1. View → ViewModel → Usecase → Repository → SwiftData/External API
  2. ViewModelは@Published/@StateObjectでViewと双方向バインディング
  3. Usecaseは複数のRepositoryを組み合わせてビジネスロジックを実装
  4. Repositoryは実際のデータアクセスを抽象化

主要な技術スタック

  • SwiftUI: UIフレームワーク
  • SwiftData: データ永続化
  • Swift Testing: テストフレームワーク
  • NearbyConnections: デバイス間通信
  • swift-format: コードフォーマッター

命名規則

  • View: 〜View.swift
  • ViewModel: 〜ViewModel.swift
  • Usecase: 〜Usecase.swift
  • Repository: 〜Repository.swift
  • Entity/Model: 単数形の名詞

コード品質管理

  • 不要なimport文は削除
  • デッドコードは削除
  • コメントは必要最小限に留め、コード自体を自己文書化
  • SwiftFormatルールに従ったフォーマット
  • 警告は0を維持