merge: narrow yoi worktree sparse exclusions
This commit is contained in:
@@ -106,7 +106,7 @@ reviewer には coder の実装方針ではなく、この intent packet と dif
|
||||
|
||||
2. worktree 作成
|
||||
- `$user/worktree-workflow` に従い `./.worktree/<task-name>` を作る。
|
||||
- `.yoi` を sparse checkout で除外する。
|
||||
- `.yoi` 自体は除外しない。tracked project records は child worktree に存在してよく、`.yoi/memory` と local/runtime/log/lock/secret-like paths だけを sparse checkout で除外する。
|
||||
|
||||
3. coder Pod spawn
|
||||
- read scope: main workspace 全体。
|
||||
@@ -117,6 +117,8 @@ reviewer には coder の実装方針ではなく、この intent packet と dif
|
||||
- intent packet
|
||||
- Bash は必ず child worktree に `cd` すること
|
||||
- main workspace の `TODO.md` / `tickets/` / `docs/report/` / `.yoi` は編集しないこと
|
||||
- child worktree 内の tracked `.yoi` project records は実装対象に必要な branch-local artifacts/dossiers として編集してよいが、`.yoi/memory` や local/runtime/secret-like files は作らないこと
|
||||
- active orchestration progress と最終 review/approval/close は main workspace の責任として残すこと
|
||||
- 範囲外事項
|
||||
- 実行すべき build / test / format
|
||||
- 完了報告項目
|
||||
@@ -155,6 +157,8 @@ reviewer には coder の実装方針ではなく、この intent packet と dif
|
||||
|
||||
- child worktree 内でのみ実装する。
|
||||
- main workspace の管理ファイルを書かない。
|
||||
- child worktree 内の tracked `.yoi` project records は ticket 要件に必要な branch-local artifact/dossier として扱ってよい。
|
||||
- `.yoi/memory`、local/runtime state、logs、locks、secret-like files を child worktree に作らない。
|
||||
- intent / requirements / invariants / non-goals を読んでから実装する。
|
||||
- 指定された build / test / format を実行する。
|
||||
- ticket 要件外の設計変更、依存関係追加、scope / permission / history persistence / prompt context 加工原則に触れる変更が必要なら止めて orchestrator に報告する。
|
||||
@@ -191,7 +195,7 @@ coder Pod には child worktree 内での commit を許可してよい。
|
||||
- commit は ticket 内で意味のある粒度にする。
|
||||
- 例: `feat: ...`、`fix: ...`、`test: ...`、`docs: ...`
|
||||
- coder Pod は merge / push / branch deletion / worktree remove をしない。
|
||||
- coder Pod は `TODO.md` / ticket の完了処理 commit をしない。
|
||||
- coder Pod は main workspace の Ticket 完了処理 commit、最終 review/approval/close をしない。child worktree 側には branch-local dossier や実装証跡を残してよい。
|
||||
- orchestrator は review 時に commit 粒度も確認する。
|
||||
- 必要な修正は、原則追加 commit として積む。履歴改変や squash は人間の明示指示がある時だけ行う。
|
||||
|
||||
|
||||
@@ -8,7 +8,7 @@ requires: []
|
||||
|
||||
yoi プロジェクトで実装差分を main workspace から分離するため、`./.worktree/<task-name>` に child git worktree を作る。これは **worktree の扱い方だけ** を定める Workflow であり、ticket 選定、coder / reviewer sibling の起動、外部レビュー、merge の運用は `$user/multi-agent-workflow` 側で扱う。
|
||||
|
||||
yoi では Pod の write scope が排他的に委譲されるため、child worktree に `.yoi` を置かない。main workspace は orchestration / ticket / docs / memory / workflow 管理の場所として残し、child worktree はコード差分専用の作業面として扱う。
|
||||
yoi では Pod の write scope が排他的に委譲されるため、child Pod の write scope は child worktree に限定する。child worktree は Yoi project records marker として tracked `.yoi` records を含んでよいが、generated/personal memory root `.yoi/memory`、local override、runtime state、logs、locks、secret-like files は出さない。main workspace は active orchestration progress と最終 review/approval/close の authority として残す。
|
||||
|
||||
## 適用範囲
|
||||
|
||||
@@ -17,7 +17,8 @@ yoi では Pod の write scope が排他的に委譲されるため、child work
|
||||
- coder Pod にこの Workflow を渡して worktree を作らせない。
|
||||
- coder Pod は、orchestrator が作成済みの child worktree を受け取り、その中で実装・build・test・報告を行う。
|
||||
- reviewer Pod は、coder Pod の子ではなく orchestrator 配下の sibling として、原則 read-only で main workspace と child worktree を読む。
|
||||
- ticket 作成、TODO 更新、review artifact、docs/report は main workspace 側で扱う。
|
||||
- ticket 作成、active orchestration progress、最終 review/approval/close は main workspace 側で扱う。
|
||||
- branch-local artifacts / dossiers / docs/report / tracked `.yoi` project records は、実装対象に必要なら child worktree 内で扱ってよい。
|
||||
|
||||
## 原則
|
||||
|
||||
@@ -25,8 +26,9 @@ yoi では Pod の write scope が排他的に委譲されるため、child work
|
||||
- 複数 ticket を下位 orchestrator に任せる場合も、実装差分は ticket / bounded task ごとに worktree を分ける。
|
||||
- worktree path は `./.worktree/<task-name>`。
|
||||
- branch 名は原則 `<task-name>` と同じ kebab-case。
|
||||
- child worktree には `.yoi` を出さない。
|
||||
- child worktree は実装差分用。`TODO.md` / `tickets/` / `docs/report/` / workflow / memory は原則 main workspace 側で扱う。
|
||||
- child worktree には `.yoi` project records を出してよい。
|
||||
- child worktree では `.yoi/memory`、local/runtime/log/lock/secret-like paths を sparse checkout で除外する。
|
||||
- active orchestration progress と最終 review/approval/close は main workspace 側で扱う。branch-local artifacts/dossiers は child worktree 内に置いてよい。
|
||||
- push はしない。
|
||||
|
||||
## 事前確認
|
||||
@@ -52,17 +54,64 @@ git worktree add .worktree/<task-name> -b <task-name>
|
||||
git -C .worktree/<task-name> sparse-checkout init --no-cone
|
||||
git -C .worktree/<task-name> sparse-checkout set --no-cone \
|
||||
'/*' \
|
||||
'!/.yoi/' \
|
||||
'!/.yoi/**'
|
||||
'!/.yoi/memory/' \
|
||||
'!/.yoi/memory/**' \
|
||||
'!/.yoi/logs/' \
|
||||
'!/.yoi/logs/**' \
|
||||
'!/.yoi/_logs/' \
|
||||
'!/.yoi/_logs/**' \
|
||||
'!/.yoi/**/_logs/' \
|
||||
'!/.yoi/**/_logs/**' \
|
||||
'!/.yoi/locks/' \
|
||||
'!/.yoi/locks/**' \
|
||||
'!/.yoi/**/*.log' \
|
||||
'!/.yoi/**/*.lock' \
|
||||
'!/.yoi/**/.lock' \
|
||||
'!/.yoi/override.local.toml' \
|
||||
'!/.yoi/**/*.local' \
|
||||
'!/.yoi/**/*.local.*' \
|
||||
'!/.yoi/local/' \
|
||||
'!/.yoi/local/**' \
|
||||
'!/.yoi/runtime/' \
|
||||
'!/.yoi/runtime/**' \
|
||||
'!/.yoi/pods/' \
|
||||
'!/.yoi/pods/**' \
|
||||
'!/.yoi/sessions/' \
|
||||
'!/.yoi/sessions/**' \
|
||||
'!/.yoi/sockets/' \
|
||||
'!/.yoi/sockets/**' \
|
||||
'!/.yoi/tmp/' \
|
||||
'!/.yoi/tmp/**' \
|
||||
'!/.yoi/cache/' \
|
||||
'!/.yoi/cache/**' \
|
||||
'!/.yoi/secrets/' \
|
||||
'!/.yoi/secrets/**' \
|
||||
'!/.yoi/**/*.secret' \
|
||||
'!/.yoi/**/*.secret.*'
|
||||
```
|
||||
|
||||
この sparse-checkout は `.yoi` 自体を除外しない。`.yoi/memory` は generated/personal memory marker として child worktree から外し、generated log trees は root `_logs` だけでなく recursive `.yoi/**/_logs/**` も外す。memory root detection の実装変更はこの Workflow では扱わない。
|
||||
|
||||
確認する。
|
||||
|
||||
```bash
|
||||
git -C .worktree/<task-name> status --short --branch
|
||||
test ! -e .worktree/<task-name>/.yoi
|
||||
test ! -e .worktree/<task-name>/.yoi/memory
|
||||
if test -d .worktree/<task-name>/.yoi; then
|
||||
test ! -e .worktree/<task-name>/.yoi/override.local.toml
|
||||
test -z "$(find .worktree/<task-name>/.yoi \
|
||||
\( -path '*/_logs' -o -path '*/logs' -o -path '*/locks' \
|
||||
-o -path '*/local' -o -path '*/runtime' -o -path '*/pods' \
|
||||
-o -path '*/sessions' -o -path '*/sockets' -o -path '*/tmp' \
|
||||
-o -path '*/cache' -o -path '*/secrets' -o -name '*.log' \
|
||||
-o -name '*.lock' -o -name '.lock' -o -name '*.local' \
|
||||
-o -name '*.local.*' -o -name '*.secret' -o -name '*.secret.*' \) \
|
||||
-print -quit)"
|
||||
fi
|
||||
```
|
||||
|
||||
この確認は `.yoi` project records の存在を失敗扱いしない。`.yoi/memory` と local/runtime/log/lock/secret-like paths が出ていないことを確認する。
|
||||
|
||||
失敗した場合は、worktree / branch / lock の状態を確認し、勝手に cleanup せず人間へ報告する。
|
||||
|
||||
## Pod へ渡す scope
|
||||
@@ -89,8 +138,11 @@ reviewer は原則 write scope を持たない。review artifact を書かせる
|
||||
|
||||
## child worktree 内の禁止事項
|
||||
|
||||
- `.yoi` を作らない / コピーしない。
|
||||
- main workspace の `TODO.md` / `tickets/` / `docs/report/` を編集しない。
|
||||
- `.yoi/memory` を作らない / コピーしない / 復元しない。
|
||||
- local overrides、runtime sockets/state、Pod session mirrors、cache/tmp、logs、locks、secret-like files を作らない / コピーしない / commit しない。
|
||||
- main workspace の `TODO.md` / `tickets/` / `docs/report/` / `.yoi` を編集しない。
|
||||
- active orchestration progress と最終 review/approval/close を child worktree 内だけで完結させない。
|
||||
- 実装対象に必要な tracked `.yoi` project records、branch-local artifacts / dossiers / docs/report は child worktree 内で扱ってよい。
|
||||
- merge / push / branch deletion / worktree remove をしない。
|
||||
- scope / permission / history persistence / prompt context 加工原則に関わる設計変更を無断で行わない。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user