linear-release-control
current release-driven profileでLinearをrelease planning / health / portfolio Practiceとして使い、GitHub execution stateとのcanonical ownershipを保ってreconcileする時に使用する。
- License 许可
- MIT
- 最近更新
- 2026-11-13
- Stars
- ★ 2
- Forks
- 0
01 前言 Front Matter
- name
- linear-release-control
- description
- current release-driven profileでLinearをrelease planning / health / portfolio Practiceとして使い、GitHub execution stateとのcanonical ownershipを保ってreconcileする時に使用する。
03 SKILL.md 正文
Linear Release Control
Layer: Practice
Linearはcurrent release-driven profileの標準release planning / health / portfolio toolであり、Constitutionではない。重要なのはLinearというsurfaceではなく、Canonical Consistencyを保ったrelease-level planning ownershipである。
同等以上のportfolio/release-planning guaranteeを持つalternativeへ移行する場合はADR-0017のrefinement contractを使う。
Use this Skill when
- release Projectを作成・更新する
- release health / target date / blockerを整理する
- 複数repositoryのrelease状態を俯瞰する
- Linear Project Updateを作成する
- LinearとGitHubの状態差分をreconcileする
- Initiative / Milestone / Cycle / Linear Issueを使うか判断する
通常のimplementationだけならこのSkillを読み込まない。
Source of Truth
- source / integration: Git
- implementation scope / acceptance criteria: GitHub Issue
- implementation dependency: GitHub Issue dependency metadata
- code review / CI / merge evidence: GitHub PR / checks
- release integration evidence: release PR
- release goal / date / health / portfolio: Linear Project / Initiative
- durable project knowledge: repository-controlled docs
Linearの値からGitHub execution stateを推測しない。矛盾時はGitHub evidenceを確認してLinear側をreconcileする。
Object mapping
Project
1 release train = 1 Linear Project。週次計画とreleaseは1:1にせず、Projectはversion単位で管理する。
同じversion / release date / release decisionを共有する複数repositoryは1 Projectへまとめてよい。独立versionなら分ける。
最低限:
- release goal
- version
- target date when known
- health
- release PR / repository / release docs links
- release-level blockers / limitations
Initiative
複数release Projectを束ねるproduct / roadmap goalだけに使う。単一releaseのためだけに作らない。
Milestone
release-level checkpointだけに使う。
- Scope frozen
- Implementation complete
- Release candidate verified
- Released
必要なcheckpointだけ作る。ticket groupingには使わない。
Cycle
defaultでは週次planningをCycleへ重複登録しない。release cadenceは可変。
次の場合のみ検討する:
- releaseが複数planning windowを跨ぐ
- 複数Project間のteam capacityを見たい
- release cadenceとは別のiteration metricが必要
Linear Issue
GitHub Issueを全面mirrorしない。
Linear Issueは次のようなrelease-level / coordination workに限定する:
- cross-repository blocker
- external dependency
- release decision
- signing / distribution / store review
- non-code deliverable
- operational coordination
code changeのscope / acceptance criteriaはGitHub Issueへ置き、Linear Issueからlinkする。
Release lifecycle
Start
- version / goal / 分かる場合のrelease dateを確認する。週次境界は自動公開日ではない。
- Linear Projectを作成または既存Projectをreconcileする。
- relevant repositories / release docsをresourceとしてlinkする。
- GitHubでrelease branchを作成する。
- release branchにmeaningful diffが入ったらDraft release PRを作成し、Linear Projectからlinkする。
During implementation
- implementationはGitHub Issue / ticket PRで追跡する。
- LinearへPR本文・CI log・review discussionを複製しない。
- release判断へ影響するblockerだけProject / Linear Issueへ反映する。
- 週次/変更量/滞留/緊急性でreview(hold/candidate/blocked)。GitHub scopeと公開価値・リスク・滞留・release-only CI/deploy実測を使い、PR数だけで判断しない。
- candidateならGitHub PRにfreeze SHA/scope、carry-over、validation、明示承認を記録。Linearはhealthのみ投影する。
- Project UpdateはGitHub actual stateを確認してから作成する。
Project Updateの標準内容:
- health:
onTrack / atRisk / offTrack - completed / integrated highlights
- current blockers
- release gate state
- next checkpoint / decision
- canonical evidence links
Completion
- release PRのmergeとrelease-level gateをGitHubで確認する。
- tag / package / deploy / store等、projectで定義したactual availabilityを確認する。
- final Project Updateを作成する。
Releasedmilestoneを完了する。- actual releaseが確認できた時点でProjectをCompletedへ移す。
Agent / MCP policy
Interactive PM操作ではChatGPT等のLinear connector/pluginを使用してよい。
external agentがLinearへ直接アクセスする場合はLinear公式remote MCPをcapabilityとして使える。
- Coordinator / release manager:
https://mcp.linear.app/mcp - read-only worker:
https://mcp.linear.app/mcp/readonly
implementation workerは原則Linear write不要。planning contextが必要ならread-onlyを優先する。
MCP auth / API key / user-global client configをrepository truthにしない。credentialをcommitしない。
Mutation rules
Linearへwriteする前にcanonical GitHub evidenceを確認する。
禁止:
- unmerged PRをDone / implementation completeと推測
- failing / unknown CIを無視してhealthを楽観更新
- Linearだけにtechnical dependencyを追加してGitHub dependency graphと分岐
- acceptance criteriaをGitHubとLinearで別々に保守
- full GitHub Issue mirrorを自動作成
Built-in Linear agents
Linear coding sessionsはbaseline execution pathにしない。Supervisor isolation、number-only ticket branch、PR state lifecycle、release/stack topology、current-SHA validation contractを満たせるadapterとして明示導入した場合のみ使用する。
Loopsもbaselineにしない。利用する場合はstatus summarization / notification等のderived automationに限定し、canonical execution stateを変更するautomationは個別reviewする。
Failure / unavailable fallback
Linearが利用不能でもimplementation / release integrationを止めない。
GitHub Issue / PR / release branch / repository docsからcanonical execution stateを復旧し、Linear復旧後にProject stateをreconcileする。
Constitutional mapping
- Canonical Consistency: GitHub execution factsとLinear release-level factsのfield ownershipを分離する
- Evidence Integrity: release health/progressをGitHubのdurable evidenceからreconcileする
- Organizational Continuity: release goal/date/healthを一つのagent sessionだけに保持しない
Re-evaluate / remove
- release planningを別systemが同等以上に担う
- project規模/形態がLinear control planeを不要にする
- GitHub等がrelease-level viewを十分に提供し二重surfaceのcostが上回る
04 同仓库更多 Skills
worktree-workflow
current release-driven profileでWorktrunkをWSL/Linux workspace lifecycle Practiceとして使い、Rust/Cargo worktreeのbuild-output isolation・cache reuse・cleanupを含め、同等以上のguaranteeを持つalternativeへのrefinementも判断する時に使用する。
skill-selection
projectの初期化や再整備で、どのAgent Skillを導入するかを決める時に使用する。必要な能力を判定し、project-initの能力一覧と候補記録、さらに外部の探索から候補を評価して、能力ごとに担当を決め、project-localに導入してlockと採否を記録する。
security-maintenance
framework/runtime/dependencyの脆弱性情報を収集し、projectへの実影響と優先度を判定してticket/releaseへ反映する時に使用する。
security-audit
source codeから未知のsecurity invariant failureを能動的に探索し、coverageを明示しながら独立検証されたfindingへ変換する時に使用する。
secrets-management
application / serviceのenvironment secretをInfisical中心で設計・初期化・移行・検証する時に使用する。CLI-first、repository-controlled schema、Machine Identity、GitHub OIDC、agent least-privilege、secret-safe evidenceを扱う。
sandbox-runtime
implementation worker用の独立sandboxを作成・検証し、macOS / WSL/Linux / remote provider差を吸収する時に使用する。