Skip to content

docs: 作業ブランチの命名規則を追加 - #116

Merged
version-1 merged 6 commits into
mainfrom
worktrees/8/docs/worktree-branch-naming
Aug 8, 2026
Merged

docs: 作業ブランチの命名規則を追加#116
version-1 merged 6 commits into
mainfrom
worktrees/8/docs/worktree-branch-naming

Conversation

@version-1

@version-1 version-1 commented Aug 8, 2026

Copy link
Copy Markdown
Owner

作業ブランチの命名規則を追加

Summary

worktree で作業するブランチを通常のブランチと区別できるよう、AGENTS.md にスロット番号を含む prefix 規則を追加します。通常ブランチで使用できる prefix も5種類に統一します。

主な変更点:

  • worktree ブランチに worktrees/<番号>/ prefix を付ける規則を明記
  • 具体例として worktrees/1/feat/refine-ui を追加
  • 通常ブランチの prefix を chore/fix/feat/docs/refactor/ に限定
  • cmd-start-branch の命名判断と eval を同じ規則へ統一
  • 外部 skill を immutable commit に pin できるよう deploy fetcher を拡張

やったこと

  • 既存の「ブランチ運用」セクションへ命名規則を追加
  • cmd-start-branch が worktree 内外でブランチ形式を切り替えるよう更新
  • CI など他の種別に当てはまらない保守作業を chore/ へ集約
  • skill 一覧と代表 eval を更新
  • grilling の内容を変えず、従来 tree hash を持つ upstream commit へ固定
  • 40文字の commit SHA を fetch・detached checkout する回帰テストを追加

動作確認

  • git diff --check origin/main...HEAD
  • 必須 prefix、具体例、通常ブランチの5種が AGENTS.md に含まれることを確認
  • evals JSON を jq empty で検証
  • make deploy-dry-run
  • GOMODCACHE=/tmp/gomodcache GOCACHE=/tmp/gocache GOTOOLCHAIN=local go test ./...scripts/deploy
  • Reviewer agent による PR 前レビュー(Severity: None)

レビュー & 動作確認 チェックリスト

  • 命名規則 - worktrees/<番号>/ が worktree ブランチの prefix として明確か
  • 具体例 - worktrees/1/feat/refine-ui が規則を正しく示しているか
  • 通常ブランチ - 許可する5種類の prefix が明確か
  • skill の整合性 - cmd-start-branch が worktree 内外で正しい形式を選ぶか
  • 外部 skill pin - grilling の既存内容を維持した immutable pin になっているか

推奨テスト計画:

  1. AGENTS.md の「ブランチ運用」を確認する
  2. prefix と具体例が読み手に明確か確認する
  3. make deploy-dry-run と deploy scripts の Go テストを実行する

その他気になることや相談ごと

なし。

Closes #8

worktree スロットごとの作業ブランチを識別できるよう、worktrees/<番号>/ prefix と具体例を AGENTS.md に明記する。

Verification: git diff --check; required wording confirmed with rg.
worktree 以外の作業ブランチで使用できる prefix を chore、fix、feat、docs、refactor に限定する規則を AGENTS.md に追加する。

Verification: git diff --check; required prefix list confirmed with rg.
cmd-start-branch が AGENTS.md で許可されていない prefix を選ばないよう、種別表を5種類へ統一し、CI の eval と skill 一覧を更新する。

Verification: git diff --check; eval JSON parsed with jq. Skill validator unavailable due to missing PyYAML. deploy dry-run blocked by existing grilling tree hash mismatch.
cmd-start-branch が worktree のスロット番号を判定し、worktrees/<番号>/<type>/<short-task> 形式を選ぶようにする。番号を特定できない場合は確認へ戻し、代表 eval を追加する。

Verification: git diff --check; eval JSON parsed with jq.
@version-1 version-1 changed the title docs: worktree ブランチの命名規則を追加 docs: 作業ブランチの命名規則を追加 Aug 8, 2026
upstream の grilling skill 更新により deploy dry-run が tree hash mismatch で失敗していたため、検証済みの最新 tree hash へ pin を更新する。

Verification: make deploy-dry-run; GOMODCACHE=/tmp/gomodcache GOCACHE=/tmp/gocache GOTOOLCHAIN=local go test ./...
外部 skill の挙動変更を無条件に追認せず固定できるよう、40文字の commit SHA を fetch・detached checkout する。grilling は従来 tree hash を持つ immutable commit へ固定する。

Verification: make deploy-dry-run; GOMODCACHE=/tmp/gomodcache GOCACHE=/tmp/gocache GOTOOLCHAIN=local go test ./...
@version-1
version-1 merged commit 530478b into main Aug 8, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant