| name | pr-strategy-iterate |
| description | 方針A（反復セルフレビュー）で 1 つの GitHub issue を 1 本の PR に実装する。
独立 Subagent(github-issue-implementer)で実装後、独立 Subagent(code-reviewer)による
セルフレビューと修正を指摘点がなくなる（LGTM）まで繰り返し、PR をオープンのまま残す（マージしない）。
各マイルストーンを PR の行動記録(runlog)に残し、速度・反復回数はその記録から集計する。
`/pr-strategy-iterate <issue-number>` で起動する。
|
| allowed-tools | ["Bash","Task","Write"] |
PR Strategy A — 反復セルフレビュー
easy-pokedex-v2（Kurogoma4D/easy-pokedex-v2、Angular + Hono BFF の Pokédex アプリ）の
1 つの issue を、1 本の PR に実装する方針Aの実行スキル。
実装後、セルフレビューと修正を指摘点がなくなるまで繰り返す。PR はオープンのまま残し、マージしない。
計測の定義・runlog 形式・文脈隔離の原則は
experiments ガイド に従う。
中核原則（厳守）
- 文脈隔離: 実装・レビュー・修正はすべて独立 Subagent に依頼する。各 Subagent へのプロンプトは、その時点で取得した正準ソース（issue 本文 / 対象 PR の diff / その PR に投稿されたレビュー指摘）のみから構成する。別 issue・別ラン・自分が気づいた知見を混入させない。
- PR 行動記録: 各マイルストーンを PR の runlog（コメント＋レビュー）として残す。速度・反復回数は手元時計ではなく PR 記録から集計する。
入力
- issue 番号を引数で受け取る（例
/pr-strategy-iterate 42）。無い場合は最も古い open issue。
gh issue list --repo Kurogoma4D/easy-pokedex-v2 --state open --limit 1 -S "sort:created-asc" --json number,title,labels
- open issue が無ければ「対象 issue なし」と報告して停止する。
ワークフロー
Step 0 — 専用 worktree 作成・run-id 確定・作業開始時刻
このランは専用 worktree の中で実行し、Step 7 で削除する（メイン作業ツリーを汚さず、ブランチ取り違え事故を防ぐ）。
metrics.json はメインリポジトリ側のパスへ書き、worktree 削除後も残す。
MAIN_REPO="$(git rev-parse --show-toplevel)"
RUN_TS=$(date -u +%Y%m%dT%H%M%SZ)
STARTED_AT=$(date -u +%Y-%m-%dT%H:%M:%SZ)
RUN_ID="issue-<番号>-iterate-${RUN_TS}"
WT="${MAIN_REPO}-prstrat-${RUN_TS}"
git -C "$MAIN_REPO" fetch origin main -q
git -C "$MAIN_REPO" worktree add --detach "$WT" origin/main
cd "$WT"
mkdir -p "$MAIN_REPO/docs/experiments/pr-strategy/${RUN_ID}"
echo "run-id=${RUN_ID} worktree=${WT}"
以降のステップ（issue 解決・Subagent 委譲・runlog 投稿・集計）はこの worktree 内で行う。
Step 1 — issue を解決
gh issue view <number> --repo Kurogoma4D/easy-pokedex-v2 --json number,title,labels,body
- open であることを確認（closed なら続行可否を確認）。
wontfix/on-hold は対象外。依存 issue 未解決なら停止。
Step 2 — 実装（独立 Subagent / 1 本にまとめる）
github-issue-implementer に委譲する。プロンプトは issue 本文のみから構成し、他ランの知見を入れない。
Task tool:
subagent_type: github-issue-implementer
prompt: |
Implement issue #<number> for easy-pokedex-v2 (Kurogoma4D/easy-pokedex-v2) as a SINGLE PR covering the whole issue.
Base: latest main (checkout main && pull, then branch `issue-<number>`).
Requirements come ONLY from the issue body below — do not add scope from anywhere else.
<issue body をそのまま貼る>
Run install/lint/format/build/test, open one PR with "Closes #<number>", and leave the primary checkout on main.
Step 3 — work_started を runlog に記録
PR 生成直後に runlog コメントを投稿する（README の形式）。
gh pr comment <pr> --repo Kurogoma4D/easy-pokedex-v2 --body "$(printf '<!-- pr-runlog:work_started -->\n```json\n{"event":"work_started","approach":"iterate","issue":<number>,"run_id":"issue-<number>-iterate-%s","self_reported_started_at":"%s"}\n```' "$RUN_TS" "$STARTED_AT")"
Step 4 — セルフレビュー（指摘がなくなるまで反復・独立 Subagent）
ラウンド k=1,2,...:
- code-reviewer に委譲（対象 PR の diff のみを正準ソースとする）。
Task tool:
subagent_type: code-reviewer
prompt: |
Review PR #<pr> in Kurogoma4D/easy-pokedex-v2. Judge ONLY this PR's own diff and the linked issue.
Return findings, or "LGTM" if acceptable.
- レビュー結果を PR にレビューとして投稿（不変タイムスタンプを残す）。
gh pr review <pr> --repo Kurogoma4D/easy-pokedex-v2 --comment \
--body "RUNLOG-REVIEW round=<k> verdict=<LGTM|CHANGES_REQUESTED> findings=<n>
<レビュー本文>"
-
LGTM なら Step 5 へ。指摘ありなら github-issue-implementer に修正を委譲する。修正プロンプトには、その PR に投稿された当該レビューの指摘だけを貼る（他ランの知見は不可）。push 後に runlog コメント fix_applied(round=k) を投稿し、Step 4 の先頭へ戻って再レビューする。
-
上限 8 ラウンド。到達しても LGTM でなければ残指摘を findings_deferred とし、その旨を報告して進む。
Step 5 — ready を runlog に記録
gh pr comment <pr> --repo Kurogoma4D/easy-pokedex-v2 --body "$(printf '<!-- pr-runlog:ready -->\n```json\n{"event":"ready","approach":"iterate","issue":<number>,"run_id":"issue-<number>-iterate-%s","review_rounds":<k>,"findings_deferred":<n>}\n```' "$RUN_TS")"
Step 6 — PR 記録から metrics を集計
PR の GitHub タイムスタンプを取得し、手元時計ではなく記録から計算する。
gh pr view <pr> --repo Kurogoma4D/easy-pokedex-v2 --json number,url,createdAt,comments,reviews
pr_opened_at = createdAt。ready_at = ready runlog コメントの createdAt。review_rounds = RUNLOG-REVIEW レビュー件数。elapsed_seconds = ready_at − pr_opened_at（秒）。$MAIN_REPO/docs/experiments/pr-strategy/${RUN_ID}/metrics.json を Write（README の metrics スキーマ、elapsed_source: "pr_records"）。worktree 内でなくメイン側へ書くことで削除後も残す。
Step 7 — worktree 削除・オープンのまま停止・報告
cd "$MAIN_REPO"
git worktree remove --force "$WT"
- マージ・クローズしない。issue/PR・反復回数・最終判定・
elapsed_seconds・metrics パス・残指摘を報告。
ルール
- 対象は 1 issue・1 PR。分割しない（分割は方針B）。
- 実装・レビュー・修正は独立 Subagent。プロンプトは正準ソースのみ（中核原則）。
- レビューは LGTM まで反復（上限 8）。マージ・クローズしない。
- 計測は PR 記録から集計する（
pr_opened_at〜ready_at）。手元の date 値は補助のみ。
- このランは Step 0 で作成した専用 worktree 内で実行し、終了時（成功・失敗を問わず）必ず
git worktree remove --force "$WT" で削除する。
- 各ステップの結果を確認してから次へ進む。回復不能な失敗は明確に報告して停止する。
