FluencyLoop icon

FluencyLoop

FluencyLoopは、Claude CodeとCodex向けのAI支援開発ワークフロー。意思決定の記録、機能実装の整理、レビュー向け要約の作成を支援し、ブランチ単位のドキュメントと非公開の知識プロファイルで学習深度を調整します。

FluencyLoop

概要

FluencyLoopは、Claude CodeとCodex向けのAI支援開発ワークフローで、コードと同時に理解も生み出すことを目指しています。プロジェクトの初期化、大きめの作業の計画、機能の分割実装、レビュー準備済みの要約の作成を支援し、ドキュメントを実際のブランチと実装履歴に結び付けたまま保ちます。

このリポジトリは、各 feature が文書化された設計を生み出し、実際の意思決定と却下された代替案を記録し、再現可能なエンジニアリング上の方針が現れるたびに短い project constitution を更新するループを説明しています。FluencyLoop はまた、開発者ごとの非公開知識プロファイルを保持するため、説明は慣れた話題では簡潔に、必要な箇所ではより詳細にでき、そのプロファイルはプロジェクトにはコミットされません。

主な機能

プロジェクトの初期化

空の constitution でプロジェクト状態を開始します。README では、必要に応じて plan と feature もこれを自動的に行えると説明されています。

任意の計画段階

単一の feature としては大きすぎる作業を、実装前に feature サイズのタスクへ分割します。

ブランチベースの feature ループ

feature ブランチを作成し、分割しながら実装し、各実際の意思決定を教え、作業の進行に合わせて記録します。

レビュー要約の生成

ブランチのセッションと意思決定をまとめ、レビュー担当者向けの pull request 表示に整えます。

意思決定の追跡

選択した内容、選んだ理由、却下した案、constitution および設計との関係を含め、各意思決定の根拠を追跡します。

適応的な知識キャリブレーション

非公開の開発者ごとのキャリブレーションプロファイルを保持し、リポジトリにそのプロファイルをコミットせずに、ワークフローがプロジェクト間で学習深度を調整できるようにします。

主な利用シーン

  • 進行中の feature 作業の記録

    機能の実装とドキュメントを揃えて進めたいときに FluencyLoop を使います。このワークフローは、設計ノート、意思決定の記録、レビュー用資料を、それらを生み出したブランチに紐づけて保ちます。

  • 大規模な取り組みの構造化

    取り組みが大きすぎて単一の feature としては実装できない場合に計画段階を使います。ツールは、チームが実装を始める前に作業を feature サイズのタスクへ分割します。

  • レビュー用 pull request の準備

    ブランチのセッションと意思決定を、レビュー担当者向けの pull request 要約に変換するときにレビュー段階を使います。これは、差分だけでなくコードの背景にある根拠をレビュー担当者が必要とするときに役立ちます。

  • 古い作業の再構成

    FluencyLoop を使わずにすでにマージされた作業を扱うときは backfill を使います。リポジトリによれば、backfill コマンドは後から設計と意思決定を再構成し、検証できます。

  • 貢献者に合わせた説明の調整

    異なる貢献者が異なる説明レベルを必要とする場合は、開発者ごとの知識プロファイルを使います。ワークフローは、実証済みの習熟度に基づいて学習深度を調整します。

Pros and Cons

Pros

  • 作業中に設計上の意思決定とその根拠を記録し、後から再構成する必要を減らします。
  • 計画、設計図、セッションノート、レビュー要約などのブランチ単位のドキュメントを生成します。
  • 名前空間付きコマンドまたは skills を使って、Claude Code と Codex の両方のワークフローを支援します。
  • このループを使う前にマージされた作業向けの backfill 経路を備えています。
  • 非公開の知識プロファイルを使って、feature やプロジェクトをまたいで学習深度を調整します。

Cons

  • このリポジトリには、個別の製品価格やホスト型サービスの詳細はありません。
  • セットアップは、Claude Code または Codex に加えて git とシェル、または PowerShell などの外部ツールと環境に依存します。

FAQ

FluencyLoopは何をするものですか?

Claude CodeまたはCodexを使うチーム向けの開発ワークフローツールです。FluencyLoopは、プロジェクトの初期化、大きめの作業の計画、機能の分割実装、レビュー準備済みの要約作成を支援する方法として説明されています。

このワークフローは日々どのように使いますか?

READMEによると、通常規模の作業では init → feature → review の流れが実践的です。より大きな取り組みでは、最初に plan を実行し、その後は各タスクごとに feature → review を繰り返します。

どのようなドキュメントを生成しますか?

FluencyLoopは、常に変化する constitution、計画、Mermaid の設計図、feature セッション、レビュー要約、そしてプロジェクトにはコミットされない開発者ごとの非公開ナレッジベースを出力します。

セットアップ要件は何ですか?

このリポジトリによると、FluencyLoopには Claude Code もしくは Codex、git、そして macOS/Linux/Git Bash/WSL での Bash、またはネイティブ Windows での PowerShell が必要です。

FluencyLoop の価格情報はありますか?

このプロジェクトは公開 GitHub リポジトリで公開されています。GitHub の料金ページには公開リポジトリの無料利用が示されていますが、リポジトリ自体には個別の製品価格の詳細はありません。

Quick Facts

カテゴリ
開発者ツール
ソースドメイン
github.com
製品タイプ
オープンソースリポジトリ
主な利用者
Claude Code または Codex を使用する開発者
ワークフロー
init → feature → review、必要に応じて plan
公開範囲
公開