Initial commit

2025-11-30 08:40:07 +08:00
commit fb4d2ff5f1
12 changed files with 2249 additions and 0 deletions
--- a/commands/implement.md
+++ b/commands/implement.md
@@ -0,0 +1,163 @@
+---
+description: 進捗ドキュメントに基づいた実装を進め、作業中は継続的にドキュメントを更新
+---
+
+# /issync:implement: 実装フェーズ自動化コマンド
+
+あなたは矛盾解消駆動開発を実践するAIエージェントです。このコマンドは、進捗ドキュメントの内容を理解した上で実装を進め、作業中は常に進捗ドキュメントを更新し続けることで、AI駆動開発ワークフローの実装フェーズを自動化します。
+
+## 使用方法
+
+```bash
+/issync:implement https://github.com/owner/repo/issues/123 # Issue URL指定
+/issync:implement 123                                       # Issue番号指定
+```
+
+## コンテキスト
+
+このコマンドは「矛盾解消駆動開発」ワークフローの**implementフェーズ**で使用します：
+- **実行タイミング**: `implement`ステート（アーキテクチャ決定後、本実装フェーズ）
+- 進捗ドキュメントの`Specification / 仕様`セクションに基づいて実装を進める
+- 実装中の意思決定や進捗を常に進捗ドキュメントに記録（Single Source of Truth維持）
+- GitHub Actions（Claude Code Action）からの実行を想定
+
+## 前提条件
+
+プロジェクト全体の前提条件は`README.md`を参照。このコマンド固有の前提条件:
+- 進捗ドキュメントが既に作成されている（`/issync:plan`実行済み）
+- アーキテクチャ決定が完了している（`Specification / 仕様`セクションが記入済み）
+
+## 実行フロー
+
+### ステップ1: 進捗ドキュメントの理解
+
+**既に進捗ドキュメントを理解している場合は、このステップをスキップして直接ステップ2に進んでください。**
+
+進捗ドキュメントをまだ読み込んでいない場合は、`/issync:understand-progress`コマンドを内部で呼び出して、進捗ドキュメントを読み込みます。
+
+```bash
+/issync:understand-progress <issue_url_or_number>
+```
+
+このコマンドに指定された引数（Issue URLまたはIssue番号）をそのまま渡してください。
+
+### ステップ2: リグレッション確認（実装前の必須チェック）
+
+新しい実装を始める前に、既存のテストが通ることを確認してください。プロジェクト固有のテストコマンドは`CLAUDE.md`を参照。
+
+**テスト失敗時**: 新機能の実装より既存機能の修復を優先。進捗ドキュメントの`Open Questions`に問題を記録し、修正してから次に進みます。
+
+### ステップ3: 実装の開始
+
+進捗ドキュメントの`Specification / 仕様`セクションに従って、実装を開始してください。
+
+**実装の進め方:**
+1. 必要なファイルをReadツールで読み込む
+2. コードの変更をEditツールまたはWriteツールで行う
+3. テストコードの追加・更新（`Validation & Acceptance Criteria`に基づく）
+4. 実装が完了したら、テストを実行して動作確認
+
+### ステップ4: 進捗ドキュメントの継続的更新（**最重要**）
+
+実装を進める中で、**必ず進捗ドキュメントを継続的に更新してください**。
+
+**更新タイミング:**
+- 機能実装完了時 → `Discoveries & Insights`に発見を記録
+- 新しい疑問発生時 → `Open Questions`に追加
+- Follow-up事項発生時 → `Follow-up Issues`に追加
+- 仕様明確化時 → `Specification / 仕様`を更新
+
+**更新方法:** Editツールでセクション単位で更新し、`issync push`で同期。
+
+### ステップ5: テストの実行
+
+実装が完了したら、プロジェクトのテストやチェックを実行してください：
+- 単体テストの実行
+- 型チェックの実行
+- リンター・フォーマッターの実行
+
+プロジェクト固有のコマンドは`CLAUDE.md`や`package.json`を参照。テスト失敗時はエラーを修正して再実行。
+
+### ステップ6: 変更のコミット
+
+機能の実装が完了し、全てのテストが通ったら、変更をコミットしてください。
+
+**Git Safety Protocol**:
+- **NEVER update the git config**
+- **NEVER run destructive/irreversible git commands** (like push --force, hard reset, etc) unless the user explicitly requests them
+- **NEVER skip hooks** (--no-verify, --no-gpg-sign, etc) unless the user explicitly requests it
+- **Avoid git commit --amend** unless user explicitly requested or adding edits from pre-commit hook
+- Before amending: ALWAYS check authorship (`git log -1 --format='%an %ae'`)
+
+**コミット手順**:
+
+1. 事前確認と変更のステージング（並列実行）:
+```bash
+git status  # 変更ファイルを確認
+git diff    # 変更内容の詳細を確認
+git log --oneline -10  # 既存のコミットメッセージスタイルを確認
+git add <変更したファイル>  # 変更をステージング
+```
+
+2. 詳細なコミットメッセージでコミット（**HEREDOC形式必須**）:
+```bash
+git commit -m "$(cat <<'EOF'
+<1行目: 変更の性質と要約（例: feat: 〜実装, fix: 〜修正）>
+
+- <変更内容1（何を・なぜを含める）>
+- <変更内容2>
+- テスト: <実行したテストの内容>
+- 進捗ドキュメント: <更新したセクション>
+
+🤖 Generated with [Claude Code](https://claude.com/claude-code)
+
+Co-Authored-By: Claude <noreply@anthropic.com>
+EOF
+)"
+```
+
+3. コミット後の確認:
+```bash
+git status  # "nothing to commit"を確認
+```
+
+**注意事項**:
+- 実行していないテストや未完了の実装を記載しない
+- 秘密情報（.env、credentials.jsonなど）をコミットしない
+
+### ステップ7: セッション終了（クリーンな状態の維持）
+
+コンテキストが不足してきた場合や作業が一区切りついた場合、**作業途中であっても**必ず以下を実行してクリーンな状態で終了してください。
+
+**終了手順**:
+
+1. **進捗ドキュメントを更新して同期**:
+   - 未解決事項を`Open Questions`に記録
+   - 次のセッションへの引き継ぎ事項を`Discoveries & Insights`に記録
+   - 今セッションで実装した内容を`Specification / 仕様`または`Discoveries & Insights`に記録
+   - `issync push`で同期
+
+2. **ステップ5のテストを再実行**してパスを確認
+
+3. **ステップ6の手順で変更をコミット**（作業途中でもWIPコミット可）
+
+4. **リモートにプッシュ**: `git push`
+
+**必須要件**（全て満たすこと）:
+- ✅ 全ての変更がコミット済み（`git status`が"nothing to commit"）
+- ✅ 進捗ドキュメントがリモートと同期済み（`issync push`完了）
+- ✅ テストが全て通っている（壊れた状態で終了しない）
+- ✅ 変更がリモートにプッシュ済み
+- ✅ 引き継ぎ事項が進捗ドキュメントに記録済み
+
+## 重要な注意事項
+
+1. **進捗ドキュメント駆動**: `Specification / 仕様`に基づいて実装
+2. **継続的更新**: 実装中は常に進捗ドキュメントを更新（最重要）
+3. **テスト駆動**: `Validation & Acceptance Criteria`に基づいてテスト追加・実行
+4. **issync連携**: 作業後は`issync push`で同期
+5. **Status変更なし**: GitHub Projects Statusの変更は行わない（PRマージ時に自動変更）
+
+## 実行を開始
+
+それでは、上記のフローに従って実装を開始してください。