開発者が30日間の個人プロジェクトでClaude CodeとLinear、Discordをどのように活用したか

プロジェクトと技術スタック

ある開発者が、競技ポケモン（VGC）向けのチームレポートビルダー「VGC Team Report」（pokemonvgcteamreport.com）を作成しました。このツールは、マッチアップ計画、ダメージ計算、スピードティア、共有可能なレポートを含む詳細な分析を生成します。このプロジェクトは、30日間の夜間と週末を費やし、274回のコミット、約42,000行のTypeScript、Linear経由で出荷された25の機能、66のReactコンポーネント、41のAPIルート、22のカスタムフックで構築されました。技術スタックには、Next.js 16（App Router）、React 19、TypeScript（strictモード）、Tailwind CSS v4、認証用のClerk、サーバーレスPostgres用のNeon、ホスティングとデプロイ用のVercelが含まれていました。

ワークフロー：Linear → Claude → Discord → Vercel

開発者は、自動化された開発パイプラインを作成するために、Claude CodeをLinearのチケット追跡とDiscordのビルド通知に接続しました。典型的なセッションは次の順序で行われました：

1. Claudeがlinear_get_in_progressを実行してLinearボードのチケットを確認
2. 最高優先度のチケット（バグを優先）を選択
3. 関連ファイルを読み、機能や修正を実装
4. tsc --noEmit && npm run buildを実行 — 失敗した場合、Claudeがエラーを修正
5. チケットID形式でコミット：VGC-42: Add speed tier chart
6. mainブランチにプッシュ
7. GraphQL経由でLinearチケットにコミットURLと変更ファイルを記載したコメントを投稿
8. チケットを「In Review」に移動
9. discord_notify_buildを呼び出し — Discordの#buildsチャンネルにコミット、変更ファイルリスト、デプロイステータスを含む埋め込みメッセージを投稿
10. Vercelがmainブランチから自動デプロイ
11. 次のチケットに移動

これは、Claudeが直接呼び出す関数を含むlinear.shバッシュスクリプトを通じて実装されました：linear_get_in_progress（Linear GraphQLに「In Progress」チケットを問い合わせ）、linear_move_issue（チケットを新しい状態に移動）、linear_comment_with_changes（コミットリンクと変更ファイルを含むコメントを投稿）、discord_notify_build（コミット情報とデプロイステータスを含むDiscord埋め込みメッセージを送信）。

CLAUDE.md操作マニュアル

リポジトリのルートにあるCLAUDE.mdファイルは、すべてのClaudeセッションにコンテキストを提供します。主なセクションは次のとおりです：

• Git戦略： 日常作業ではトランクベース開発でmainブランチに直接プッシュ、大規模またはリスクの高い変更のみ機能ブランチを使用、すべてのプッシュ前にnpx tsc --noEmit && npm run buildを絶対条件として実行
• Linearワークフロー： 「In Progress」と「In Review」の正確な状態ID、チケットの問い合わせと実装方法、VGC-XXプレフィックス付きでコミット、コミットコメントの投稿、チケット状態の移動、バグチケットは常に最初に対応
• Discord通知： mainブランチへの直接プッシュとPRフローで異なる埋め込みメッセージ形式を持つdiscord_notify_build関数
• 障害対応： ビルド失敗 → 修正して再試行、壊れたコードをプッシュしない；Linear API失敗 → コミットとプッシュは実行、ユーザーに障害を通知；本番環境障害 → git revertを実行、mainブランチにプッシュ、Discordに通知、チケットを戻す
• コード規約： 既存のパターンに従う、無関係なリファクタリングは行わない、コミットメッセージ：追跡作業にはVGC-XX: description

自動化された監視

2つのVercel cronジョブが設定されました：毎日午前9時にサイトの健全性、古いチケットのスキャン、SEO監査、データベース健全性を確認（問題がある場合のみDiscordにアラートを投稿）、毎週金曜日午後5時にLinearの進捗、ユーザー成長、依存関係の更新に関する週次ダイジェスト（常に要約をDiscordに投稿）。リアルタイムの稼働時間監視には、5分間隔でpingを送信するUptimeRobotを使用しました。

成功した点

開発者は、いくつかの効果的な実践を強調しました：型チェックゲート（tsc --noEmit && npm run build）を伴うトランクベース開発により、mainブランチへのすべてのプッシュがVercelで自動デプロイされ、数分のフィードバックループを実現；すべてのコミットがチケットにリンクし、すべてのチケットにコミットURLと変更ファイルを含むコメントがあるLinearチケットの追跡可能性；すべてのビルドが#buildsに投稿されるDiscordの監査証跡；そして、セッション間で一貫したコンテキストを維持するための最も価値のあるプロジェクトコンポーネントとしてのCLAUDE.mdファイル。