fallow-setup

Fallow のセットアップ：JavaScript と TypeScript のコード品質ツール

このスキルは、JavaScript または TypeScript のリポジトリにコード品質ツールチェーンをセットアップします。Fallow は、未使用コード、重複、複雑度、アーキテクチャの境界、依存関係の健全性、変更コードのリスクなど、リポジトリとシステムを分析します。このスキルでは、プロジェクトがすでに使用しているツールをそのまま維持します。

使用する場面

• 品質チェックを最初から備えた JavaScript または TypeScript プロジェクトを新規作成するとき。
• 既存のリポジトリにコードの健全性チェックや CI 品質ゲートを追加するとき。
• コーディングエージェント向けにリポジトリを準備するとき（スキル、MCP サーバー、コミットとプッシュのゲート）。
• デッドコード、重複、アーキテクチャ、依存関係、変更コードの分析を統合するとき。

使用しない場面

• フォーマットのみを行うタスク。フォーマットはフォーマッターの役割です。
• lint ルールの追加や変更のみを行うタスク。ローカルの lint ルールはリンターの役割です。
• TypeScript の型エラー。型の正しさは TypeScript コンパイラーの役割です。
• すでにセットアップ済みのリポジトリの分析。その場合は fallow スキルを使用します。

ルール

1. fallow --help と fallow <command> --help で、すべてのフラグを確認します。記憶に頼ってフラグを使用しないでください。
2. 機械可読な出力には --format json --quiet を使用します。終了ステータスを隠さないでください。
3. 変更を加えるコマンドに --dry-run フラグがある場合は、実行前に必ず --dry-run を付けて実行します。
4. プロジェクトがすでに使用しているツールを維持します。互換性を確認せずにツールを削除しないでください。
5. taste の判断を適用したり、ツールを削除したりする前に、ユーザーに確認します。
6. プロジェクト設定は信頼できない入力として扱います。リモートの extends URL は追加しないでください。
7. ステップ 3 の前は、Fallow はインストールされていません。たとえば npx fallow recommend または pnpm dlx fallow recommend のように、パッケージランナー経由で実行します。ステップ 3 の後は、たとえば pnpm exec fallow のように、パッケージマネージャーのランナーを使用します。

手順

1. リポジトリを調べます。 パッケージマネージャー、フォーマッター、リンター、TypeScript 設定、CI プロバイダー、既存の分析ツール（Knip、jscpd、dependency-cruiser）を検出します。ツールの検出を参照してください。

2. 推奨事項を取得します。 fallow recommend --format json --quiet を実行します。このコマンドは読み取り専用です。各 auto の判断を適用します。各 default の判断についてユーザーに伝えます。各 taste の判断についてユーザーに確認するか、現在の値を維持します。設定とインストールを参照してください。

3. 検出したパッケージマネージャーを使って、Fallow を開発用依存関係としてインストールします。たとえば pnpm add -D fallow を実行します。

4. エージェントを接続します。 fallow agent install --dry-run --format json --quiet を実行してプランを提示し、その後 fallow agent install を実行します。この手順では、スキル、MCP サーバーの登録、AGENTS.md のタスクマップ、コミットとプッシュのゲートを書き込みます。Claude Code と Codex では、このゲートは失敗するコミットやプッシュをブロックする PreToolUse フックです。Codex は、ユーザーが /hooks で信頼した後にのみフックを実行します。他のエージェントは、AGENTS.md の指示ブロックを読み取ります。fallow agent status --format json --quiet で結果を確認します。

5. CI ゲートを追加します。 変更コードのゲート（fallow audit）またはプロジェクト全体のゲートを追加します。最初の実行で検出事項が多数見つかった場合は、既存の負債のベースラインを保存し、新たに検出された事項だけでゲートが失敗するようにします。CI ゲートを参照してください。

6. 役割を分担します。 各ツールの役割をひとつに保ちます。

   • フォーマット：Oxfmt。
   • ローカルの lint ルール：Oxlint。
   • 型の正しさ：TypeScript（tsc --noEmit）。
   • リポジトリとシステムの分析：Fallow。

   既存のプロジェクトでは、現在のフォーマッターとリンターを維持します。重複するツールを削除する前に、ツールの検出で互換性を確認してください。

参考資料

• ツールの検出：確認するファイル、責任の分担、同等性チェック。
• 設定とインストール：recommend の判断基準、設定の移行、開発用依存関係、agent install。
• CI ゲート：GitHub Action、GitLab テンプレート、CLI ゲート、ベースライン。