進捗ドキュメントに基づいた実装を進め、作業中は継続的にドキュメントを更新
Automates implementation phase by executing specifications from progress documents and continuously updating them.
/plugin marketplace add MH4GF/issync/plugin install issync@issync-pluginsあなたは論点駆動開発を実践するAIエージェントです。このコマンドは、進捗ドキュメントの内容を理解した上で実装を進め、作業中は常に進捗ドキュメントを更新し続けることで、AI駆動開発ワークフローの実装フェーズを自動化します。
/issync:implement https://github.com/owner/repo/issues/123 # Issue URL指定
/issync:implement 123 # Issue番号指定
このコマンドは「論点駆動開発」ワークフローのimplementフェーズで使用します:
implementステート(アーキテクチャ決定後、本実装フェーズ)Specification / 仕様セクションに基づいて実装を進めるプロジェクト全体の前提条件はREADME.mdを参照。このコマンド固有の前提条件:
/issync:plan実行済み)Specification / 仕様セクションが記入済み)既に進捗ドキュメントを理解している場合は、このステップをスキップして直接ステップ2に進んでください。
進捗ドキュメントをまだ読み込んでいない場合は、/issync:understand-progressコマンドを内部で呼び出して、進捗ドキュメントを読み込みます。
/issync:understand-progress <issue_url_or_number>
このコマンドに指定された引数(Issue URLまたはIssue番号)をそのまま渡してください。
新しい実装を始める前に、既存のテストが通ることを確認してください。プロジェクト固有のテストコマンドはCLAUDE.mdを参照。
テスト失敗時: 新機能の実装より既存機能の修復を優先。進捗ドキュメントのOpen Questionsに問題を記録し、修正してから次に進みます。
進捗ドキュメントのSpecification / 仕様セクションに従って、実装を開始してください。
実装の進め方:
Validation & Acceptance Criteriaに基づく)実装を進める中で、必ず進捗ドキュメントを継続的に更新してください。
更新タイミング:
Discoveries & Insightsに発見を記録Open Questionsに追加Follow-up Issuesに追加Specification / 仕様を更新更新方法: Editツールでセクション単位で更新し、issync pushで同期。
実装が完了したら、以下を実行してください:
5-1. 受け入れ条件の検証(必須)
進捗ドキュメントのValidation & Acceptance Criteriaに記載された全ての検証コマンドを実行し、exit code 0を確認:
5-2. リグレッションテスト
プロジェクト全体のテストやチェックを実行:
プロジェクト固有のコマンドはCLAUDE.mdやpackage.jsonを参照。テスト失敗時はエラーを修正して再実行。
前提: 受け入れ条件の検証コマンドが全て成功していること(成功していなければレビューは無意味)
変更をステージングし、3つの観点で並列レビュー:
git add <実装ファイル>
3つのTask toolを単一メッセージで並列呼び出し:
| subagent_type | description | prompt(観点) |
|---|---|---|
| code-reviewer | Review for simplicity | 【観点: コードの簡潔性】'Less is More' 原則、DRY違反、不要な複雑さ |
| code-reviewer | Review for bugs/security | 【観点: バグ・セキュリティ】Null/undefined処理、エラーハンドリング、脆弱性 |
| code-reviewer | Review for conventions | 【観点: プロジェクト規約】Biomeルール、テストカバレッジ、命名規則 |
エージェントはJSON形式で信頼度80+の問題のみ報告(詳細はcode-reviewerエージェント定義参照)。
結果に基づくアクション:
Follow-up Issuesに追加 → ステップ6へエッジケース: 変更なし/全パス → ステップ6へ、エージェントエラー → リトライ or スキップ
機能の実装が完了し、全てのテストが通ったら、変更をコミットしてください。
Git Safety Protocol:
git log -1 --format='%an %ae')コミット手順:
git status # 変更ファイルを確認
git diff # 変更内容の詳細を確認
git log --oneline -10 # 既存のコミットメッセージスタイルを確認
git add <変更したファイル> # 変更をステージング
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
)"
git status # "nothing to commit"を確認
注意事項:
コンテキストが不足してきた場合や作業が一区切りついた場合、作業途中であっても必ず以下を実行してクリーンな状態で終了してください。
終了手順:
進捗ドキュメントを更新して同期:
Open Questionsに記録Discoveries & Insightsに記録Specification / 仕様またはDiscoveries & Insightsに記録issync pushで同期ステップ5のテストを再実行してパスを確認
ステップ6の手順で変更をコミット(作業途中でもWIPコミット可)
リモートにプッシュ: git push
必須要件(全て満たすこと):
Validation & Acceptance Criteria記載分)git statusが"nothing to commit")issync push完了)Specification / 仕様に基づいて実装Validation & Acceptance Criteriaに基づいてテスト追加・実行issync pushで同期それでは、上記のフローに従って実装を開始してください。