AI開発ワークフロー

ralphy-spec

スペック駆動開発 + AI反復実行
OpenSpec + Ralph Loopを1つのコマンドで

🔄
Ralph Loop AIがタスク完了まで反復を通じて自己修正
📋
OpenSpec 構造化されたスペックがコード作成前に意図を固定
⚡
Ralphy-Spec 自律エージェントワークフローで本番レベルのプロジェクトをデプロイ—コンテキストウィンドウの制限なし
始める ソースを見る

クイックスタート

01 インストール (cd プロジェクト)
npx ralphy-spec init
02 コマンドを使用
/ralphy:plan → 要件からスペック作成
/ralphy:implement → 反復ループでビルド
/ralphy:validate → 受け入れ基準を検証
/ralphy:archive → 完了してアーカイブ
作成されるファイル
.cursor/prompts/
├── ralphy-plan.md
├── ralphy-implement.md
├── ralphy-validate.md
└── ralphy-archive.md

openspec/
├── specs/
├── changes/
└── project.md
例
# Plan
/ralphy:plan Add user authentication with JWT

# Implement
/ralphy:implement add-user-auth

# Validate
/ralphy:validate

# Archive
/ralphy:archive add-user-auth
/ralphy:plan → 要件からスペック作成
/ralphy:implement → 反復ループでビルド
/ralphy:validate → 受け入れ基準を検証
/ralphy:archive → 完了してアーカイブ
作成されるファイル
.claude/commands/
├── ralphy-plan.md
├── ralphy-implement.md
├── ralphy-validate.md
└── ralphy-archive.md

openspec/
├── specs/
├── changes/
└── project.md
例
# Plan
/ralphy:plan Add payment processing with Stripe

# Implement
/ralphy:implement add-payments

# Validate & Archive
/ralphy:validate && /ralphy:archive add-payments
"Follow AGENTS.md to plan [feature]"
"Follow AGENTS.md to implement [change]"
"Follow AGENTS.md to validate"
"Follow AGENTS.md to archive [change]"
作成されるファイル
AGENTS.md

openspec/
├── specs/
├── changes/
└── project.md

.ralphy/
├── config.json
└── ralph-loop.state.json
Ralph Loopランナーと一緒に
npm install -g @th0rgal/ralph-wiggum

ralph "Follow AGENTS.md to implement add-api. \
  Output <promise>DONE</promise> when complete." \
  --max-iterations 20

仕組み

01

Ralph Wiggum Loop

AIがタスク完了まで同じプロンプトを繰り返し受け取ります。各イテレーションで、ファイルの以前の作業を見て自己修正します。

while !done; do
  ai "Build X. Output DONE when complete."
done
02

OpenSpec

コードより先にスペック。構造化されたスペックと受け入れ基準により、AIが何をビルドすべきか正確に分かります。

openspec/
├── specs/      # Truth
├── changes/    # Work
└── archive/    # Done
ワークフロー
計画 PRD → スペック
→
実装 ループ
→
検証 テスト
→
アーカイブ マージ
なぜ効果的か
曖昧な要件 → スペックが意図を固定
AIが途中で停止 → ループがリトライ
検証不可 → テストが検証
手動セットアップ → 1つのコマンド

謝辞

Ralph Methodology Geoffrey Huntley opencode-ralph-wiggum @Th0rgal OpenSpec Fission-AI