GitHub Release

プロジェクトをサニタイズして GitHub にリリースします。2 段階のワークフロー：まず安全性チェック、次にタグ作成とパブリッシュ。

前提条件

• gh CLI がインストール済みで認証済み (gh auth status)
• gitleaks がインストール済み (brew install gitleaks または GitHub からダウンロード)
• リモートが設定済みの Git リポジトリ

ワークフロー

フェーズ 1: サニタイズ

公開リリース前に以下のチェックを実行します。ブロッカーが見つかった場合は中止します。

1. シークレットスキャン (ブロッカー)

gitleaks detect --no-git --source=. --verbose

シークレットが見つかった場合: 中止。シークレットを削除して環境変数に移動します。git log -S "secret_value" で Git 履歴を確認してください。履歴に含まれている場合は BFG Repo-Cleaner を使用します。

gitleaks がインストールされていない場合は、手動でチェックします:

# .env ファイルをチェック
find . -name ".env*" -not -path "*/node_modules/*"

# 設定ファイルのハードコードされたシークレットをチェック
grep -ri "api_key\|token\|secret\|password" wrangler.toml wrangler.jsonc .dev.vars 2>/dev/null

2. 個人成果物の削除

パブリッシュされるべきではないセッション/プランニングファイルをチェックして削除します:

• SESSION.md — セッション状態
• planning/, screenshots/ — 作業ディレクトリ
• test-*.ts, test-*.js — ローカルテストファイル

これらを削除するか、.gitignore に追加します。

3. LICENSE の確認

ls LICENSE LICENSE.md LICENSE.txt 2>/dev/null

ない場合は作成します。リポジトリの可視性を確認してください (gh repo view --json visibility -q '.visibility')。公開リポジトリには MIT を使用してください。プライベートリポジトリの場合は、代わりに独占ライセンスを検討してください。

4. README の確認

README の存在と基本セクションを確認します:

grep -i "## Install\|## Usage\|## License" README.md

セクションが不足している場合は、リリース前に追加します。

5. .gitignore をチェック

必須パターンが存在することを確認します:

grep -E "node_modules|\.env|dist/|\.dev\.vars" .gitignore

6. ビルドテスト (ノンブロッキング)

npm run build 2>&1

7. 依存関係監査 (ノンブロッキング)

npm audit --audit-level=high

8. サニタイズコミットを作成

サニタイズ中に変更が加えられた場合:

git add -A
git commit -m "chore: prepare for release"

フェーズ 2: リリース

1. バージョンを決定

package.json で現在のバージョンを確認するか、ユーザーに確認します。バージョンが v プレフィックスで始まることを確認してください。

2. タグが存在しないことを確認

git tag -l "v[version]"

存在する場合は、ユーザーに削除して再作成するか、別のバージョンを使用するかを確認します。

3. リリース内容を表示

LAST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "")
if [ -z "$LAST_TAG" ]; then
  git log --oneline --no-merges HEAD | head -20
else
  git log --oneline --no-merges ${LAST_TAG}..HEAD
fi

4. タグを作成してプッシュ

git tag -a v[version] -m "Release v[version]"
git push origin $(git branch --show-current)
git push origin --tags

5. GitHub Release を作成

gh release create v[version] \
  --title "Release v[version]" \
  --notes "[auto-generated from commits]"

プレリリースの場合は --prerelease を追加します。ドラフトの場合は --draft を追加します。

6. レポート

ユーザーに以下を表示します:

• リリース URL
• 次のステップ (該当する場合は npm パブリッシュ、アナウンス)

リファレンスファイル

確認項目	ファイル
詳細な安全性チェック	references/safety-checklist.md
リリースメカニクス	references/release-workflow.md