add relase check

Author: yu23ki14

CLAUDE.md

@@ -2,18 +2,53 @@
 
 This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
 
+## Project Architecture
+
+BirdXplorer is a multi-module Python project for exploring X (formerly Twitter) community notes data:
+
+- **api/**: FastAPI web API (`birdxplorer_api`)
+- **common/**: Shared library with models, settings, storage (`birdxplorer_common`)
+- **etl/**: Data extraction, transformation, loading (`birdxplorer_etl`)
+- **migrate/**: Alembic database migrations
+
+### Dependencies
+- All modules use `birdxplorer_common` as foundation
+- API and ETL modules depend on `common`
+- PostgreSQL 15.4 for data storage
+- FastAPI for web API with auto-generated Swagger docs at `/docs`
+
 ## Commands
-- **Test**: `tox` (runs format, lint, test, type check)
+
+### Development Environment
+- **Setup env**: `cp .env.example .env` (sets `BX_STORAGE_SETTINGS__PASSWORD=birdxplorer`)
+- **Install module**: `pip install -e "./[module][dev]"` (e.g., `pip install -e "./api[dev]"`)
+- **Docker dev**: `docker-compose up -d` (starts PostgreSQL + FastAPI on :8000)
+
+### Testing & Quality
+- **Test all**: `tox` (from module directory - runs format, lint, test, type check)
+- **Test with data**: `BX_DATA_DIR=data/20230924 tox` (for community notes data testing)
 - **Run single test**: `python -m pytest path/to/test_file.py::TestClass::test_method -v`
 - **Format**: `black <directory> && isort <directory>`
 - **Lint**: `pflake8 <directory>`
 - **Type check**: `mypy <directory> --strict`
 
+### Database
+- **Migrate**: `cd migrate && alembic upgrade head`
+- **New migration**: `cd migrate && alembic revision --autogenerate -m "description"`
+
+### Module-Specific Tox
+Run from project root, then cd to module:
+- **common**: `cd common && tox`
+- **api**: `cd api && tox`
+- **etl**: `cd etl && tox`
+- **migrate**: `cd migrate && tox`
+
 ## Code Style
 - **Line length**: 120 characters
 - **Python version**: 3.10+
 - **Formatting**: Black (opinionated)
 - **Imports**: isort with Black profile, groups: standard, third-party, first-party
+- **First party modules**: `birdxplorer_api`, `birdxplorer_common`, `birdxplorer_etl`
 - **Type hints**: Required, use strict mypy checking
 - **Naming**: Snake case for functions/variables, PascalCase for classes
 - **Error handling**: Custom exceptions inherit from BaseError

RELEASE_CHECK.md

@@ -0,0 +1,117 @@
+このマークダウンファイルはリリース前にするべきチェックリストです。
+定期的にこのリストとプロジェクトコードベースを見比べて、プロダクト開発・運用にガバナンスを効かせるために用いられます。
+
+## OSSの利用
+
+### 必須
+- セキュリティホールのあるソフトウェアに依存していないか
+- 最新バージョンに追従できているか
+
+### 推奨
+- 使用しているPackageに致命的なセキュリティの問題がないか（Dependabotで致命的なものがないか）
+
+## 個人情報を取り扱っているか
+
+### 必須
+- 取り扱いの承認を社内で受けているか
+- プライバシーポリシーの掲載
+
+## 複数のメンバーからレビューを受けているか
+
+### 必須
+- バックエンドのレビュー
+- インフラのレビュー
+- フロントエンドのレビュー
+- 外部サービスのレビュー
+
+### 推奨
+- AIレビューを設定しているか
+
+## 自前のソースコードが存在するか
+
+### 必須
+- GitHubにソースコードが格納されているか
+
+### 推奨
+- アプリのクラッシュ情報の収集ができているか
+
+## 利用者へGUIを提供するか
+
+### 必須
+- 炎上要素が含まれていないかのレビューを受ける
+- 古いロゴをつかっていないか
+- コピーライトがはいっているか
+
+### 推奨
+- デザインレビューを受ける
+- 横向きに対応しているか
+- Faviconがあるか
+
+## DBが存在しているか
+
+### 必須
+- インターネットからアクセスできなくしてあるか
+- 接続元を対象のアプリケーション・サーバーのみにしているか
+
+### 推奨
+- ユーザーのパスワードが推測可能な値になっていないか
+
+## AWSを使用しているか
+
+### 必須
+- 構成管理はCDKで行われているか
+- Credentialsを発行していないか
+
+### 推奨
+- インフラの管理がコードに落とし込まれている
+- cdk-nagが設定されているか
+
+## Secret類を使用しているか
+
+### 必須
+- パスワードなどがプログラムにハードコードされていないか
+- 管理している場所が明確人なっているか
+- 外部から確認できる状態になっていないか
+
+## アクセシビリティへの配慮が必要か
+
+### 推奨
+- タップ範囲の大きさが適切であるか
+- 色覚障がい者へのサポートが適切であるか
+- テキストの大きさは適切であるか
+
+## ECSコンテナが起動しているか
+
+### 推奨
+- コンテナのセキュリティグループはALBからのみのアクセスとなっているか
+- サーバーがスケールする必要があるか
+- オートスケールが行えるか
+
+## サーバーが存在しているか
+
+### 必須
+- 22番ポートが公開されていないか
+
+### 推奨
+- 構築が人に依存していないか
+- アクセスログを取得しているか
+- アクセスログを400日以上保存するようになっているか
+- ログ系のファイルが増えて使用ストレージを逼迫した状態になっていないか
+
+## ユーザー作成・サインインなどが存在する
+
+### 必須
+- 利用規約の同意
+- 利用規約の同意がサインインに含まれているか
+- 利用規約同意が法的に問題なく組み込まれているか
+
+## 必ず対応・確認する項目
+
+### 必須
+- 一般的なセキュリティチェックをクリアしているか
+
+## 留意点
+
+- フロントエンド、バックエンド、インフラなどリポジトリによっては開発対象にしているものが異なるので、適宜必要なチェックを行ってください。必要かどうかの判断が難しい場合はチェックするようにしてください。
+- 各大項目、中項目においてこのプロジェクトに該当するかどうかをまず確認してください。その後それらに紐づく細かな観点について見てください。
+- 確認できなかったものについては理由とともに明記してください。