AI 개발 워크플로우

ralphy-spec

스펙 기반 개발 + AI 반복 실행
OpenSpec + Ralph Loop를 한 번의 명령으로

🔄
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가 중간에 멈춤 → 루프가 재시도
검증 불가 → 테스트가 검증
수동 설정 → 한 번의 명령

감사의 말

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