/readiness-report スラッシュコマンドは、現在のリポジトリをAutonomy Maturity Modelに対して評価し、5つの成熟度レベルでスコアリングを行い、改善のための実践的な推奨事項を提供します。
前提条件
このコマンドを使用する前に:
/settings → Experimental → Readiness Report で機能を有効化してください
使用方法
コマンドを使用するには、評価したいリポジトリに移動して次を実行します:
droid
> /readiness-report
評価は現在のリポジトリディレクトリに対して実行されます。
実行内容
/readiness-report を実行すると、droid はリポジトリの包括的な評価を実行します:
- 言語検出 — 設定ファイルとソースコードに基づいてリポジトリの言語(JavaScript/TypeScript、Python、Rust、Go、Java、Ruby)を特定
- サブアプリケーション発見 — リポジトリがモノレポか単一のサービス/パッケージ/ライブラリかを判定。モノレポの場合、この手順でリポジトリ内のすべての独立してデプロイ可能なアプリケーションを特定
- 基準評価 — 5つすべての成熟度レベルにわたって基準をチェック
- レポート保存 — Factory アプリでの視覚化のため評価結果を永続化
- サマリー出力 — 評価結果を含む人間が読みやすいレポートを出力
- 修復 (近日公開) — 失敗した基準を選択して自動修正するオプション
出力の理解
評価後、構造化されたレポートが表示されます:
達成レベル
リポジトリの現在の成熟度レベル(1-5):
- レベル1:機能的 — 基本的なツールが整備されている
- レベル2:文書化済み — プロセスと文書化が確立されている
- レベル3:標準化済み — セキュリティと可観測性が設定されている
- レベル4:最適化済み — 迅速なフィードバックと継続的な測定
- レベル5:自律的 — 自己改善システム
発見されたアプリケーション
モノレポの場合、レポートは発見された各アプリケーションを簡単な説明とともに一覧表示します:
Example:
1. apps/web - Main Next.js application for user interface
2. apps/api - Backend API service
基準結果
評価された各基準にはスコアと根拠が割り当てられます:
**Style & Validation**
- Linter Configuration: 2/2 - ESLint configured in both applications
- Type Checker: 2/2 - TypeScript strict mode enabled
- Pre-commit Hooks: 0/1 - No husky or lint-staged configuration found
各基準のスコアは numerator/denominator の形式で表示され、ここで:
- 分子: 基準を満たすサブアプリケーションの数
- 分母: 評価されたサブアプリケーションの数
アクションアイテム
レポートは次のレベルに到達するための2-3の最も影響力の高い推奨事項で終了します:
Action Items:
- Add pre-commit hooks with husky to enforce linting and formatting
- Configure branch protection rules on the main branch
- Add AGENTS.md with setup and development instructions
過去のレポートの表示
すべての準備状況レポートは自動的に保存され、web dashboard で表示できます。これにより以下が可能になります:
- 時間の経過とともに準備状況の進歩を追跡
- リポジトリ間でスコアを比較
- チームと結果を共有
Run /readiness-report periodically (e.g., after major infrastructure
changes) to track your organization’s progress toward higher readiness levels.
修復(近日公開)
/readiness-report の実行後、CLI から直接失敗した基準を自動的に修正できるようになります:
- 評価結果をレビュー
- 修復したい失敗した基準を選択
- droid が修正を実装(例:pre-commit フックの追加、AGENTS.md の作成、ブランチ保護の設定)
これにより、レポートは診断ツールから自動化された改善ワークフローに変わります。