git-worktree docs
git-worktree リポジトリの docs/ 配下を docs-site 上で読むための入口。
gwt の CLI reference、swt の日常 workflow、Superset/Codex 連携の runbook、Codex hook 設定を責務別に並べる。
Source of truth
原本は TomoakiMizuno/git-worktree の docs/。
内容が古くなった場合は元リポジトリを読み直して content/git-worktree/docs/ を更新し、build で public/ を再生成する。
ページ一覧
gwt の使い方
汎用 git worktree wrapper。add / list / remove / exec / completion、コピー対象、.worktreeinclude。
swt workflow
GitHub Issue/PR から worktree を作る日常 workflow。タスクテンプレート、エージェント起動、PR 作成戦略、clean。
Superset/Codex 連携
Superset workspace 連携と Codex App worktree 連携の runbook。MCP/CDP、mode/route、sync/unlink/cleanup、手動検証。
Codex hook 連携
Codex SessionStart hook 設定と hook 診断。sync-current-workspace を hook から呼ぶ前後の確認。
責務の分担
| ページ | 責務 |
|---|---|
| gwt の使い方 | GitHub や Superset に依存しない gwt の操作。コピー対象と .worktreeinclude の制御。 |
| swt workflow | Issue/PR 起点の worktree 作成、branch 名生成、--agent / --pr / --base、孤立 worktree の swt clean。 |
| Superset/Codex 連携 | transport precedence、MCP/CDP、host DB、swt codex の sync / unlink / stale / cleanup、所有権境界。 |
| Codex hook 連携 | ~/.codex/hooks.json の SessionStart hook 設定、check-hooks 診断、warning の classification と retry guidance。 |