【テクニカル・上級編】LinearのDraftsとUpdates機能を使ったチームの進捗共有！週報やステータスレポート作成の自動化テクニック – プロジェクト・ナレッジ管理活用バイブル

儀式としての週報を殺せ：Linear「Drafts」と「Updates」で構築する、ゼロ・オーバーヘッド進捗同期アーキテクチャ

すべてのエンジニアの時間を最も無駄に消費しているアンチパターンは何か？
それは「進捗報告のためのミーティング」であり、週末ごとに記憶を掘り起こしてJiraやスプレッドシートに手入力する「儀式としての週報」だ。

アジャイル開発において、情報のサイロ化を防ぎ、チームのベロシティを最大化するために最も必要なのは「リアルタイムの同期」と「文脈（Context）の継承」である。しかし、ツールへの入力コストが高ければ高いほど、エンジニアはドキュメントの更新をサボり、結果としてマネージャーは「今、何が進んでいて何がブロックされているのか」を把握するために無駄な定例会議をセットする。この悪循環が開発パイプラインの足を引っ張る。

Linear（リニア）は、この非効率なメタワークを根絶するために設計された、現在最強の課題管理・プロダクト開発プラットフォームだ。本記事では、Linearの隠れたキラー機能である Drafts（下書き） と Updates（ステータスレポート） を極限までハックし、週報作成プロセスを完全に自動化・非同期化（Asynchronous）するワークフローの全貌を解説する。

—

1. 内部アーキテクチャの理解：なぜLinearのUpdatesは優れているのか？

従来のチケット管理ツールでは、タスクのステータス変更（例: `In Progress` から `Done`）と、その週に何を成し遂げたかの「文脈（Narrative）」が完全に分断されていた。チケットのコメント欄に散らばった断片的な情報をかき集め、人間が脳内で結合して週報を書く。これはCPUに例えるなら、キャッシュミスを頻発させながらディスクI/Oを叩き続けるようなものだ。

Linearの Updates 機能は、イシュー（Issue）、プロジェクト、そしてサイクルの進捗状況を「ストーリー」として時系列で結合する。

[Issues / PRs / Cycles]
│
▼ (自動集約・ドラフト化)
[Linear Drafts] ──(人間のコンテキスト付与)──> [Linear Updates] ──(Webhook / API)──> [Slack / Custom Dashboard]

  • Drafts: 思考のスピードを落とさないためのローカル・ファーストなスクラッチパッド。デイリーの作業メモ、ふとした壁打ち、PRの断片などを一時退避させる。
  • Updates: チームに対する公式なステータス配信。Markdownによるリッチな記述、イシューやマイルストーンの直接リンク、健康状態（`On Track` / `At Risk` / `Off Track`）のメトリクス化。

これらを組み合わせることで、「日々の開発行動がそのまま自動的にレポートの素材になり、金曜日にはボタン一つ、あるいはスクリプトの実行だけでレポートが完成する」 状態を作り出す。

—

2. ワークフロー構築：DraftsからUpdatesへの昇華

まずは、GUIベースの標準機能でこのパイプラインの基盤を構築する。

Step 1: Draftsで思考と作業の断片をキャプチャする

開発中に発生したブロッカーや、今日完了した主要なタスクのメモは、Linearの「Drafts」機能（ショートカット: `G` -> `D`）に叩き込む。
ここで重要なのは、綺麗に書こうとしないことだ。マークダウンの箇条書きで十分である。

  • `[Fix] Auth0のトークンリフレッシュバグ修正 (PR #402)`
  • `[Investigate] gRPCのコネクションプーリングでメモリリークの兆候あり`
  • `[Blocked] 決済APIのステージング環境がダウン中`

Step 2: Updatesでプロジェクトの「ヘルス」を定義する

毎週金曜日の終業前、あるいは木曜日の夕方に、Linearのプロジェクトビューから「New Update」を作成する。
Linearは、過去1週間の間にそのプロジェクトでクローズされたイシューや、作成されたPRを自動的にサジェストして取り込む。

ここでエンジニアがやるべき作業は最小限だ：
1. Health Statusの選択: 🟢 `On Track` / 🟡 `At Risk` / 🔴 `Off Track`
2. Draftsからの流し込み: Step 1で溜め込んだドラフトをペーストし、文脈を整える。
3. ネクストアクションの明示: 来週のフォーカスを3行以内で記述する。

これだけで、チームメンバー全員のSlackに美しくフォーマットされたステータスレポートが飛ぶようになる。

—

3. 【極限の自動化】CLIとAPIを叩く独自スクロプトで週報作成を完全ゼロ化する

「毎週金曜日に手動でUIをポチポチするのすらめんどくさい」という真のエンジニアのために、LinearのGraphQL APIとCLIを駆使して、「今週自分が何をやったかをGitのコミットログとLinearの完了イシューから自動抽出し、Draftsを経由してUpdatesに下書きを投入するスクリプト」を構築する。

前提条件

  • Linear API Keyの発行（Settings -> API -> Personal API keys）
  • Node.js (v18+) または Bun がインストールされていること

自動化スクリプト (`generate-weekly-update.ts`)

以下のTypeScriptスクリプトは、LinearのGraphQL APIを叩き、直近7日間に自分が完了したイシューを取得し、自動的にアップデートの下書きを作成する。

import { LinearClient } from ‘@linear/sdk’;

// 環境変数からLinearのAPIクライアントを初期化
const linear = new LinearClient({ apiKey: process.env.LINEAR_API_KEY });

async function generateWeeklyUpdate() {
try {
const me = await linear.viewer;
console.log(`Authenticated as: ${me.name} (${me.email})`);

// 直近7日間のタイムスタンプを計算
const sevenDaysAgo = new Date();
sevenDaysAgo.setDate(sevenDaysAgo.getDate() – 7);

// 自分が直近7日間に完了したイシューを取得
const assignedIssues = await linear.issues({
filter: {
assignee: { id: { eq: me.id } },
state: { type: { eq: ‘completed’ } },
updatedAt: { gte: sevenDaysAgo.toISOString() },
},
});

const issues = await assignedIssues.nodes;

let reportBody = `

🤖 自動生成週報 (${new Date().toLocaleDateString()})\n\n`;

reportBody += `

今週完了したタスク (${issues.length}件)\n`;

if (issues.length === 0) {
reportBody += `- 特になし（または外部タスクに集中）\n`;
} else {
for (const issue of issues) {
const team = await issue.team;
reportBody.endswith(`- [${team?.key}-${issue.number}] ${issue.title} (${issue.url})\n`);
}
}

reportBody += `\n

来週のフォーカス\n- [ ] （ここに自動追記または手動での調整を記載）\n`;

// LinearのUpdates API（Project Update）を発行する
// ※対象のプロジェクトIDが事前に分かっている前提
const projectId = process.env.LINEAR_PROJECT_ID;
if (!projectId) {
throw new Error(“LINEAR_PROJECT_ID is not set in environment variables.”);
}

const update = await linear.createProjectUpdate({
projectId: projectId,
body: reportBody,
health: ‘onTrack’, // デフォルトはOn Track
});

console.log(‘✅ Successfully generated Linear Project Update!’);
console.log(`Update ID: ${update.success ? ‘Created’ : ‘Failed’}`);

} catch (error) {
console.error(‘❌ Failed to generate weekly update:’, error);
process.exit(1);
}
}

generateWeeklyUpdate();

実行とCronによるデーモン化

このスクリプトを `package.json` に登録し、毎週金曜日の17:00に自動実行するようにローカルのCron、あるいはCI/CD（GitHub ActionsのScheduled workflows）に組み込む。

.github/workflows/weekly-update.yml
name: Auto-generate Linear Updates

on:
schedule:
# 毎週金曜日 08:00 UTC (日本時間 17:00)

  • cron: ‘0 8 5’

workflow_dispatch:

jobs:
generate:
runs-on: ubuntu-latest
steps:

  • uses: actions/checkout@v4
  • uses: actions/setup-node@v4

with:
node-version: ’20’

  • run: npm install @linear/sdk
  • name: Run Weekly Update Generator

env:
LINEAR_API_KEY: ${{ secrets.LINEAR_API_KEY }}
LINEAR_PROJECT_ID: ${{ secrets.LINEAR_PROJECT_ID }}
run: npx ts-node generate-weekly-update.ts

これにより、エンジニアは「金曜日の夕方にレポートを書く」という認知負荷から完全に解放され、純粋にコードを書くことだけに集中できるようになる。

—

4. Slack連携とWebhooksによる「通知のノイズ抑制」

自動化を進めると陥りがちな罠が「Slackの通知洪水」だ。すべてのステータス変更やアップデートがそのまま流れてくると、重要なアラートが流されてしまう。

これを防ぐためのルーティング設計の極意：

1. チャンネルの分離:

  • `#dev-updates`: チーム全体の `Updates` のみが流れるチャンネル。ここではディスカッションは禁止とし、各人の進捗の「閲覧」に特化させる。
  • `#dev-alerts`: `At Risk` や `Off Track` にステータスが変更された瞬間、またはブロッカーラベルが付与されたイシューのみが飛ぶチャンネル。

2. Slack Threadsの活用:

  • Updatesに対するフィードバックや質問は、必ずSlackのスレッド内で行う。これにより、メインのタイムラインが汚染されるのを防ぎ、コンテキストを綺麗に保つことができる。

—

5. アーキテクトからの提言：ツールに縛られるな、ツールを飼い慣らせ

多くの開発チームが「アジャイルツールを入れたのに、なぜか生産性が上がらない」という罠にハマる。その原因は、ツールが提供するデフォルトのワークフローに人間の側が従属させられているからだ。

JiraであれLinearであれ、ツールはあくまで「開発者の認知負荷（Cognitive Load）を下げるため」のインフラストラクチャに過ぎない。
Draftsで思考の摩擦をゼロにし、UpdatesとAPI自動化で報告のコストを極限まで圧縮する。このパイプラインを構築して初めて、チームは真のアジャイル、すなわち「変化に対する俊敏性」を手に入れることができる。

今週の金曜日、あなたはまだ手動で週報を書いているのか？
それとも、スクリプトに仕事を任せて、最高のコードを書いているだろうか？ 選択はあなた次第だ。

スポンサーリンク
タイトルとURLをコピーしました