flywheel について
flywheelは、コードの蓄積ではなく、品質ゲートを通過した再利用可能なテンプレートやモジュールで進捗を測る、反復型プロジェクト向けのエージェントスキルです。目標設定、構築、実環境での検証、振り返り、次の工程の判断を支援します。
主な機能
- 01方針と品質ゲートの設定
- 02垂直スライスの構築
- 03成果物の実際の利用面で検証
- 04振り返りから次の手順を決定
- 05ゲートを通過したテンプレートやモジュールのみを版管理
活用シーン
- 01反復的な製品開発サイクルの管理
- 02Web、API、デスクトップ成果物の実環境テスト
- 03反復するか再始動するかの判断
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ lilmgenius/ paperthin --skill flywheelインストール後、Claude Code で/flywheelを入力して読み込まれたか確認します。
詳細
学びを蓄積し、コードを増やすだけのことを進捗と取り違えないように、サイクルを回します。
目標
flywheel は、次のターンを繰り返してプロジェクトを前進させます。
FRAME -> BUILD -> DRIVE -> RETRO -> HATE -> RE0-WORK -> BUILD AGAIN
進捗の単位は、時間、ファイル、パネル、機能ではありません。品質基準をクリアしたテンプレート、再利用可能なプラットフォームモジュール、および後続のサイクルで排除されたアンチパターンの数です。
ワークフロー
- 仮説と品質ゲートを設定します。
- 完全な垂直スライスを1つ構築します。
- 実際のサーフェスで動かします。Web アプリならブラウザー、API コントラクトなら HTTP、デスクトップアプリならコンピューター操作、データ形式の成果物に限って CLI を使います。
retroを実行して、教訓、アンチパターン、次のサイクルのゲートを抽出します。- 次のパスでその場で反復するか、
re0-workを使うか判断します。その判断や次の動きが不明な場合は、nbaでサイクルの状態を読み取り、次に取るべき単一のアクションを返します。 - 構築に着手する前に、次の計画を徹底的に検討します。プロジェクトの敵対的レビュー用スキルを使うか、そのスキルがユーザーのみ実行できる場合は、人が起動する攻撃的レビューを行います。
- 品質ゲートをクリアしたテンプレートまたはモジュールにのみバージョンを付けます。
ルール
- テストは補助的な証拠であり、ゲートではありません。すべてのターンで、成果物に見合った実際のサーフェスでの検証結果が必要です。
- コアループをクリアするまでは、範囲を広げないでください。
- 生成物の多様性を構造上の多様性と混同しないでください。多くの出力が同じ形に収束するなら、サイクルは多様性ゲートに失敗しています。
- 後続のサイクルで同じアンチパターンが再発していないことを証明できるよう、ネガティブコーパスを保持してください。
- コードを捨てることを恐れないでください。必要な教訓を保持したうえでの再スタートも進捗です。
- 外部から新たな事実が入らなければ、その周回を止めてください。内部でさらに作業する前に、証拠を追加してください。
検証
周回を終える前に、次の点を確認してください。
- 実際のサーフェスを動かし、証拠を記録しました。
- レトロスペクティブで、次のパスに影響する教訓、アンチパターン、またはゲートを少なくとも1つ明示しました。
- 維持、反復、
re0-workのいずれにするかを明示しました。 - バージョンラベルが付いているのは、品質基準をクリアしたテンプレートまたはモジュールだけです。
コメント
Markdown 対応