finna/Finn-loop

解決する課題

Finn-loop は、Linear と GitHub を使用した標準的な開発ワークフローを、AI 駆動の「ソフトウェアファクトリー」に変換します。ソフトウェアライフサイクルの面倒な部分（仕様策定、実装、レビュー）を自動化しつつ、コードベースにマージされる内容に対する最終的な決定権を人間が保持することを確実にします。

仕組み

このシステムは、Linear（課題追跡用）および GitHub（バージョン管理と CI 用）と統合する 3 つの Claude Code カスタムスキルのセットとして機能します。

1. 仕様策定 (/finn-spec): AI がユーザーにインタビューを行い、曖昧なアイデアを明確な受け入れ基準と非目標を含む詳細な Linear 課題に変換します。
2. 実装 (/finn-build): AI が Linear から agent-ready 課題を引き受け、必要な変更を実装して検証し、GitHub Pull Request を開きます。
3. レビュー (/finn-review): AI がオープンな PR を元の Linear 契約と GitHub ステータスチェックに対してレビューし、PR がマージ可能かどうかの判定を提供します。

ユーザーはこれらのプロセスをループで実行（/loop を使用）して、準備完了した課題のキューと保留中のレビューを継続的に処理できます。

対象者

Claude Code、Linear、GitHub を使用しており、最終的なマージ決定の制御を放棄することなく、小さく明確に定義されたタスクの実行を自動化したいと考えているソフトウェアエンジニアやプロダクトオーナー。

ハイライト

• ヒューマンゲーテッドワークフロー: 人間のみがコードをマージできるというルールを厳格に適用します。
• コントラクト駆動開発: Linear 課題を唯一の信頼できる情報源として使用します。要件が課題に含まれていない場合、エージェントはそれを構築しません。
• 統合されたツール: GitHub CLI (gh) と Linear コネクタを活用し、シームレスな状態管理を実現します。
• 拡張可能なアーキテクチャ: 単純なループから、Slack 統合、リスク対応型マージ、自動化されたウォッチドッグを備えた完全なファクトリーへと進化するためのロードマップを提供します。