venhdev/zenforge

worktree

Isolate concurrent agent sessions in dedicated Git worktrees under .agents/worktree/ to prevent workspace collisions.

ソースを見る

使い方

  1. インストールコマンドをコピーし、自分の環境へ導入する前にソースを確認します。
  2. 必要なツール、認証情報、対応環境を原文で確認します。
  3. 入力と成果物を指定し、出力を資料と照合します。
npx skills add https://github.com/venhdev/zenforge --skill worktree

開始前の確認

  • 導入にはモデル契約、API枠、ファイルへのアクセス許可は含まれません。
  • スター数や導入数は活動の指標であり、独立した品質・安全性試験ではありません。
リポジトリの原文

見出し、例、コード、表、リンク、参照画像を含む原文を表示しています。

worktree — Isolated Session & Branching Engine

Operating Invariants

  • Path Isolation: Confine all branch edits, shell commands, and test executions strictly within .agents/worktree/<branch>; forbid modifying root repository files from a worktree session.
  • Dirty Tree Breaker: Verify working tree cleanliness via git status --porcelain before deleting a worktree; forbid deleting worktrees containing uncommitted modifications.
  • Pre-Mutation Gate: Stage worktree creation or removal in Canonical Changeset format and halt turn immediately; forbid executing worktree mutations on disk without affirmative human authorization.

Domain Rubric

1. Naming & Storage Conventions

  • <branch>: Strictly format as <type>/<slug> (feat/, fix/, refactor/, chore/, test/).
  • <path>: Dedicated path strictly under .agents/worktree/<branch>.
  • Privacy Anchor: Root .gitignore must contain .agents/worktree/.

2. Supported Worktree Operations

  • [CREATE]: Add a new worktree branch checked out at target path.
  • [DELETE]: Remove worktree directory and prune git administrative metadata.
  • [LIST]: Inspect active worktrees and associated branches.
  • [PRUNE]: Clean up squash-merged branches safely via scripts/prune-squashed.sh.

Canonical Output Contract

text
# Changeset: Git Worktree <Action>

`-- .agents/worktree/<branch>/
    `-- [<ACTION>] <Worktree operation summary>.

Summary: 1 worktree affected (<branch>).

Execution Protocol

Phase 1: Pre-flight & Collision Audit

  1. For create: Inspect git worktree list and verify no branch or directory collision exists.
  2. For delete: Inspect git status --porcelain inside target <path>. If dirty, halt immediately and report uncommitted files.
  3. For list: Run git worktree list and present active worktrees, halting turn immediately.

Phase 2: Staging & Authorization Gate

  1. Stage the planned worktree modification in Canonical Changeset format.
  2. Present the staging summary and halt turn immediately for human authorization.

Phase 3: Atomic Execution & Handoff

  1. On approval, execute the required operation:
  • Create: git worktree add <path> -b <branch> <base_ref>
  • Delete: git worktree remove <path> && git worktree prune
  • Prune: bash scripts/prune-squashed.sh <target_branch>
  1. Report operation completed with the absolute workspace path for IDE navigation.
同じリポジトリから

関連する Skills

すべての Skills