HELP
2110 Lab 運用・開発ガイド
01 — プロジェクト構成
2110 Lab のソースコードは専用リポジトリで管理しています。
| リポジトリ | 用途 | ローカルパス | 状態 |
|---|---|---|---|
| 2110lab | 2110lab.com（静的サイト） | O:\AI_\Claudecode\2110lab\ |
本番運用中 |
2110lab.comに関する全ての作業は 2110lab/ ディレクトリで行います。
02 — どのディレクトリで作業するか
判断基準はシンプル: 2110lab.comに載っているファイルの修正なら 2110lab/、それ以外のプロジェクト内部の修正ならそのプロジェクトのフォルダです。
サイトのページ追加・デザイン変更・テキスト修正
TOPページ、LP、コンテンツページの新規作成や修正
O:\AI_\Claudecode\2110lab\
数秘の巫女のバグ修正・機能追加
占いアプリのJS/PHP/CSSはサイト内に含まれているため
O:\AI_\Claudecode\2110lab\
外部プロジェクト（ゲーム・ツール等）のロジック修正
Railway等にデプロイされるプロジェクトのコード修正
各プロジェクトのフォルダ
外部プロジェクトの紹介ページをサイトに追加
ゲームの専用HPを作ってTOPページに掲載する等
O:\AI_\Claudecode\2110lab\
他のプロジェクトのディレクトリからClaude Codeを開いて「2110labに掲載して」と頼むのは避けてください。CLAUDE.mdが別物のため、サイト構造を把握できずミスが起きます。
03 — デプロイの仕方
ファイル編集
2110lab/ 内
git commit
変更を記録
git push
master → main
GitHub Actions
自動実行
Xserver
2110lab.com
Claude Code に指示する場合、以下の一言で commit → push → デプロイ確認まで全て行います:
指示例
「反映して」「pushして」「デプロイして」
実行されるコマンド:
git add （変更ファイル）
git commit -m "変更内容"
git push origin master:main
# → GitHub Actions が自動で rsync → Xserver
git commit -m "変更内容"
git push origin master:main
# → GitHub Actions が自動で rsync → Xserver
04 — 指示の出し方・例文集
ページの追加・修正
新規ページ作成
「O:\AI_\Claudecode\ストラテジーゲーム\ にあるゲームの専用ページを作ってTOPに掲載して」
既存ページ修正
「suuhi-no-miko.html のAboutセクションのテキストを〇〇に変えて」
デザイン変更
「TOPページのGamesセクションのカードデザインを変更して」
バグ修正
エラー報告
「占いでエラーが出た。鈴音でライフパスを選んだら〇〇というメッセージが表示される。調査して」
表示崩れ
「スマホで見たらヘッダーがはみ出てる。直して反映して」
デプロイ
シンプルに反映
「反映して」「pushして」
修正してから反映
「〇〇を修正して反映して」
05 — サイト更新の手順
よくある作業と、Claude Code への具体的な指示例:
TOPページの修正
開くディレクトリ: 2110lab/
指示例
「TOPページのNovelsセクションのカードの並び順を変えて反映して」
指示例
「TOPページのフッターに"更新履歴"のリンクを追加して反映して」
占い（数秘の巫女）のバグ修正
開くディレクトリ: 2110lab/
指示例
「鈴音でライフパスを選んだら"占いの準備がまだ整っておりません"と出る。調査して直して反映して」
指示例
「おみくじのアニメーションが途中で止まる。スマホのChromeで再現する。修正して」
新しいゲームページの追加
開くディレクトリ: 2110lab/
指示例
「O:\AI_\Claudecode\ローグライクカードゲーム\ にあるゲームの専用ページを作って、TOPページのGamesセクションに追加して反映して」
小説の章を追加
開くディレクトリ: 2110lab/
指示例
「O:\AI_\Claudecode\小説\灰色の王冠\第16章.md を章リーダーに追加して、novel-crown.htmlの章リストも更新して反映して」
外部プロジェクト（ゲーム・ツール等）のロジック修正
開くディレクトリ: そのプロジェクトのフォルダ
指示例
「（ゲームのフォルダで）敵のAIがおかしい。ターン3以降攻撃してこない。修正してデプロイして」
ゲーム・ツール本体のロジック修正は、そのプロジェクトのフォルダで直接行います。2110lab側はiframeで埋め込んでいるだけなので変更不要です。
おみくじの確率変更
開くディレクトリ: 2110lab/（またはブラウザから直接）
指示例
「おみくじの大吉の確率を10%→15%に上げて反映して」
管理画面（
suuhi-no-miko/admin.html）からGUIで変更することもできます。パスワード: nito0210
06 — 新規プロジェクトの掲載
新しいプロジェクトを2110lab.comに掲載する手順:
| Step | 内容 | 操作場所 |
|---|---|---|
| 1 | プロジェクト本体を開発・デプロイ | 各プロジェクトのフォルダ |
| 2 | Claude Code を 2110lab/ で開く |
2110lab/ |
| 3 | プロジェクトのパスを伝えて専用ページ作成を依頼 | 2110lab/ |
| 4 | TOPページのセクションにリンクカードを追加 | 2110lab/ |
| 5 | 「反映して」でデプロイ | 2110lab/ |
指示例
「O:\AI_\Claudecode\ローグライクカードゲーム\ にあるゲームの専用ページを作って、TOPページのGamesセクションに追加して反映して」
Claude Codeは別フォルダのファイルも読めるので、素材や設定を参照しつつ、HTML作成からデプロイまで
2110lab/ 内で完結します。
07 — バグ修正・トラブル対応
よくあるトラブルと対応:
| 症状 | 原因 | 対応 |
|---|---|---|
| 占いで「準備がまだ整っておりません」 | Xserver上の.htaccessが消えた | Xserverファイルマネージャで.htaccessを再作成 |
| デプロイ後にサイトが壊れた | rsyncのパスミス等 | deploy.ymlを修正して再push |
| GitHub Actionsが失敗 | Secretsの設定不備 | GitHub Settings → Secrets で値を確認 |
| 管理画面で保存できない | .htaccessにADMIN_PASSWORDがない | Xserverで.htaccessを確認 |
Xserver手動設定ファイル（Git管理外）:
# パス: 2110lab.com/public_html/suuhi-no-miko/api/.htaccess
SetEnv GEMINI_API_KEY （Gemini APIキー）
SetEnv ADMIN_PASSWORD nito0210
SetEnv GEMINI_API_KEY （Gemini APIキー）
SetEnv ADMIN_PASSWORD nito0210
このファイルはデプロイで消えないよう、rsyncの除外設定済みです。
08 — 注意事項・やってはいけないこと
| 内容 | 理由 | |
|---|---|---|
| NG | APIキーをHTMLやJSにハードコード | 公開リポジトリに漏洩する |
| NG | git push --force |
履歴が破壊される |
| NG | 他のプロジェクトから2110labのファイルを直接編集 | git管理が混乱する |
| OK | 2110lab/から他プロジェクトのファイルを「読む」 | 参照は問題なし |
| OK | こまめにcommit & push | Antigravity併用のため推奨 |
セッション終了前に必ずHANDOVER.mdを更新すること。コンテキスト切れで引継ぎが消失する事故が過去にありました。