闇夜の暗号航法：Linear「Draftモード」とGitコミットハッシュが生む、完全秘匿型アジャイル開発の極意
ベロシティの向上と透明性の担保はアジャイル開発の聖杯だ。しかし、真に洗練されたエンジニアリング組織であれば、誰もが気づいているはずのパラドックスに直面したことがあるだろう。
「すべての情報をオープンにする（Make work visible）」というアジャイルの鉄則は、時としてまだ市場やステークホルダーに見せるべきではない実験的機能、競合を牽制するための極秘プロジェクト、あるいは基盤を根底から覆すリファクタリングの芽を摘んでしまう。
パブリックなロードマップ、プロダクトマネージャー（PdM）が監視するアクティブサイクル、そして全社に露出するカンバンボード。これらに載せた瞬間に、未成熟なアイデアは組織のノイズとなり、無駄な期待値のコントロールや、コンテキストスイッチの嵐を引き起こす。
では、どうするか？ 情報を隠蔽するのではなく、「暗号化された文脈」としてリポジトリとチケット管理システムを不可分に結合させ、誰の目にも触れずに極限の速度でアジリティを維持するのだ。
本稿では、Linearの「Draft（ドラフト）モード」とGitのコミットハッシュ、そして高度なWebhook・API自動化を融合させ、セキュリティとアジリティを極限まで両立させる「ステルス・デベロップメント・パイプライン」の全貌を解き明かす。
—
1. アーキテクチャの核心：なぜ通常のチケット管理では「秘密主義」が破綻するのか
多くのチームが「秘密裏に進めたいタスク」を扱う際、Slackのプライベートチャンネルや、ローカルのMarkdownファイル、あるいはアクセス権限を絞った別プロジェクト（Jira等の別スペース）に逃げ込む。
だが、これは最悪のアンチパターンだ。
コンテキストがコードベースから乖離し、PR（Pull Request）がマージされた瞬間に「この変更は何のためにあるのか？」というトレーサビリティが失われる。
我々が求めるべきは、「コードとチケットが1対1で暗号学的に結びつきながらも、オーソライズされたビューやパブリックなロードマップからは完全に不可視（Invisible）である状態」だ。
Linear Draftモードの内部動作とライフサイクル
LinearにおけるDraft（草案）ステータスは、単なる「未完了」ではない。
- グローバル・インデックスからの除外: デフォルトのチームビュー、サイクル（Cycles）、ロードマップ（Roadmaps）、そしてAPIの標準クエリ（特段のフィルタを指定しない場合）から完全にマスクされる。
- メンション・通知のサイレント化: Draft状態の課題に対するコメントやメンションは、アサインされたエンジニア以外のノイズを生まないように抑制される。
- IDの永続性と昇格の不可逆性: 発行されたID（例: `ENG-404`）はそのまま保持され、準備が整った段階でワンアクション、あるいはAPI経由で「Backlog」や「Triage」へ昇格（Promote）できる。
このDraftチケットを、Gitのブランチ命名規則とコミットハッシュの構造的紐づけによって、「開発者自身すら意識せずにバックグラウンドで同期し続ける」仕組みを構築する。
—
2. 秘匿開発のためのブランチ命名規則とGit Hook自動化
極秘裏に進めるプロジェクト（コードネーム: `Project-Chimera`）を想定する。
ルールはシンプルだ。ブランチ名に特定のプレフィックス（例: `draft/`）を強制し、その文脈をコミットハッシュを通じてLinearのDraftチケットへ自動マッピングする。
規約 (Convention)
- ブランチ名: `draft/ENG-404-quantum-encryption`
- コミットメッセージ: `[ENG-404] implement zero-knowledge proof primitives`
これを手動で行うのはエンジニアの認知負荷を高めるため、完全に自動化する。HuskyとLint-staged、そしてLinear CLI（またはカスタムAPIスクリプト）を組み合わせたGit Hookをリポジトリに埋め込む。
`.git/hooks/prepare-commit-msg` の実装
コミットメッセージにブランチ名から抽出したLinearのDraftチケットID（例: `ENG-404`）を自動挿入する低レイヤースクリプトだ。
!/usr/bin/env bash
==============================================================================
Git Prepare Commit Msg Hook: 自動的にLinearのDraftチケットIDを付与
==============================================================================
COMMIT_MSG_FILE=$1
COMMIT_SOURCE=$2
SHA1=$3
現在のブランチ名を取得
BRANCH_NAME=$(git symbolic-ref –short HEAD 2>/dev/null)
ブランチ名から “draft/ENG-XXX” または “ENG-XXX” のパターンを抽出
if [[ “$BRANCH_NAME” =~ (ENG-[0-9]+) ]]; then
ISSUE_ID=”${BASH_REMATCH[1]}”
# 既にコミットメッセージ内にチケットIDが含まれているか確認
if ! grep -q “$ISSUE_ID” “$COMMIT_MSG_FILE”; then
# メッセージの先頭に [ISSUE_ID] を挿入
CURRENT_CONTENT=$(cat “$COMMIT_MSG_FILE”)
echo “[$ISSUE_ID] $CURRENT_CONTENT” > “$COMMIT_MSG_FILE”
echo “[Linear Stealth Hook] Injected Draft Issue ID: $ISSUE_ID into commit.”
fi
fi
このフックにより、開発者は普段通り `git commit -m “refactor core logic”` と打つだけで、内部的には `[ENG-404] refactor core logic` として記録され、コミットハッシュとLinearのDraftタスクが強固に結びつく。
—
3. Linear API & Webhookによる「影のパイプライン」の構築
コードがプッシュされ、DraftチケットのIDが含まれたコミットハッシュがGitHub/GitLab上に生成された瞬間、誰も見ていないバックグラウンドで何が起きるべきか？
1. Linear APIを叩き、該当Draftチケットに最新のコミットハッシュ（SHA）をアタッチする。
2. Slackの「極秘開発用プライベートチャンネル」にのみ、進捗のメタデータ（コードの差分サイズ、ビルドステータス）を送信する（パブリックチャンネルには流さない）。
以下のNode.js製自動化スクリプト（TypeScript/Linear SDK使用）は、このパイプラインの中核を担う。CI/CD環境（GitHub Actions等）から呼び出されることを想定している。
`sync-stealth-commit.ts`
import { LinearClient } from ‘@linear/sdk’;
import { execSync } from ‘child_process’;
// 環境変数からセキュアにトークンを取得
const linearClient = new LinearClient({ apiKey: process.env.LINEAR_API_KEY });
async function linkCommitToDraftIssue() {
try {
// 1. 直近のコミットハッシュとメッセージを取得
const commitHash = execSync(‘git rev-parse HEAD’).toString().trim();
const commitMessage = execSync(‘git log -1 –pretty=%B’).toString().trim();
// 2. メッセージからLinearチケットIDを抽出 (例: ENG-404)
const match = commitMessage.match(/(ENG-[0-9]+)/);
if (!match) {
console.log(‘No Linear issue ID found in commit message. Skipping stealth sync.’);
return;
}
const issueKey = match[1];
console.log(`[Stealth Sync] Detected Issue Key: ${issueKey}`);
// 3. チケットの存在確認とDraftステータスの検証
const issues = await linearClient.issues({
filter: { identifier: { eq: issueKey } }
});
if (issues.nodes.length === 0) {
throw new Error(`Issue ${issueKey} not found.`);
}
const issue = issues.nodes[0];
// 4. コミット情報をLinearのコメントまたはカスタムアタッチメントとして記録
// ※ Linear APIではattachment作成やcomment追加を通じてハッシュを紐づけます
await linearClient.createAttachment({
issueId: issue.id,
title: `Git Commit: ${commitHash.substring(0, 7)}`,
url: `https://github.com/your-org/your-repo/commit/${commitHash}`,
subtitle: commitMessage.split(‘\n’)[0]
});
console.log(`[Stealth Sync] Successfully linked commit ${commitHash} to Draft issue ${issueKey}`);
} catch (error) {
console.error(‘[Stealth Sync Error]’, error);
process.exit(1);
}
}
linkCommitToDraftIssue();
—
4. 組織的安全性：情報漏洩を防ぐためのガバナンスとメモリ最適化ハック
この「Draftモード × コミットハッシュ紐づけ」手法を導入するにあたり、システム管理者およびテックリードが留意すべき極限の最適化ポイントを提示する。
A. グラフQLクエリの漏洩防止（API Tokenの権限分離）
LinearのAPIトークンを発行する際、「Team-restricted」かつ「Read/Write limits」を厳格にかけよ。
パブリックなCI/CDランナーから叩くトークンと、極秘開発用のスクリプトから叩くトークンを完全に分離し、万が一CI環境がコンテナ逃脱等で侵害された場合でも、他のプロダクトのDraftチケット群やロードマップにアクセスできないスコープ設計（Principle of Least Privilege）を徹底する。
B. ローカルGit環境のメモリ・ディスク消費最適化
極秘プロジェクトでは、巨大なバイナリファイルやテスト用のダンプデータ（数GB単位）をリポジトリ内に一時的に置くケースがある。これがメインのクローンを重くし、開発者のマシンのベロシティを殺す。
- Git LFS（Large File Storage）の強制: プライベートブランチであっても、バイナリはLFSで管理。
- Sparse Checkoutの活用: 極秘プロジェクトのディレクトリのみをローカルに展開し、メインのコードベースのインデックス肥大化を防ぐ。
秘匿プロジェクト用のスパースチェックアウト設定例
git sparse-checkout init –cone
git sparse-checkout set packages/chimera-core
これにより、開発者のローカルメモリフットプリントを最小限に抑えつつ、Linearとのセキュアな同期パイプラインを高速に維持できる。
—
5. 結び：静寂こそが、最も破壊的なイノベーションを生む
アジャイル開発において「オープンであること」は美徳とされる。しかし、すべてのアイデアが最初から日の目を浴びる必要はない。むしろ、世の中にインパクトを与える真のディスラプティブな機能や、根本的なアーキテクチャの刷新は、誰からも干渉されない「静寂の空間」から生まれる。
LinearのDraftモードとGitコミットハッシュを緻密に組み合わせたこの手法は、単なるセキュリティ対策ではない。「組織のノイズから開発チームを守り、コードとタスクの完全な整合性を保ったまま、ある日突然、圧倒的な完成度で市場に爆弾を投下するための究極のエンジニアリング・インフラストラクチャ」である。
さあ、今日の夕暮れ、誰も気づかないうちに新しいDraftチケットを切ろう。ブランチを切り、コードを書き、ハッシュを刻め。世界がその変化に気づくのは、すべてが完了し、あなたが「Promote」のボタンを押した、その瞬間だけでいい。