ralph

Ralph - 自律型エージェント

Ralph は大規模なプロジェクトをユーザーストーリーに分割し、自律的に実行します。ワークフローは次のとおりです。

1. PRD を作成する - 受け入れ基準を含むユーザーストーリーを定義します
2. 実行する - ralph.mjs create --prd path/to/prd.json --start
3. 監視する - ralph.mjs logs <session-id> --follow

PRD の作成

プロジェクトフォルダーを作成し、prd.json を用意します。

.claude/skills/ralph/projects/<project-name>/prd.json

PRD の構造

{
  "description": "Brief description of the feature",
  "branchName": "feature/my-feature",
  "userStories": [
    {
      "id": "US001",
      "title": "Short descriptive title",
      "description": "As a [user], I want [feature] so that [benefit]",
      "acceptanceCriteria": [
        "Specific testable criterion",
        "Typecheck passes"
      ],
      "priority": 1,
      "passes": false
    }
  ]
}

ストーリーのガイドライン

• 優先度 1：基盤 — マイグレーション、型、基本コンポーネント
• 優先度 2～3：コア機能
• 優先度 4 以上：二次機能、仕上げ
• 各ストーリーで扱うファイルは 1～3 個にし、10 ファイルに及ぶリファクタリングは避けます
• 受け入れ基準に「型チェックが通ること」を含めます

CLI コマンド

どのコマンドを実行した場合も、デーモンは自動的に起動します。

セッションの実行

# Create and start a session
ralph.mjs create --prd path/to/prd.json --start

# List all sessions
ralph.mjs list

# Check session status
ralph.mjs status <session-id>

# Follow logs in real-time
ralph.mjs logs <session-id> --follow

セッションの制御

# Pause a session
ralph.mjs pause <session-id> --reason "Waiting for API"

# Resume with guidance
ralph.mjs resume <session-id> --guidance "API is ready on port 3000"

# Inject guidance into running session
ralph.mjs inject <session-id> --message "Try using the helper in utils.ts"

# Abort a session
ralph.mjs abort <session-id>

オーケストレーション（マルチレベル）

子セッションを起動するオーケストレーター PRD の場合：

# Spawn a child session
ralph.mjs spawn <parent-id> --prd child/prd.json --start

# List children of a session
ralph.mjs children <session-id>

# Wait for all children to complete
ralph.mjs wait <session-id>

# View session tree
ralph.mjs tree <session-id>

# Abort parent and all children
ralph.mjs abort <session-id> --cascade

PRD の種類

種類	ユースケース
code（デフォルト）	機能を実装し、コードをコミットする
orchestrator	複数のサブ Ralph を調整する
testing	ブラウザー自動化テスト

prd.json の "type": "orchestrator" で設定します。

CLI リファレンス全文

完全なドキュメントを確認するには、ralph.mjs --help を実行します。