workflow

workflow は、Claude Code の作業をセッション、マシン、長期プロジェクトをまたいで正確に引き継ぐための MIT ライセンスのテンプレートです。引き継ぎノートだけを信用せず、/session-start と /handoff の両スキルが同じ ground-truth.sh を実行して、ローカル Git、リモート、オープン PR、CI、対応するバックグラウンドジョブを確認します。ノートは有用ですが、検証できる「主張」として扱われます。

仕組み

このリポジトリは短期の調整と長期のプロジェクト記憶を分けます。notes/handoff.md はセッション終了時に書き直され、アーカイブには過去の引き継ぎが残ります。BACKLOG.md は未完了の作業だけ、questions.md はオーナー判断が必要な決定、notes/lessons.md は後のセッションで繰り返すべきでない失敗を記録します。設定ファイルでは、どのリポジトリとブランチのリモート状態を確認すべきか指定します。

• 実状態からの開始：/session-start は前回ノートを Git、リモート、PR、CI、該当ジョブと比べてから、その日の作業を提案します。
• 実状態からの引き継ぎ：/handoff は同じ確認を実行して、引き継ぎと追跡ファイルを書き直します。
• 単一リポジトリとワークスペース：一つのリポジトリにも、複数リポジトリを追跡するドキュメント専用ワークスペースにも対応します。
• 安全な導入：bin/adopt.sh は不足しているテンプレートだけをコピーし、既存のプロジェクトファイルを上書きせずスキップを報告します。
• クロスプラットフォームの shell 運用：公式説明では macOS、Linux、Windows の Git Bash または WSL を扱います。

実用的な設定手順

リポジトリを clone してから、プロジェクトルートに対して workflow/bin/adopt.sh を実行します。.claude/ground-truth.conf にリポジトリ一覧を設定し、実状態が完全と報告されるまでチェックを実行します。その後、プロジェクト固有のルール、バックログ、オーナー判断を追加します。一度 /handoff を実行して最初の検証済み状態を作り、次回は /session-start から始めて差分を確認してから実装を割り当てます。

役立つ場面

CI が変化した、バックグラウンドジョブが失敗した、ブランチが未 push のまま、または複数エージェントが近い領域に触れた後で作業を再開するチームや個人に向きます。より長いプロンプトファイルではなく、ノートと観測可能なリポジトリ状態を照合する点が特徴です。Planning with Files や Subagent-Driven Development と比較できます。

制限と代替案

スクリプトが確認できるのは設定された範囲と利用可能な統合だけです。GitHub CLI と systemd は任意のため、読めないチェックは合格ではなく unknown のまま扱うべきです。テンプレートは Claude Code の Skill を中心にしており、別のエージェントランタイムでは適応が必要です。別の実行方式なら Executing Plans Skill を比較してください。

はじめに

公式 READMEを読み、コピー前にテンプレートを確認し、生成されるプロジェクト固有ノートは自分のソース管理とアクセス規則に従って保存します。