git-worktree-discipline

Git Worktree の運用規律

内部共有スキルです。最初の重要な書き込み（ドキュメントまたはコード）の前に、必要に応じて分離環境を作成／検出します。ホストはこれを dependencies で宣言し、利用できない場合は中止します。

名称に関する注意： 意図的に using-git-worktrees という名前にはしていません。git-worktree-discipline のみを使用してください。運用上の作成／検出／セットアップの詳細は reference.md にあります（一般的な worktree の運用方法を参考にしており、外部スキルへの依存はありません）。

実行するタイミング

ホストの実行中に、最初の重要な永続的書き込み（ドキュメントまたはコード）を行う前に実行します。この変更に対してすでに分離されている場合、または gate が never の場合、あるいはこのセッションでインプレースの軽量対応／緊急修正を行い、留痕を残す場合に限り、作成の提案を省略します。

手順

1. 検出 — この変更用のリンクされた worktree 内にすでにいますか？その環境を再利用します（入れ子にしないでください）。分離されていると判断する前に、サブモジュールと worktree を区別します。コマンド：reference.md。
2. 設定の確認 — AGENTS.md / CLAUDE.md の worktree-gate：always | never | ask。未設定は ask と同じです。
3. 推奨（ask / always） — プロジェクトの状態（同階層の ../ スクリプト、完全なプロダクトパック、変更のあるプライマリツリー）に基づいて適性を判断します。コードと単体テストには適しています。パスの再バインドができないプロダクトパックには適していません。
4. gate に従って実行
   • never → 作成を省略；【工作区隔离跳过】escape=worktree-gate-never；reason=…
   • always → 可能であれば作成します（確認不要）。
   • ask → 推奨を提示した後、作成／見送り／軽量対応のいずれにするか尋ねます。黙って作成しないでください。
5. 作成 — 利用可能な場合は、エージェントのネイティブなワークスペース／worktree 機能を優先します（ハーネスから見えない孤立した git worktree の発生を避けるため）。それ以外の場合は、無視対象のプロジェクト内ディレクトリ（.worktrees/ を推奨）を使って git で作成します。git check-ignore で無視対象であることを確認します。パスの優先順位と失敗時のフォールバック：reference.md。
6. セットアップとベースライン確認 — 新しいワークスペースで、プロジェクトに適したインストール／ビルドと、プロジェクトに設定されている場合はベースラインテスト／型チェックを実行します。ベースラインが失敗した場合は報告し、続行するか調査するかを尋ねます。該当するプロジェクトのマーカーがない場合に限り、インストール／ベースライン確認を省略します。
7. 軽量対応／緊急修正／見送り — 【工作区隔离跳过】escape=lean-hotfix|user-decline；reason=…

設計の承認の代わりにしないでください。実行中に黙って分離環境を破棄しないでください。worktree 内で完全なプロダクトパックをワンクリック実行できるかのように示唆しないでください。

クリーンアップの責任

検証／アーカイブ後の破棄／削除は、feature-branch-closeout の任意のクリーンアップに委ねます。このスキルでは、作成に対応する削除コマンドを記載してもかまいません。

統合ガイド

• ホスト：最初の成果物／コードを書き込む前に、このスキル（worktree gate と任意の分離環境）を読み込むことを1行で指示します。
• クリーンアップには feature-branch-closeout を組み合わせます。
• user-invocable: false を推奨します。
• 検出／作成／セットアップのチェックリスト全体：reference.md。