Mon, August 10, 2026
13 min read
Epic の sub-issue に `S-N-A` / `S-N-H` の通し番号 prefix を付けて AI エージェントと人間で開発を分担する
#ai-agent#github#issue-management#epic#developer-workflow#claude-code
Epic issue を sub-issue に分割して開発を進めるとき、通し番号 `S-N` を 1 つの作業単位として扱い、AI エージェント(Claude Code や Codex など)担当分を `S-N-A`、人間担当分を `S-N-H` の別 sub-issue として並べています。1 つの作業に両方の手番が必要な場合は `S-N-A` と `S-N-H` を並べて立ててそれぞれ独立に close し、片方で完結する場合は対応する片方だけを立てます。以前は 1 つの sub-issue の中に AI エージェントに任せられるタスクと人間しかできないタスク(本番相当のクレデンシャル更新、外部連携先との調整、UX 上の判断など)がチェックリストとして混在しており、エージェントが自分でできる部分だけ埋めて PR を返した後、残りが拾われずに close できない sub-issue が積み上がっていました。sub-issue の粒度で担当を切り分け、通し番号 prefix でそれを示すことで、Epic の sub-issue 一覧を開いた時点で分担が読める状態に揃えています。実際の粒度、切り分けの目安、PR タイトルへの流し込みまで、この repo での経験からまとめます。
read more →