GitBucket
プロジェクト名
開発進捗
最新: GUIDE_01 に従いプロジェクト立ち上げ中
※ 本欄は最新ステップ 1 行のみ上書き更新．詳細な進捗履歴（動機・設計判断・失敗パターン）は docs/PROGRESS.md に追記する．運用ルールは .claude/rules/progress-log.md を参照（該当ファイル編集時に自動ロードされる）．
必須ルール（コード実装時）
Git 運用
- ブランチ名・コミットメッセージの書式は
.claude/rules/git-conventions.mdに従う（常時ロードされる） - コミットは
/commitを使用する（push・PR 作成は/commit push，マージ・プルまで行う場合は/commit merge） /commitはユーザーが明示的に指示した時のみ実行する．Claude が自発的に/commitやgit commitを呼んではならない（/implement完了後も，案内するだけで自分ではコミットしない．/commitskill はdisable-model-invocationによりユーザー起動限定として強制されている）- 例外: 以下の無人運転ループはユーザー承認済みの例外として専用ブランチに自律コミットする．いずれも push・PR・マージ・
mainへの操作はしない（取り込みは人間が/commit push等で行う）/auto-refactor（リファクタ／ドキュメント整理ループ）→refactor/専用ブランチ/auto-audit（バグ／脆弱性の巡回監査ループ）→fix/専用ブランチ
- 例外（
mainへのマージ）:/deps-updateは，Dependabot が作成した依存更新 PR に限り，ゲート（メジャー更新でない・競合なし・CI 緑またはローカル検証緑）を満たすものをgh pr mergeでmainに取り込む（ユーザーが明示的に起動した時のみ．メジャー更新・CI 赤・PR が付かない alert は報告して人間が判断する）
- 例外: 以下の無人運転ループはユーザー承認済みの例外として専用ブランチに自律コミットする．いずれも push・PR・マージ・
- ops-runner によるマージは承認済みの定常操作:
/commit mergeおよび/deps-updateでは，ユーザーが明示的に起動したことを受けて，ops-runner サブエージェント（軽量モデル）が手順書に従いgit push→gh pr create→gh pr merge --merge --delete-branchで自リポジトリの PR をmainにマージする．force push・--admin・mainへの直接 push は行わない（権限設定はdocs/01_GUIDE/GUIDE_01の「Claude Code の権限設定」）
テンプレート同期
- テンプレートの更新は
/sync-templateで取り込む - テンプレート由来のファイル（
.claude/agents/・skills/・rules/・hooks/，docs/01_GUIDE/）をこのプロジェクトの都合で意図的に変更したときは，.claude/template-overrides.md（テンプレート改変台帳）に理由付きで記録する（.claude/rules/template-customization.md．該当ファイル編集時に自動ロードされる）．記録が無いと次回同期で改変が消えうる
タスク管理（任意）
- やるべきことを GitHub Issues で管理してよい（solo / team 共通）．
/task-create（起票・事前計画）→/task-start <Issue番号>（着手準備）→/task-handoff（中断時の引継ぎメモ投稿）を使う - Issue は必須ではない．小さい変更や試験的作業は Issue 無しで進めてよい
- solo モードでは進捗記録（
.claude/rules/progress-log.md）は従来どおり運用し，Issue はタスクの管理・引継ぎの補助として使う
エージェントチーム（GUIDE_02 準拠）
- 実装は
/implement <タスク>で開始する（コーディング → テスト → リファクタリング → ドキュメント更新） - Phase 1 後に人間が動作確認，Phase 2 でテスト失敗時のみ方針判断
- Phase 2 成功後は Phase 3 → Phase 4 まで自動で進む（Phase 4 で更新がある場合のみ確認）
- テスト・リファクタリングをスキップしない
開発コマンド
- 起動・テスト・lint 等の開発コマンドは
docs/02_ENV/ENV_04_開発コマンド.mdにまとめる．存在する場合は実行前に必ず参照し，推測でコマンドを試さない - コマンドが新しく確定・変更された時は同ファイルに反映する（無ければその時点で作成する．
/implementの Phase 4 でも見直される）
手動確認が必要な作業（自分で完了させないこと）
以下は実装完了後にユーザーへ報告し，確認・実施を依頼すること．
- 外部サービスの設定（コンソール操作，セキュリティルール変更等）
- 例外:
ghCLI で操作できる GitHub リポジトリ設定（Dependabot alerts / security updates の有効化）は Claude がgh apiで行う（手順は.claude/skills/setup/reference.md，背景は GUIDE_01「環境構築」）
- 例外:
- 実機・ブラウザでの動作確認
- ストアへのアップロード・リリース作業
ドキュメント
設計・規約に関する情報は docs/ にある． コードを書く前に関連するファイルを読むこと．
01_GUIDE（規約・ルール）
- プロジェクト立ち上げフロー: docs/01_GUIDE/GUIDE_01_プロジェクト立ち上げフロー.md
- エージェント運用ルール: docs/01_GUIDE/GUIDE_02_エージェント運用ルール.md
- ※ Git 規約・ドキュメント書式・命名規則・進捗記録・テンプレート改変記録は
.claude/rules/（git-conventions / markdown-style / docs-naming / progress-log / template-customization）に定義されている（git-conventions は常時，他は該当ファイル編集時に自動ロード） - ※ コーディング規約，テスト方針等はプロジェクト立ち上げ時に path-scoped rules（
.claude/rules/）として作成する（GUIDE_01 参照）