[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7AB5J2AYEJKXTFCF4FEF7EQ":3,"skill-same:01M7AB5J2AYEJKXTFCF4FEF7EQ":53},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M7AB5J2AYEJKXTFCF4FEF7EQ","github-delivery",null,"current release-driven Operating ModelをGitHub Issues \u002F Pull Requestsへmaterializeし、release sprint \u002F dependency \u002F review \u002F durable delivery stateを扱う時に使用する。","rebuildup\u002Fproject-init","rebuildup","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F176191237?v=4","01M7AB3QGQ73Q2YNFNFGPAVVRX","samuido","01M7AB3QHEEN3RPZSTXYW3062Y",2,"MIT","https:\u002F\u002Fgithub.com\u002Frebuildup\u002Fproject-init\u002Fblob\u002Fmain\u002Fskills\u002Fgithub-delivery\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: github-delivery\ndescription: current release-driven Operating ModelをGitHub Issues \u002F Pull Requestsへmaterializeし、release sprint \u002F dependency \u002F review \u002F durable delivery stateを扱う時に使用する。\n---\n\n# GitHub Delivery\n\nLayer: **Operating Model + Practice**\n\nこのSkillはcurrent release-driven profileのGitHub materializationを定義する。Issue \u002F PR \u002F branch \u002F PR state lifecycleそのものはConstitutionではない。\n\n重要なのは、durable implementation identity、reviewable evidence、canonical consistency、authority boundary、organizational continuityを維持すること。将来別platform\u002Ftopologyがこれらを同等以上に満たす場合は置換できる。\n\n## Source of Truth\n\n- released source state: `main`\n- active sprint\u002Frelease integration state: `release-x-y-z`\n- durable implementation work state: GitHub Issues\n- dependency state: GitHub Issue dependency metadata\n- release planning \u002F health \u002F portfolio state: Linear Projects \u002F Initiatives\n- ticket review\u002Fintegration: Pull Requests\n- transient execution state: Supervisor\n\n`main` はリリース済み・統合済みの安定状態を表す。\n通常のticket PRを直接 `main` へ向けない。\n\n## Landing authority boundary\n\nPR landing前にcurrent PRを再取得し、actual head\u002Fbaseから **ticket-class \u002F release-class** を分類する。\n\n### Ticket-class\n\n- `base != main`\n- current ticket\u002Frelease integration topologyに属する\n- 通常はticket branch -> target `release-*`、またはdependent ticket -> immediate predecessor ticket branch\n\nticket-class PRはper-PR user merge authorizationを要求しない。acceptance criteria、current-SHA validation、blocking review\u002Fconversation、staleness等のapplicable readiness\u002Fquality gateを満たしreal blockerがなければ、Agent\u002FCoordinatorはready-to-mergeで停止せずlandingまで進める。ただしrelease candidate freeze中は同じrelease trunkへの候補外ticketの自律landingを保留し、実装・reviewは継続できる（ADR-0032）。\n\nstandaloneではAgent \u002F subagent \u002F Coordinator \u002F Supervisorがticket landingを実行できる。parallel-orchestration下でshared durable integration stateへのordered landingが必要な場合はCoordinator \u002F Supervisorがlandingを実行し、worker\u002Fsubagentはvalidated candidateをhandoffする。\n\n### Release-class\n\n- `base == main`\n- `head == current release-*`\n\nrelease-class PRだけはexplicit user authorizationを必要とする。Ready\u002Fmergeable、green validation、approval、ticket PRへのstanding autonomous landing authority、genericな `readyなPRをmerge` \u002F `cleanup` \u002F `最後まで進めて` 等からrelease authorizationを推定しない。\n\nrelease PRはbulk\u002Fautonomous ticket landingとauto-mergeから常に除外する。userがcurrent interactionで対象release PRまたは明確なrelease actionをexplicitにauthorizeした場合だけmergeできる。authorization後もcurrent head\u002Fbase\u002FSHAを再取得し、materialにcandidateが変化していればauthorization applicabilityを再確認する。\n\n`base == main` かつheadがcurrent release branchでないPRはinvalid integration pathとしてlandingを拒否する。\n\nquality gateは「candidateがlanding可能な品質か」を判定する。ticket-classではその成功後に自律landingへ進み、release-classでは別途explicit authorization gateを要求する。ticket authorityをrelease authorityへ伝播させない。\n\n## Pull Request merge method\n\ncurrent release-driven profileでは、GitHub PR landingは **merge commit (`merge`) のみ**（ADR-0018）。repository settingsは `allow_merge_commit=true` \u002F `allow_squash_merge=false` \u002F `allow_rebase_merge=false` へreconcileし、権限不足なら差分をblocker\u002Flimitationとして報告する。Agent \u002F automationはmerge APIでmethodを暗黙選択せず `merge` を明示する。\n\nsquash merge \u002F rebase mergeは使用しない。branch-local `git rebase` はstack maintenance \u002F conflict解消のbranch mechanicsとして許可する。stack landingがmerge commit semanticsを保証できない場合はordered merge-commit landingへfallbackする。method固定からauthorizationを導出しない。\n#### Orchestrated workflow landing boundary\n\n`parallel-orchestration` の execution model 下では、Agent \u002F subagent \u002F worker は **target release integration branch (`release-x-y-z`) や `main` への shared durable integration state への ordered landing を直接実行しない**。landing は Coordinator \u002F Supervisor が durable integration の責務として行う。\n\n- ticket-class candidateはreadiness\u002Fquality gate通過後、追加authorizationなしでCoordinator \u002F Supervisorへlanding handoffする。\n- release-class candidateはexplicit user authorization scopeもhandoff artifactへ含め、Coordinator \u002F Supervisorはcurrent refs\u002FSHAとauthorization applicabilityを再検証してからlandingする。\n- standaloneでrelease PRを扱うAgentは、explicit release authorizationがある場合に限り直接landingできる。\n\nこの境界を越えてworker\u002Fsubagentがshared durable integration stateへlandingした場合、resultはstale candidateとして扱いreconciliationする。\n\n## Main protection \u002F release-only integration\n\nGitHub上で保護機能を利用できるrepositoryでは、`main` をbranch protection \u002F rulesetで保護する。\n\n標準baseline:\n\n- `main`変更にはPull Requestを必須とする\n- required approving review countは **0** とし、個人開発で自己approvalを要求しない\n- conversation resolutionを必須とし、未解決review conversationを残したままmergeしない\n- required status checksは **既定で設定しない**。存在しないCI\u002Fcheck名を推測・固定してmergeを停止させない\n- CIが存在する場合はquality evidenceとして確認するが、branch protectionの固定required checkとは分離する\n- direct push \u002F direct web edit \u002F force push \u002F deletionを通常運用で許可しない\n- normal actor\u002Fadminが保護を日常的にbypassする運用を作らない\n- `main`への正規delivery pathは current `release-x-y-z -> main` release PRだけとする\n- ticket branch \u002F arbitrary branchから`main`へ向いたPRはmerge対象にしない\n\nGitHubの標準branch protection\u002FrulesetではPR head branch patternを直接制約できないため、存在しないrequired status checkを捏造して補わない。source branch制約はproject policy \u002F release automation \u002F merge executorで検証し、`base == main` かつ `head == current release-*` でないPRのmergeを拒否する。既にrepository固有の信頼できるguardが存在する場合は利用できるが、そのcheck名を他projectへ固定継承しない。\n\nreadiness reportでは `ruleset enforced` と `merge-executor policy enforced` を区別する。外部guardがない場合、GitHub UIで任意headからのPR mergeを完全に禁止できるとは報告しない。Agentがmerge APIを呼ぶ直前には必ずbase\u002Fheadを再取得してpreflightする。\n\n初期化時にrepositoryのmain protection\u002Frulesetを実際に確認する。設定変更権限がある場合は上記baselineへ作成・修復し、権限がない場合は差分をblockerとして報告する。\n\n## Weekly planning \u002F adaptive release batching\n\n週次はplanning checkpointであり公開日ではない。1 release train = 1 target version = 1 release branchを維持し、週内の早期release・複数週への持ち越しを許容する（ADR-0032）。\n\nversionは変更の意味・互換性・user指定に従う。major\u002Fminor\u002Fpatchは公開意図から選び、週次境界だけでbumpしない。\n\ncanonical format:\n\n`release-\u003Cmajor>-\u003Cminor>-\u003Cpatch>`\n\nrelease train開始時に`main`からbranchを切る。緊急patchもrelease PRを経由する。候補はscope・公開価値・滞留・変更リスク・release-only実測コストで判定し、PR数だけで決めない。freezeとcarry-overは [adaptive-release-batching.md](.\u002Freferences\u002Fadaptive-release-batching.md) に従う。\n\n### Delivery forecast \u002F capacity\n\n1週間はplanning cadenceであり、選んだscopeが必ず1週間で完了するというestimateではない。\n\nrelease \u002F roadmap \u002F milestoneの完了時期、release date、capacity、carry-over、agent数変更による短縮効果を判断する場合は `agent-delivery-estimation` Skillを使用する。\n\n- IssueのSizeをcalendar durationとして扱わない\n- AI自身の「数日・数ヶ月」という主観的estimateをrelease dateの根拠にしない\n- dependency graph、Work Unit、observed throughput、human review capacity、CI\u002Fexternal wait、usage limitを使う\n- material unknownがある場合は `complete \u002F conditional \u002F unavailable` を維持し、日付を捏造してfieldを埋めない\n- sprintごとの実績を次のforecast calibrationへ戻す\n\n## Issue\n\ndurable planning unitは原則GitHub Issueにする。\n\nIssueのtitle\u002Fbodyは日本語を標準とする。\n\n最低限、該当するものを明示する:\n\n- 目的 \u002F user-visible outcome\n- acceptance criteria\n- scope \u002F non-scope\n- dependency \u002F blocked-by\n- priority\n- size\n- area\u002Fcomponent\n- target version\n- release date\n- accountable assignee\n\n短命なresearch\u002Fworker subtaskまでIssue化する必要はない。\n\nIssue dependency graphはcanonical dependency SoTであり、Git branch topologyだけでdependencyを表現しない。\n\n## Linear planning control plane\n\nrelease planning \u002F health \u002F portfolio はLinearへ統一する。GitHub Projectsは標準運用では作成・要求・同期しない。\n\n- GitHub Issues: implementation scope \u002F acceptance criteria \u002F dependency の durable SoT\n- GitHub PR: review \u002F integration \u002F validation evidence\n- Linear Project \u002F Initiative: release goal \u002F target date \u002F health \u002F portfolio\n- Linear Issue: cross-repository blockerやexternal dependencyなどrelease-level coordinationに限定\n\nGitHub IssueをLinear Issueへ全面mirrorしない。詳細は `linear-release-control` Skillに従う。\n\nDependency execution上は必要に応じて `blocked` \u002F `stack-ready` \u002F `integrated` を区別するが、GitHub ProjectsのStatus fieldを前提にしない。\n\n## Sprint \u002F release cycle\n\n1. 週次planning windowを置き、release intent \u002F scopeとtarget versionを決める。release dateは `agent-delivery-estimation` のevidence-backed forecastまたは外部deadlineと区別する。週次終了自体はpublication triggerにしない。\n2. 新しいrelease trainの開始時に `release-x-y-z` branchを `main` から作成する。\n3. sprint goalを定義する。\n4. Ready ticketを選択する。\n5. dependency \u002F stack候補 \u002F capacityを確認する。中長期capacity判断では `agent-delivery-estimation` のcurrent evidence \u002F bottleneck \u002F forecast statusを参照する。\n6. ticketごとにnumber-only branchを作る。\n7. 最初のmeaningful commitをremoteへpublishし、remote head SHA一致を確認した直後にPRを必ず作成し、metadataとstateを設定する。active\u002FincompleteならDraft、readiness条件を満たしていればReady for reviewとする。\n8. isolated workerをdependency\u002FWIP制約内で並行起動する。\n9. independent ticketまたはstacked ticketをreviewし、current landing candidateを検証する。\n10. ticket\u002FstackをReady + landing可能状態へ持っていく。\n11. ticket-class PRをdependency順にmerge commitで自律landingし、target release trunkへの到達を確認する。\n12. target release trunkへlandしたticketのlinked Issueを明示的にcloseし、dependent PRをreconcileしたうえでsafeならlanded ticket branchを削除する。\n13. repository stateをsweepし、PRなしticket branch \u002F Ready未landing ticket PR \u002F land済みopen Issue \u002F merged後残存ticket branchを修復する。\n14. 週次またはproject-local triggerでrelease review（hold\u002Fcandidate\u002Fblocked）。candidateならscope\u002FSHAをfreeze、候補外landingを保留し、current SHAでrelease gateを実行する。候補変更時は再検証し、Linearをreconcileする。\n15. explicit release-merge authorizationがなければrelease merge前で停止する。authorizationがある場合だけrelease PRを `merge` methodで `main` へmergeし、merge commit \u002F resulting `main` SHAを確認する。\n16. project-local release contractに従い、version tag \u002F GitHub Release \u002F package \u002F deploy \u002F store artifact等のpublication処理を実行する。release PR mergeだけでrelease completeとしない。\n17. publication artifactをprovider\u002FAPIから再取得し、expected version・expected release SHA・draft\u002Fprerelease state・artifact availabilityを検証する。publicationが欠落・stale・別SHAならrelease blockerとして閉じるまで継続する。\n18. publication\u002Fpost-release verification完了後、safeならmerged release branchを削除する。\n19. 候補外の未完了ticket\u002Fstackは次releaseへ明示的にretarget\u002Frebaseし、dependencyとvalidationをreconcileする。release後はpublication済み `main` を基準に次のrelease trainを開始する。\n\n## Release publication invariant\n\n`release-x-y-z -> main` のrelease PR mergeはintegration完了であり、publication完了そのものではない。\n\nprojectごとに「何が存在すればreleasedか」をproject-local release contractとして定義する。対象例:\n\n- semantic version tag\n- GitHub Release\n- package registry artifact\n- deploy \u002F environment promotion\n- desktop\u002Fmobile installer・store artifact\n- checksum \u002F provenance \u002F attestation\n\n最低限のinvariant:\n\n- expected versionとrelease merge commit \u002F release source SHAの対応を固定する\n- publication automationは再実行しても安全なidempotent operationにする\n- existing tag\u002Fartifactがexpected SHAと異なる場合は上書きせずfail closedする\n- merge成功を根拠にpublication成功を推定しない\n- publish command \u002F workflow successだけで完了せず、provider\u002FAPIからartifactを再取得して実在とidentityを確認する\n- GitHub Releaseを採用するrepositoryではdraft \u002F prerelease状態もrelease contractに含める\n- publicationが人手・権限・store review等に依存する場合は、integration complete \u002F publication pendingを別状態として報告する\n\npost-merge verificationでpublication artifactが存在しない、expected release SHAを指さない、またはrequired artifactが利用不能ならreleaseは未完了として扱う。\n\n## Ticket branch\n\n原則、1 top-level Issueにつき1 durable ticket branchを作る。\n\ncanonical format:\n\n`\u003Cissue-number>`\n\n例:\n\n- `123`\n- `418`\n- `1024`\n\nbranch名に `issue\u002F` prefix、slug、title、type等を追加しない。\n\nnested workerが返すephemeral immutable ref\u002Fcommitはこの命名規則の対象外でよい。\n\n## Branch creation and PR creation are one start procedure\n\n**active durable ticket branchにはpublished remote headとPRを必ず持たせ、PR stateを実際の作業状態と一致させる。**\n\nGitHubはremoteで解決できないheadやbaseと差分のないbranchにはPRを作れないため、canonical sequenceは次の通り:\n\n1. durable branchを作成する\n2. 最初のmeaningful commitを直ちに作る\n3. そのcommitをcanonical remoteへpublishする\n4. remote branch head SHAがpublishしたcommit SHAと一致することを確認する\n5. PRを直ちに作る。active\u002FincompleteならDraft、readiness条件を満たしていればReady for reviewとする\n6. published commit + PRがない状態でactive implementationを継続しない\n\n「後でpushする」「後でPRを作る」は禁止する。\n\nこのruleはhuman \u002F Coordinator \u002F implementation worker \u002F subagentのすべてに適用する。\nsubagentがdurable branchを作る権限を持つ場合、そのsubagent自身がpublish + remote head検証 + PR作成\u002Fstate設定まで完了する。remote publicationまたはPR mutation権限がないworkerはfirst meaningful commit後ただちにSupervisor\u002FCoordinatorへcontrolを返し、Supervisor\u002FCoordinatorがcommit publication・remote head SHA確認・PR作成\u002Fstate設定を完了するまで追加implementationを進めない。\n\nEphemeral immutable worker ref\u002Fresultはdurable branchではないため対象外。\n\n## PR metadata is required state\n\nPRはdiffだけではなくdurable work stateである。ただし、durable stateとPR proseを同一視しない。\n\n作成時にrepository evidenceからnative GitHub metadataを評価し、最低限次を設定する。\n\n- linked Issue。number-only ticket branch `\u003Cissue-number>` ではPR本文に `Closes #\u003Cissue-number>`（cross-repositoryならqualified reference）または同等のnative linked-Issue relationを必須とし、PRから対応Issueを一意に再発見できるようにする。ただしnon-default release trunkへのlandingでは自動closeに依存せず、landing確認後にIssueを明示closeする\n- accountable assignee\n- reviewer request \u002F CODEOWNERS-derived reviewer\n- repositoryで定義済みの適切なlabels\n- target release branch\n- stacked PRならstack trunk \u002F immediate predecessor \u002F relevant successor context\n\nPR bodyはreviewerがchangeを理解・評価するためのartifactとして書く。必要に応じて次を含める。\n\n- purpose \u002F intended outcome\n- implementation summary\n- acceptance criteriaまたはその参照\n- non-obvious design decision \u002F constraint\n- review判断に必要なvalidation evidence\n- merge後も意味を持つlimitation \u002F migration \u002F compatibility note\n\ncurrent head SHA、ahead\u002Fbehind、bot status、branch同期履歴、tool invocation、trial-and-error等を、作業contextに存在するという理由だけでPR bodyへ転写しない。GitHub checks、branch state、review status等のmutable stateはnative surfaceをcanonicalにし、proseへ重複させるのはreader判断に必要な場合だけにする。\n\nownership、scope、stack position、review requirementが変わった場合はmetadataも更新する。\n\n存在しないlabelを勝手に作る、関係のないreviewerを形式的に指定する、PR author自身を自己reviewerとして埋める、という運用はしない。meaningful reviewer不在をPR bodyへ自動記録せず、それがreview\u002Fmerge semanticsの理解に必要な場合だけ説明する。\n\nPR title\u002Fbody\u002Freview discussionには `writing-discipline` を適用し、Select -> Compose -> Rereadを経てreader-oriented proseへ整える。\n\nIssue\u002FPR title\u002Fbody\u002Freview discussionは日本語を標準とする。\n\n## Independent ticket PR\n\nhard predecessorを持たないticketはtarget release branchをdirect baseにする。\n\n```text\nmain\n└─ release-x-y-z\n   └─ 123\n```\n\nPR:\n\n`123 -> release-x-y-z`\n\n## Dependency-aware stacked PR\n\n同一repository・同一target release内でlinear hard dependencyを持つtop-level Issuesはstacked PRを使用してよい。\n\n```text\nmain\n└─ release-x-y-z\n   └─ 123\n      └─ 124\n         └─ 125\n```\n\nPR:\n\n- `123 -> release-x-y-z`\n- `124 -> 123`\n- `125 -> 124`\n\n全ticketはtarget release `release-x-y-z` を共通stack trunkとして持つ。\n\nStack eligibility:\n\n- same repository\n- same target release\n- real hard dependency\n- stacked segmentがordered chainとして表現可能\n- predecessorにreviewable immutable commit\u002Fsnapshotが存在\n\nIssue dependency graphがbranchする場合、無理に1本のlinear stackへ変換しない。\nPR stackはIssue dependency graphのlinear pathをexecution\u002Fintegration topologyへprojectionしたものにすぎない。\n\n`1 top-level Issue = 1 durable ticket branch = 1 ticket PR` はstackでも維持する。\n1 Issueを細切れのdurable PRへ分割するためだけにstackを使わない。\n\n## Stack-ready execution\n\npredecessorがrelease branchへ未mergeでも、reviewable immutable snapshotが存在すればdependent ticketを開始してよい。\n\n開始時に少なくとも以下をpinする:\n\n- predecessor Issue\u002FPR identity\n- predecessor commit SHA \u002F immutable snapshot\n- common target release\n- immediate PR base\n\npredecessor reviewで変更が入った場合、downstreamをdependency orderでrebase\u002Fupdateし、影響したrequired validationを再実行する。\n\n古いgreen resultを異なるSHAへ流用しない。\n\n## Ready for review\n\nDraftは未完了作業の一時状態である。次の条件をすべて満たしたopen PRは、userの明示指示を待たず速やかにReady for reviewへ移す。PR作成時点ですでに条件を満たす場合は最初からReadyとして作成し、形式的なDraft -> Ready往復を行わない:\n\n\n- Issue acceptance criteriaを実装済み\n- current SHAに対するticket-level integration quality gateを実行済み\n- blocking known issueが解消済み、または明示的にscope外\n- PR description \u002F assignee \u002F labels \u002F reviewer metadataが現在の実装と一致\n- required reviewerをrequest済み。meaningful reviewer不在はreview\u002Fmerge semanticsへ影響する場合だけreaderに必要な形で説明し、mutable stateとして恒常的にserializeしない\n- target release branchまたはimmediate stack predecessorとのstaleness\u002Fconflictを処理済み\n- predecessor変更によるdownstream revalidationを処理済み\n\n## Ticket landing \u002F Done\n\nIssueのDone条件:\n\n- acceptance criteria satisfied\n- current landing candidateに対するapplicable project validationを実行済みで、既知の失敗を残していない\n- blocking review \u002F conversation resolved\n- release\u002Fstack staleness handled\n- ticket changesがtarget release trunkへland済み\n- linked Issue explicitly closed after successful trunk landing\n\nindependent ticketでは通常のticket PR mergeがそのままtarget release trunkへのlandingになる。readiness\u002Fquality gateを満たしreal blockerがなければ、追加のuser merge authorizationを待たずmerge commitでlandingする。\n\nGitHub native stacked PR等のplatform featureは実装手段として使えるが、policy semanticsをpreview feature固有の挙動に依存させない。\n\nnative stacked PRもticket-classとして自律landingできる。stackはbottom（trunkに最も近いPR）からdependency順に扱い、実際にlandingするcontiguous setの各ticketがacceptance criteria \u002F review \u002F current-SHA validationを満たしていることを確認する。mid-stack PRだけをintermediate predecessor branchへ孤立してmergeしたものをDone boundaryとして扱わない。\n\nnative stack landingを使えずordinary nested PRへfallbackする場合、例えば `124 -> 123` の通常mergeはintermediate integrationにすぎない。#124のchangesがtarget `release-x-y-z` へ到達するまでIssue #124をclose\u002FDoneにしない。\n\ncontiguous stack groupまたはstack全体を一括landingする場合、含まれるすべてのticketが個別にacceptance criteria \u002F review \u002F current-SHA validationを満たしていることを確認する。landing後に各GitHub Issueを明示的にreconcileする。Linearはticketを全面mirrorしないため、release-level stateだけを必要に応じてreconcileする。\n\n`main`へのmergeをIssue単位のDone条件にはしない。Issue Done boundaryはtarget release trunkである。\n\nGitHubのclosing keywordはdefault branch向けPRでのみ自動closeに使えるため、release trunkへのlanding成功確認後にCoordinatorまたはdelivery automationがIssueを明示的にcloseする。\n\n### Post-landing reconciliation \u002F branch cleanup\n\ntarget release trunk landing後は次を同じticket operationとして実行する。\n\n1. ticket changesがtarget release branchからreachableであることを確認する\n2. linked GitHub Issueをcompletedとして明示closeする\n3. downstream\u002Fopen PRがlanded ticket branchをbase\u002Fheadとして使用していないか確認する\n4. dependencyがあればsurviving baseへretarget\u002Frebaseし、affected validationを再実行する\n5. dependencyがなくなったlanded ticket branchをremoteから削除する\n\nIssue closeやbranch cleanupを「後で行う任意housekeeping」にしない。削除権限\u002FAPIが利用できない場合はcleanup debtをdurableに残してblocker\u002Flimitationとして報告するが、黙ってstale branchを正常状態にしない。\n\n### Repository lifecycle reconciliation\n\nrecovery、onboarding、task completion時にremote branch \u002F open+merged PR \u002F Issue stateを突き合わせ、最低限次を修復する。\n\n- meaningful unlanded changesを持つnon-release durable branchにPRがない -> intended Issue\u002Fbase\u002Fstackをrepository evidenceから復元してPRを作成\n- Draftだがreadiness gate済み -> Readyへ遷移\n- Ready ticket PRにreal blockerがない -> autonomous landing\n- target release trunkへland済みだがIssue open -> explicit close\n- landed\u002Fmerged ticket branchが残存 -> dependency確認後delete\n- release PRがbulk\u002Fautonomous landing候補へ混入 -> 除外\n\nintended baseを安全に復元できない等、本当に解けない場合だけblockerとして残す。\n\n## Release integration\n\nrelease branchは複数ticketの統合結果を保持するrelease train integration lineであり、1週間のplanning windowと1:1ではない。\n\nrelease branchはrelease train開始時に作成する。GitHubは`main`と差分がない状態ではPRを作れないため、release branchに最初のmeaningful integrated differenceが入った直後にDraft release PRを作成する。zero-diff release branchだけはDraft PR invariantの例外である。\n\nDraft release PRにもassignee \u002F reviewer \u002F labels \u002F release goal \u002F included Issuesを設定し、release期間中維持する。release readiness条件を満たしたらDraftのまま残さずReady for reviewへ遷移する。validationのmutable stateはGitHub checks等のcanonical surfaceで追跡し、PR proseにはrelease判断に必要な意味だけを書く。\n\nrelease候補を選択しscope\u002Fcurrent SHAをfreezeした後、release branch上でfull applicable quality gateを実行する。freeze中の新規ticket landingは禁止し、修正でSHAが変わった場合はapplicable gateを再実行する（[candidate review](.\u002Freferences\u002Fadaptive-release-batching.md)）。\n\nrelease PR:\n\n`release-x-y-z -> main`\n\n最低限:\n\n- release goal\n- included Issues\u002FPRs\n- breaking changes\n- migration notes\n- release判断に必要なverification scope \u002F evidence。CIのあるrepositoryではnative checksを正本とし、本文にはreaderが再確認に必要な時だけpointerを置く。CIのないrepositoryでは、検証したSHAと、controlを再実行するcommandを書く\n- durable known limitations\n- version\u002Frelease metadata\n\npublic repositoryでは`main` protectionにより、このrelease PR以外の経路で`main`を更新できない状態を維持する。\n\nrelease gate成功はrelease PRをready-to-mergeにするquality evidenceであり、release merge authorizationではない。release PRはbulk\u002Fautonomous ticket landingとauto-mergeから除外する。genericなmerge\u002Fcleanup\u002Ffinish指示ではreleaseをmergeしない。current interactionで対象release PR\u002Factionへのexplicit authorizationがなければReadyまで整えて停止し、current head SHA \u002F release gate \u002F blockersを報告する。authorizationがある場合だけ、直前にactual head\u002Fbase\u002Fcurrent SHAを再取得して `base == main` かつ `head == intended current release-*` を確認し、`merge` methodでmergeする。\n\nrelease PRがmergeされた時点で `main` がそのversionのreleased source stateになる。\n\nrelease PR merge後もtag \u002F deploy \u002F package \u002F store等のproject-defined actual availabilityを確認し、final Linear Project Update \u002F `Released` checkpointを反映してからLinear ProjectをCompletedへ進める。\n\n## Version \u002F tag-triggered release consistency\n\nversionはSemantic Versioning `MAJOR.MINOR.PATCH` をcanonical formとする。external ecosystem上の明確な理由がない限り省略形式を使わない。\n\ntag pushをpublish\u002Frelease triggerとして使用するprojectでは、tag versionとauthoritative package\u002Fproject versionを必ず一致させる。\n\n例:\n\n- tag: `v1.4.2`\n- authoritative version: `1.4.2`\n\nrelease automationは不一致を自動修正して続行せずfailする。\n\nconditional minimum sequence:\n\n1. tag format validation\n2. semantic version extraction\n3. authoritative version comparison\n4. current release SHAに対するfull applicable release gate\n5. release build\u002Fpackage\n6. successful validation後のみpublish\u002Frelease\n\n複数release unitを持つprojectではauthoritative version sourceまたはunitごとのversion policyを明示する。\n\nadaptive release branch modelとtag releaseは競合しない。release branch\u002FPRがsource delivery、tag\u002Fpublishがartifact deliveryに使われる場合、両者が同じintended version\u002FSHAを指すことを検証する。\n\n## Multi-agent integration\n\n- 1 top-level Issue = 1 ticket branch = 1 ticket PRを基本とする。\n- independent ticket PR base = target `release-x-y-z`。\n- stacked dependent ticket PR base = immediate predecessor ticket branch。\n- all stack members share one target release trunk。\n- implementation workerはticket branchを複数agentで直接共有しない。\n- nested workerはresolved immutable identityへpinされたcommit\u002Fref resultを返す。\n- durable branchを作るworker\u002Fsubagentにはremote publication + PR creation\u002Fstate \u002F metadata contractも適用する。\n- Coordinator\u002FSupervisorだけがorchestrated shared durable integration stateへ順序立てて統合する。\n- ticket-class landingはreadiness\u002Fquality gate通過後に追加authorizationなしで進める。\n- release-class landingだけexplicit user authorizationを要求する。\n- merge\u002Flanding前にtarget release \u002F predecessor \u002F current validation SHA \u002F actual head+base classificationを確認する。\n- Doneへ移す前にactual target release trunk上のlandingを確認し、Issue close + safe branch cleanupまでreconcileする。\n- `main` protection\u002Frulesetを上記baselineで初期化・検証し、merge executorはrelease-only main source invariantを確認する。\n\n## Language policy\n\n- Issue title\u002Fbody: 日本語\n- PR title\u002Fbody\u002Freview discussion: 日本語\n- internal planning docs: 日本語\n- commit message: 英語\n- source code: 英語\n\ncommit format:\n\n`\u003Cwork-prefix>: \u003Cextremely concise title>`\n\n\n## Refinement boundary\n\nGitHub delivery topologyを変更する場合、最低限次を維持する。\n\n- durable work identityとdependencyを別actorから再発見できる\n- integration candidateとvalidation\u002Freview evidenceを対応付けられる\n- current\u002Freleased source stateのcanonical authorityが曖昧にならない\n- consequential landingのauthority boundaryが維持される\n- interrupted workをconversation historyなしでreconcileできる\n- valid workがdelivery ceremonyだけで不必要に停止しない\n\nbranch名、PR creation\u002Fstate timing、release branch cadence等はcurrent profileのdefaultであり、上位guaranteeを満たすalternativeを一律に禁止しない。\n","# GitHub Delivery\n\nLayer: **Operating Model + Practice**\n\nこのSkillはcurrent release-driven profileのGitHub materializationを定義する。Issue \u002F PR \u002F branch \u002F PR state lifecycleそのものはConstitutionではない。\n\n重要なのは、durable implementation identity、reviewable evidence、canonical consistency、authority boundary、organizational continuityを維持すること。将来別platform\u002Ftopologyがこれらを同等以上に満たす場合は置換できる。\n\n## Source of Truth\n\n- released source state: `main`\n- active sprint\u002Frelease integration state: `release-x-y-z`\n- durable implementation work state: GitHub Issues\n- dependency state: GitHub Issue dependency metadata\n- release planning \u002F health \u002F portfolio state: Linear Projects \u002F Initiatives\n- ticket review\u002Fintegration: Pull Requests\n- transient execution state: Supervisor\n\n`main` はリリース済み・統合済みの安定状態を表す。\n通常のticket PRを直接 `main` へ向けない。\n\n## Landing authority boundary\n\nPR landing前にcurrent PRを再取得し、actual head\u002Fbaseから **ticket-class \u002F release-class** を分類する。\n\n### Ticket-class\n\n- `base != main`\n- current ticket\u002Frelease integration topologyに属する\n- 通常はticket branch -> target `release-*`、またはdependent ticket -> immediate predecessor ticket branch\n\nticket-class PRはper-PR user merge authorizationを要求しない。acceptance criteria、current-SHA validation、blocking review\u002Fconversation、staleness等のapplicable readiness\u002Fquality gateを満たしreal blockerがなければ、Agent\u002FCoordinatorはready-to-mergeで停止せずlandingまで進める。ただしrelease candidate freeze中は同じrelease trunkへの候補外ticketの自律landingを保留し、実装・reviewは継続できる（ADR-0032）。\n\nstandaloneではAgent \u002F subagent \u002F Coordinator \u002F Supervisorがticket landingを実行できる。parallel-orchestration下でshared durable integration stateへのordered landingが必要な場合はCoordinator \u002F Supervisorがlandingを実行し、worker\u002Fsubagentはvalidated candidateをhandoffする。\n\n### Release-class\n\n- `base == main`\n- `head == current release-*`\n\nrelease-class PRだけはexplicit user authorizationを必要とする。Ready\u002Fmergeable、green validation、approval、ticket PRへのstanding autonomous landing authority、genericな `readyなPRをmerge` \u002F `cleanup` \u002F `最後まで進めて` 等からrelease authorizationを推定しない。\n\nrelease PRはbulk\u002Fautonomous ticket landingとauto-mergeから常に除外する。userがcurrent interactionで対象release PRまたは明確なrelease actionをexplicitにauthorizeした場合だけmergeできる。authorization後もcurrent head\u002Fbase\u002FSHAを再取得し、materialにcandidateが変化していればauthorization applicabilityを再確認する。\n\n`base == main` かつheadがcurrent release branchでないPRはinvalid integration pathとしてlandingを拒否する。\n\nquality gateは「candidateがlanding可能な品質か」を判定する。ticket-classではその成功後に自律landingへ進み、release-classでは別途explicit authorization gateを要求する。ticket authorityをrelease authorityへ伝播させない。\n\n## Pull Request merge method\n\ncurrent release-driven profileでは、GitHub PR landingは **merge commit (`merge`) のみ**（ADR-0018）。repository settingsは `allow_merge_commit=true` \u002F `allow_squash_merge=false` \u002F `allow_rebase_merge=false` へreconcileし、権限不足なら差分をblocker\u002Flimitationとして報告する。Agent \u002F automationはmerge APIでmethodを暗黙選択せず `merge` を明示する。\n\nsquash merge \u002F rebase mergeは使用しない。branch-local `git rebase` はstack maintenance \u002F conflict解消のbranch mechanicsとして許可する。stack landingがmerge commit semanticsを保証できない場合はordered merge-commit landingへfallbackする。method固定からauthorizationを導出しない。\n#### Orchestrated workflow landing boundary\n\n`parallel-orchestration` の execution model 下では、Agent \u002F subagent \u002F worker は **target release integration branch (`release-x-y-z`) や `main` への shared durable integration state への ordered landing を直接実行しない**。landing は Coordinator \u002F Supervisor が durable integration の責務として行う。\n\n- ticket-class candidateはreadiness\u002Fquality gate通過後、追加authorizationなしでCoordinator \u002F Supervisorへlanding handoffする。\n- release-class candidateはexplicit user authorization scopeもhandoff artifactへ含め、Coordinator \u002F Supervisorはcurrent refs\u002FSHAとauthorization applicabilityを再検証してからlandingする。\n- standaloneでrelease PRを扱うAgentは、explicit release authorizationがある場合に限り直接landingできる。\n\nこの境界を越えてworker\u002Fsubagentがshared durable integration stateへlandingした場合、resultはstale candidateとして扱いreconciliationする。\n\n## Main protection \u002F release-only integration\n\nGitHub上で保護機能を利用できるrepositoryでは、`main` をbranch protection \u002F rulesetで保護する。\n\n標準baseline:\n\n- `main`変更にはPull Requestを必須とする\n- required approving review countは **0** とし、個人開発で自己approvalを要求しない\n- conversation resolutionを必須とし、未解決review conversationを残したままmergeしない\n- required status checksは **既定で設定しない**。存在しないCI\u002Fcheck名を推測・固定してmergeを停止させない\n- CIが存在する場合はquality evidenceとして確認するが、branch protectionの固定required checkとは分離する\n- direct push \u002F direct web edit \u002F force push \u002F deletionを通常運用で許可しない\n- normal actor\u002Fadminが保護を日常的にbypassする運用を作らない\n- `main`への正規delivery pathは current `release-x-y-z -> main` release PRだけとする\n- ticket branch \u002F arbitrary branchから`main`へ向いたPRはmerge対象にしない\n\nGitHubの標準branch protection\u002FrulesetではPR head branch patternを直接制約できないため、存在しないrequired status checkを捏造して補わない。source branch制約はproject policy \u002F release automation \u002F merge executorで検証し、`base == main` かつ `head == current release-*` でないPRのmergeを拒否する。既にrepository固有の信頼できるguardが存在する場合は利用できるが、そのcheck名を他projectへ固定継承しない。\n\nreadiness reportでは `ruleset enforced` と `merge-executor policy enforced` を区別する。外部guardがない場合、GitHub UIで任意headからのPR mergeを完全に禁止できるとは報告しない。Agentがmerge APIを呼ぶ直前には必ずbase\u002Fheadを再取得してpreflightする。\n\n初期化時にrepositoryのmain protection\u002Frulesetを実際に確認する。設定変更権限がある場合は上記baselineへ作成・修復し、権限がない場合は差分をblockerとして報告する。\n\n## Weekly planning \u002F adaptive release batching\n\n週次はplanning checkpointであり公開日ではない。1 release train = 1 target version = 1 release branchを維持し、週内の早期release・複数週への持ち越しを許容する（ADR-0032）。\n\nversionは変更の意味・互換性・user指定に従う。major\u002Fminor\u002Fpatchは公開意図から選び、週次境界だけでbumpしない。\n\ncanonical format:\n\n`release-\u003Cmajor>-\u003Cminor>-\u003Cpatch>`\n\nrelease train開始時に`main`からbranchを切る。緊急patchもrelease PRを経由する。候補はscope・公開価値・滞留・変更リスク・release-only実測コストで判定し、PR数だけで決めない。freezeとcarry-overは [adaptive-release-batching.md](.\u002Freferences\u002Fadaptive-release-batching.md) に従う。\n\n### Delivery forecast \u002F capacity\n\n1週間はplanning cadenceであり、選んだscopeが必ず1週間で完了するというestimateではない。\n\nrelease \u002F roadmap \u002F milestoneの完了時期、release date、capacity、carry-over、agent数変更による短縮効果を判断する場合は `agent-delivery-estimation` Skillを使用する。\n\n- IssueのSizeをcalendar durationとして扱わない\n- AI自身の「数日・数ヶ月」という主観的estimateをrelease dateの根拠にしない\n- dependency graph、Work Unit、observed throughput、human review capacity、CI\u002Fexternal wait、usage limitを使う\n- material unknownがある場合は `complete \u002F conditional \u002F unavailable` を維持し、日付を捏造してfieldを埋めない\n- sprintごとの実績を次のforecast calibrationへ戻す\n\n## Issue\n\ndurable planning unitは原則GitHub Issueにする。\n\nIssueのtitle\u002Fbodyは日本語を標準とする。\n\n最低限、該当するものを明示する:\n\n- 目的 \u002F user-visible outcome\n- acceptance criteria\n- scope \u002F non-scope\n- dependency \u002F blocked-by\n- priority\n- size\n- area\u002Fcomponent\n- target version\n- release date\n- accountable assignee\n\n短命なresearch\u002Fworker subtaskまでIssue化する必要はない。\n\nIssue dependency graphはcanonical dependency SoTであり、Git branch topologyだけでdependencyを表現しない。\n\n## Linear planning control plane\n\nrelease planning \u002F health \u002F portfolio はLinearへ統一する。GitHub Projectsは標準運用では作成・要求・同期しない。\n\n- GitHub Issues: implementation scope \u002F acceptance criteria \u002F dependency の durable SoT\n- GitHub PR: review \u002F integration \u002F validation evidence\n- Linear Project \u002F Initiative: release goal \u002F target date \u002F health \u002F portfolio\n- Linear Issue: cross-repository blockerやexternal dependencyなどrelease-level coordinationに限定\n\nGitHub IssueをLinear Issueへ全面mirrorしない。詳細は `linear-release-control` Skillに従う。\n\nDependency execution上は必要に応じて `blocked` \u002F `stack-ready` \u002F `integrated` を区別するが、GitHub ProjectsのStatus fieldを前提にしない。\n\n## Sprint \u002F release cycle\n\n1. 週次planning windowを置き、release intent \u002F scopeとtarget versionを決める。release dateは `agent-delivery-estimation` のevidence-backed forecastまたは外部deadlineと区別する。週次終了自体はpublication triggerにしない。\n2. 新しいrelease trainの開始時に `release-x-y-z` branchを `main` から作成する。\n3. sprint goalを定義する。\n4. Ready ticketを選択する。\n5. dependency \u002F stack候補 \u002F capacityを確認する。中長期capacity判断では `agent-delivery-estimation` のcurrent evidence \u002F bottleneck \u002F forecast statusを参照する。\n6. ticketごとにnumber-only branchを作る。\n7. 最初のmeaningful commitをremoteへpublishし、remote head SHA一致を確認した直後にPRを必ず作成し、metadataとstateを設定する。active\u002FincompleteならDraft、readiness条件を満たしていればReady for reviewとする。\n8. isolated workerをdependency\u002FWIP制約内で並行起動する。\n9. independent ticketまたはstacked ticketをreviewし、current landing candidateを検証する。\n10. ticket\u002FstackをReady + landing可能状態へ持っていく。\n11. ticket-class PRをdependency順にmerge commitで自律landingし、target release trunkへの到達を確認する。\n12. target release trunkへlandしたticketのlinked Issueを明示的にcloseし、dependent PRをreconcileしたうえでsafeならlanded ticket branchを削除する。\n13. repository stateをsweepし、PRなしticket branch \u002F Ready未landing ticket PR \u002F land済みopen Issue \u002F merged後残存ticket branchを修復する。\n14. 週次またはproject-local triggerでrelease review（hold\u002Fcandidate\u002Fblocked）。candidateならscope\u002FSHAをfreeze、候補外landingを保留し、current SHAでrelease gateを実行する。候補変更時は再検証し、Linearをreconcileする。\n15. explicit release-merge authorizationがなければrelease merge前で停止する。authorizationがある場合だけrelease PRを `merge` methodで `main` へmergeし、merge commit \u002F resulting `main` SHAを確認する。\n16. project-local release contractに従い、version tag \u002F GitHub Release \u002F package \u002F deploy \u002F store artifact等のpublication処理を実行する。release PR mergeだけでrelease completeとしない。\n17. publication artifactをprovider\u002FAPIから再取得し、expected version・expected release SHA・draft\u002Fprerelease state・artifact availabilityを検証する。publicationが欠落・stale・別SHAならrelease blockerとして閉じるまで継続する。\n18. publication\u002Fpost-release verification完了後、safeならmerged release branchを削除する。\n19. 候補外の未完了ticket\u002Fstackは次releaseへ明示的にretarget\u002Frebaseし、dependencyとvalidationをreconcileする。release後はpublication済み `main` を基準に次のrelease trainを開始する。\n\n## Release publication invariant\n\n`release-x-y-z -> main` のrelease PR mergeはintegration完了であり、publication完了そのものではない。\n\nprojectごとに「何が存在すればreleasedか」をproject-local release contractとして定義する。対象例:\n\n- semantic version tag\n- GitHub Release\n- package registry artifact\n- deploy \u002F environment promotion\n- desktop\u002Fmobile installer・store artifact\n- checksum \u002F provenance \u002F attestation\n\n最低限のinvariant:\n\n- expected versionとrelease merge commit \u002F release source SHAの対応を固定する\n- publication automationは再実行しても安全なidempotent operationにする\n- existing tag\u002Fartifactがexpected SHAと異なる場合は上書きせずfail closedする\n- merge成功を根拠にpublication成功を推定しない\n- publish command \u002F workflow successだけで完了せず、provider\u002FAPIからartifactを再取得して実在とidentityを確認する\n- GitHub Releaseを採用するrepositoryではdraft \u002F prerelease状態もrelease contractに含める\n- publicationが人手・権限・store review等に依存する場合は、integration complete \u002F publication pendingを別状態として報告する\n\npost-merge verificationでpublication artifactが存在しない、expected release SHAを指さない、またはrequired artifactが利用不能ならreleaseは未完了として扱う。\n\n## Ticket branch\n\n原則、1 top-level Issueにつき1 durable ticket branchを作る。\n\ncanonical format:\n\n`\u003Cissue-number>`\n\n例:\n\n- `123`\n- `418`\n- `1024`\n\nbranch名に `issue\u002F` prefix、slug、title、type等を追加しない。\n\nnested workerが返すephemeral immutable ref\u002Fcommitはこの命名規則の対象外でよい。\n\n## Branch creation and PR creation are one start procedure\n\n**active durable ticket branchにはpublished remote headとPRを必ず持たせ、PR stateを実際の作業状態と一致させる。**\n\nGitHubはremoteで解決できないheadやbaseと差分のないbranchにはPRを作れないため、canonical sequenceは次の通り:\n\n1. durable branchを作成する\n2. 最初のmeaningful commitを直ちに作る\n3. そのcommitをcanonical remoteへpublishする\n4. remote branch head SHAがpublishしたcommit SHAと一致することを確認する\n5. PRを直ちに作る。active\u002FincompleteならDraft、readiness条件を満たしていればReady for reviewとする\n6. published commit + PRがない状態でactive implementationを継続しない\n\n「後でpushする」「後でPRを作る」は禁止する。\n\nこのruleはhuman \u002F Coordinator \u002F implementation worker \u002F subagentのすべてに適用する。\nsubagentがdurable branchを作る権限を持つ場合、そのsubagent自身がpublish + remote head検証 + PR作成\u002Fstate設定まで完了する。remote publicationまたはPR mutation権限がないworkerはfirst meaningful commit後ただちにSupervisor\u002FCoordinatorへcontrolを返し、Supervisor\u002FCoordinatorがcommit publication・remote head SHA確認・PR作成\u002Fstate設定を完了するまで追加implementationを進めない。\n\nEphemeral immutable worker ref\u002Fresultはdurable branchではないため対象外。\n\n## PR metadata is required state\n\nPRはdiffだけではなくdurable work stateである。ただし、durable stateとPR proseを同一視しない。\n\n作成時にrepository evidenceからnative GitHub metadataを評価し、最低限次を設定する。\n\n- linked Issue。number-only ticket branch `\u003Cissue-number>` ではPR本文に `Closes #\u003Cissue-number>`（cross-repositoryならqualified reference）または同等のnative linked-Issue relationを必須とし、PRから対応Issueを一意に再発見できるようにする。ただしnon-default release trunkへのlandingでは自動closeに依存せず、landing確認後にIssueを明示closeする\n- accountable assignee\n- reviewer request \u002F CODEOWNERS-derived reviewer\n- repositoryで定義済みの適切なlabels\n- target release branch\n- stacked PRならstack trunk \u002F immediate predecessor \u002F relevant successor context\n\nPR bodyはreviewerがchangeを理解・評価するためのartifactとして書く。必要に応じて次を含める。\n\n- purpose \u002F intended outcome\n- implementation summary\n- acceptance criteriaまたはその参照\n- non-obvious design decision \u002F constraint\n- review判断に必要なvalidation evidence\n- merge後も意味を持つlimitation \u002F migration \u002F compatibility note\n\ncurrent head SHA、ahead\u002Fbehind、bot status、branch同期履歴、tool invocation、trial-and-error等を、作業contextに存在するという理由だけでPR bodyへ転写しない。GitHub checks、branch state、review status等のmutable stateはnative surfaceをcanonicalにし、proseへ重複させるのはreader判断に必要な場合だけにする。\n\nownership、scope、stack position、review requirementが変わった場合はmetadataも更新する。\n\n存在しないlabelを勝手に作る、関係のないreviewerを形式的に指定する、PR author自身を自己reviewerとして埋める、という運用はしない。meaningful reviewer不在をPR bodyへ自動記録せず、それがreview\u002Fmerge semanticsの理解に必要な場合だけ説明する。\n\nPR title\u002Fbody\u002Freview discussionには `writing-discipline` を適用し、Select -> Compose -> Rereadを経てreader-oriented proseへ整える。\n\nIssue\u002FPR title\u002Fbody\u002Freview discussionは日本語を標準とする。\n\n## Independent ticket PR\n\nhard predecessorを持たないticketはtarget release branchをdirect baseにする。\n\n```text\nmain\n└─ release-x-y-z\n   └─ 123\n```\n\nPR:\n\n`123 -> release-x-y-z`\n\n## Dependency-aware stacked PR\n\n同一repository・同一target release内でlinear hard dependencyを持つtop-level Issuesはstacked PRを使用してよい。\n\n```text\nmain\n└─ release-x-y-z\n   └─ 123\n      └─ 124\n         └─ 125\n```\n\nPR:\n\n- `123 -> release-x-y-z`\n- `124 -> 123`\n- `125 -> 124`\n\n全ticketはtarget release `release-x-y-z` を共通stack trunkとして持つ。\n\nStack eligibility:\n\n- same repository\n- same target release\n- real hard dependency\n- stacked segmentがordered chainとして表現可能\n- predecessorにreviewable immutable commit\u002Fsnapshotが存在\n\nIssue dependency graphがbranchする場合、無理に1本のlinear stackへ変換しない。\nPR stackはIssue dependency graphのlinear pathをexecution\u002Fintegration topologyへprojectionしたものにすぎない。\n\n`1 top-level Issue = 1 durable ticket branch = 1 ticket PR` はstackでも維持する。\n1 Issueを細切れのdurable PRへ分割するためだけにstackを使わない。\n\n## Stack-ready execution\n\npredecessorがrelease branchへ未mergeでも、reviewable immutable snapshotが存在すればdependent ticketを開始してよい。\n\n開始時に少なくとも以下をpinする:\n\n- predecessor Issue\u002FPR identity\n- predecessor commit SHA \u002F immutable snapshot\n- common target release\n- immediate PR base\n\npredecessor reviewで変更が入った場合、downstreamをdependency orderでrebase\u002Fupdateし、影響したrequired validationを再実行する。\n\n古いgreen resultを異なるSHAへ流用しない。\n\n## Ready for review\n\nDraftは未完了作業の一時状態である。次の条件をすべて満たしたopen PRは、userの明示指示を待たず速やかにReady for reviewへ移す。PR作成時点ですでに条件を満たす場合は最初からReadyとして作成し、形式的なDraft -> Ready往復を行わない:\n\n\n- Issue acceptance criteriaを実装済み\n- current SHAに対するticket-level integration quality gateを実行済み\n- blocking known issueが解消済み、または明示的にscope外\n- PR description \u002F assignee \u002F labels \u002F reviewer metadataが現在の実装と一致\n- required reviewerをrequest済み。meaningful reviewer不在はreview\u002Fmerge semanticsへ影響する場合だけreaderに必要な形で説明し、mutable stateとして恒常的にserializeしない\n- target release branchまたはimmediate stack predecessorとのstaleness\u002Fconflictを処理済み\n- predecessor変更によるdownstream revalidationを処理済み\n\n## Ticket landing \u002F Done\n\nIssueのDone条件:\n\n- acceptance criteria satisfied\n- current landing candidateに対するapplicable project validationを実行済みで、既知の失敗を残していない\n- blocking review \u002F conversation resolved\n- release\u002Fstack staleness handled\n- ticket changesがtarget release trunkへland済み\n- linked Issue explicitly closed after successful trunk landing\n\nindependent ticketでは通常のticket PR mergeがそのままtarget release trunkへのlandingになる。readiness\u002Fquality gateを満たしreal blockerがなければ、追加のuser merge authorizationを待たずmerge commitでlandingする。\n\nGitHub native stacked PR等のplatform featureは実装手段として使えるが、policy semanticsをpreview feature固有の挙動に依存させない。\n\nnative stacked PRもticket-classとして自律landingできる。stackはbottom（trunkに最も近いPR）からdependency順に扱い、実際にlandingするcontiguous setの各ticketがacceptance criteria \u002F review \u002F current-SHA validationを満たしていることを確認する。mid-stack PRだけをintermediate predecessor branchへ孤立してmergeしたものをDone boundaryとして扱わない。\n\nnative stack landingを使えずordinary nested PRへfallbackする場合、例えば `124 -> 123` の通常mergeはintermediate integrationにすぎない。#124のchangesがtarget `release-x-y-z` へ到達するまでIssue #124をclose\u002FDoneにしない。\n\ncontiguous stack groupまたはstack全体を一括landingする場合、含まれるすべてのticketが個別にacceptance criteria \u002F review \u002F current-SHA validationを満たしていることを確認する。landing後に各GitHub Issueを明示的にreconcileする。Linearはticketを全面mirrorしないため、release-level stateだけを必要に応じてreconcileする。\n\n`main`へのmergeをIssue単位のDone条件にはしない。Issue Done boundaryはtarget release trunkである。\n\nGitHubのclosing keywordはdefault branch向けPRでのみ自動closeに使えるため、release trunkへのlanding成功確認後にCoordinatorまたはdelivery automationがIssueを明示的にcloseする。\n\n### Post-landing reconciliation \u002F branch cleanup\n\ntarget release trunk landing後は次を同じticket operationとして実行する。\n\n1. ticket changesがtarget release branchからreachableであることを確認する\n2. linked GitHub Issueをcompletedとして明示closeする\n3. downstream\u002Fopen PRがlanded ticket branchをbase\u002Fheadとして使用していないか確認する\n4. dependencyがあればsurviving baseへretarget\u002Frebaseし、affected validationを再実行する\n5. dependencyがなくなったlanded ticket branchをremoteから削除する\n\nIssue closeやbranch cleanupを「後で行う任意housekeeping」にしない。削除権限\u002FAPIが利用できない場合はcleanup debtをdurableに残してblocker\u002Flimitationとして報告するが、黙ってstale branchを正常状態にしない。\n\n### Repository lifecycle reconciliation\n\nrecovery、onboarding、task completion時にremote branch \u002F open+merged PR \u002F Issue stateを突き合わせ、最低限次を修復する。\n\n- meaningful unlanded changesを持つnon-release durable branchにPRがない -> intended Issue\u002Fbase\u002Fstackをrepository evidenceから復元してPRを作成\n- Draftだがreadiness gate済み -> Readyへ遷移\n- Ready ticket PRにreal blockerがない -> autonomous landing\n- target release trunkへland済みだがIssue open -> explicit close\n- landed\u002Fmerged ticket branchが残存 -> dependency確認後delete\n- release PRがbulk\u002Fautonomous landing候補へ混入 -> 除外\n\nintended baseを安全に復元できない等、本当に解けない場合だけblockerとして残す。\n\n## Release integration\n\nrelease branchは複数ticketの統合結果を保持するrelease train integration lineであり、1週間のplanning windowと1:1ではない。\n\nrelease branchはrelease train開始時に作成する。GitHubは`main`と差分がない状態ではPRを作れないため、release branchに最初のmeaningful integrated differenceが入った直後にDraft release PRを作成する。zero-diff release branchだけはDraft PR invariantの例外である。\n\nDraft release PRにもassignee \u002F reviewer \u002F labels \u002F release goal \u002F included Issuesを設定し、release期間中維持する。release readiness条件を満たしたらDraftのまま残さずReady for reviewへ遷移する。validationのmutable stateはGitHub checks等のcanonical surfaceで追跡し、PR proseにはrelease判断に必要な意味だけを書く。\n\nrelease候補を選択しscope\u002Fcurrent SHAをfreezeした後、release branch上でfull applicable quality gateを実行する。freeze中の新規ticket landingは禁止し、修正でSHAが変わった場合はapplicable gateを再実行する（[candidate review](.\u002Freferences\u002Fadaptive-release-batching.md)）。\n\nrelease PR:\n\n`release-x-y-z -> main`\n\n最低限:\n\n- release goal\n- included Issues\u002FPRs\n- breaking changes\n- migration notes\n- release判断に必要なverification scope \u002F evidence。CIのあるrepositoryではnative checksを正本とし、本文にはreaderが再確認に必要な時だけpointerを置く。CIのないrepositoryでは、検証したSHAと、controlを再実行するcommandを書く\n- durable known limitations\n- version\u002Frelease metadata\n\npublic repositoryでは`main` protectionにより、このrelease PR以外の経路で`main`を更新できない状態を維持する。\n\nrelease gate成功はrelease PRをready-to-mergeにするquality evidenceであり、release merge authorizationではない。release PRはbulk\u002Fautonomous ticket landingとauto-mergeから除外する。genericなmerge\u002Fcleanup\u002Ffinish指示ではreleaseをmergeしない。current interactionで対象release PR\u002Factionへのexplicit authorizationがなければReadyまで整えて停止し、current head SHA \u002F release gate \u002F blockersを報告する。authorizationがある場合だけ、直前にactual head\u002Fbase\u002Fcurrent SHAを再取得して `base == main` かつ `head == intended current release-*` を確認し、`merge` methodでmergeする。\n\nrelease PRがmergeされた時点で `main` がそのversionのreleased source stateになる。\n\nrelease PR merge後もtag \u002F deploy \u002F package \u002F store等のproject-defined actual availabilityを確認し、final Linear Project Update \u002F `Released` checkpointを反映してからLinear ProjectをCompletedへ進める。\n\n## Version \u002F tag-triggered release consistency\n\nversionはSemantic Versioning `MAJOR.MINOR.PATCH` をcanonical formとする。external ecosystem上の明確な理由がない限り省略形式を使わない。\n\ntag pushをpublish\u002Frelease triggerとして使用するprojectでは、tag versionとauthoritative package\u002Fproject versionを必ず一致させる。\n\n例:\n\n- tag: `v1.4.2`\n- authoritative version: `1.4.2`\n\nrelease automationは不一致を自動修正して続行せずfailする。\n\nconditional minimum sequence:\n\n1. tag format validation\n2. semantic version extraction\n3. authoritative version comparison\n4. current release SHAに対するfull applicable release gate\n5. release build\u002Fpackage\n6. successful validation後のみpublish\u002Frelease\n\n複数release unitを持つprojectではauthoritative version sourceまたはunitごとのversion policyを明示する。\n\nadaptive release branch modelとtag releaseは競合しない。release branch\u002FPRがsource delivery、tag\u002Fpublishがartifact deliveryに使われる場合、両者が同じintended version\u002FSHAを指すことを検証する。\n\n## Multi-agent integration\n\n- 1 top-level Issue = 1 ticket branch = 1 ticket PRを基本とする。\n- independent ticket PR base = target `release-x-y-z`。\n- stacked dependent ticket PR base = immediate predecessor ticket branch。\n- all stack members share one target release trunk。\n- implementation workerはticket branchを複数agentで直接共有しない。\n- nested workerはresolved immutable identityへpinされたcommit\u002Fref resultを返す。\n- durable branchを作るworker\u002Fsubagentにはremote publication + PR creation\u002Fstate \u002F metadata contractも適用する。\n- Coordinator\u002FSupervisorだけがorchestrated shared durable integration stateへ順序立てて統合する。\n- ticket-class landingはreadiness\u002Fquality gate通過後に追加authorizationなしで進める。\n- release-class landingだけexplicit user authorizationを要求する。\n- merge\u002Flanding前にtarget release \u002F predecessor \u002F current validation SHA \u002F actual head+base classificationを確認する。\n- Doneへ移す前にactual target release trunk上のlandingを確認し、Issue close + safe branch cleanupまでreconcileする。\n- `main` protection\u002Frulesetを上記baselineで初期化・検証し、merge executorはrelease-only main source invariantを確認する。\n\n## Language policy\n\n- Issue title\u002Fbody: 日本語\n- PR title\u002Fbody\u002Freview discussion: 日本語\n- internal planning docs: 日本語\n- commit message: 英語\n- source code: 英語\n\ncommit format:\n\n`\u003Cwork-prefix>: \u003Cextremely concise title>`\n\n\n## Refinement boundary\n\nGitHub delivery topologyを変更する場合、最低限次を維持する。\n\n- durable work identityとdependencyを別actorから再発見できる\n- integration candidateとvalidation\u002Freview evidenceを対応付けられる\n- current\u002Freleased source stateのcanonical authorityが曖昧にならない\n- consequential landingのauthority boundaryが維持される\n- interrupted workをconversation historyなしでreconcileできる\n- valid workがdelivery ceremonyだけで不必要に停止しない\n\nbranch名、PR creation\u002Fstate timing、release branch cadence等はcurrent profileのdefaultであり、上位guaranteeを満たすalternativeを一律に禁止しない。\n",{"name":5,"description":7},"main","fae2dd6b4eb2a8c4744ff719f591e6e697efe4a4","skills\u002Fgithub-delivery",0,"https:\u002F\u002Fgithub.com\u002Frebuildup\u002Fproject-init","https:\u002F\u002Fgithub.com\u002Frebuildup","https:\u002F\u002Frebuildup.dev","jp 2007\r\nweb制作か映像制作、それにまつわるツールの制作をしている高専生","2026-11-13 16:51:04",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add rebuildup\u002Fproject-init --skill github-delivery",{"tool":39,"command":40},"bunx","bunx skills add rebuildup\u002Fproject-init --skill github-delivery",{"tool":42,"command":43},"pnpm","pnpm dlx skills add rebuildup\u002Fproject-init --skill github-delivery","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Frebuildup\u002Fproject-init\u002Fblob\u002Fmain\u002Fskills\u002Fgithub-delivery\u002FSKILL.md",true,[47],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"references\u002Fadaptive-release-batching.md","REFERENCE","参考文档",4948,"https:\u002F\u002Fgithub.com\u002Frebuildup\u002Fproject-init\u002Fblob\u002Fmain\u002Fskills\u002Fgithub-delivery\u002Freferences\u002Fadaptive-release-batching.md",[54,61,68,75,82,89],{"skillNo":55,"name":56,"nameZh":6,"description":57,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":19},"01M7AB77SBZEANKTQWPK1A9YW5","worktree-workflow","current release-driven profileでWorktrunkをWSL\u002FLinux workspace lifecycle Practiceとして使い、Rust\u002FCargo worktreeのbuild-output isolation・cache reuse・cleanupを含め、同等以上のguaranteeを持つalternativeへのrefinementも判断する時に使用する。","https:\u002F\u002Fgithub.com\u002Frebuildup\u002Fproject-init\u002Fblob\u002Fmain\u002Fskills\u002Fworktree-workflow\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":19},"01M7AB74AK8FAJ98HBC7KK1648","skill-selection","projectの初期化や再整備で、どのAgent Skillを導入するかを決める時に使用する。必要な能力を判定し、project-initの能力一覧と候補記録、さらに外部の探索から候補を評価して、能力ごとに担当を決め、project-localに導入してlockと採否を記録する。","https:\u002F\u002Fgithub.com\u002Frebuildup\u002Fproject-init\u002Fblob\u002Fmain\u002Fskills\u002Fskill-selection\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":19},"01M7AB71CFH8ZKF0QPV5H9QPS0","security-maintenance","framework\u002Fruntime\u002Fdependencyの脆弱性情報を収集し、projectへの実影響と優先度を判定してticket\u002Freleaseへ反映する時に使用する。","https:\u002F\u002Fgithub.com\u002Frebuildup\u002Fproject-init\u002Fblob\u002Fmain\u002Fskills\u002Fsecurity-maintenance\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M7AB6YFYS2QF2D1YH4K1117G","security-audit","source codeから未知のsecurity invariant failureを能動的に探索し、coverageを明示しながら独立検証されたfindingへ変換する時に使用する。","https:\u002F\u002Fgithub.com\u002Frebuildup\u002Fproject-init\u002Fblob\u002Fmain\u002Fskills\u002Fsecurity-audit\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M7AB6QW54HQ8JTRADE6NQ52X","secrets-management","application \u002F serviceのenvironment secretをInfisical中心で設計・初期化・移行・検証する時に使用する。CLI-first、repository-controlled schema、Machine Identity、GitHub OIDC、agent least-privilege、secret-safe evidenceを扱う。","https:\u002F\u002Fgithub.com\u002Frebuildup\u002Fproject-init\u002Fblob\u002Fmain\u002Fskills\u002Fsecrets-management\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":19},"01M7AB6N6WC13K9E0BPAFXWNPH","sandbox-runtime","implementation worker用の独立sandboxを作成・検証し、macOS \u002F WSL\u002FLinux \u002F remote provider差を吸収する時に使用する。","https:\u002F\u002Fgithub.com\u002Frebuildup\u002Fproject-init\u002Fblob\u002Fmain\u002Fskills\u002Fsandbox-runtime\u002FSKILL.md",[],[]]