Claude, Codex,Gemini를 오가도작업 기준은 하나로.
한 모델로 시작하고, 막히면 다른 모델의 시선을 불러오고, 필요할 땐 같은 작업 상태 위에서 리드 모델을 바꿉니다. 마지막은 검증으로 닫습니다.
# 이미 쓰는 에이전트에서 시작합니다.
$ framein start "Google OAuth 추가"
contract set: email login 보존
lead claude
# 다른 모델에게 범위를 좁혀 검토를 맡깁니다.
$ framein challenge "OAuth callback state in session" --run
reviewer codex
verdict challenge
required nonce/state 검증 추가
lead 요구 변경 수용
# 필요하면 리드 모델을 바꾸고, 검증으로 닫습니다.
$ framein capsule gemini
next lead facts:
contract · diff · tests · decisions
$ framein ship
build ok · tests passed
risk high: auth/ touched
=> READY WITH HUMAN GATE다른 모델에게 challenge하고,맥락을 잃지 않고 handoff합니다.
결제 관련 작업을 예로, 작업 계약, 독립 모델 challenge, 검증 증거, 다음 에이전트가 이어받을 수 있는 capsule 흐름을 보여줍니다.
좋은 프롬프트만으로는작업이 계속 이어지지 않습니다.
PRD, Plan, ADR, 스킬팩이 잘 갖춰지면 어떤 모델이든 더 잘 일합니다. 문제는 리드 모델이 막히거나, 다른 모델의 외부 시선이 필요하거나, 쿼터와 모델 적합성 때문에 전환하고 싶을 때 시작됩니다.
Framein은 새 IDE나 또 하나의 에이전트 하네스가 아닙니다. 이미 쓰는 Claude Code, Codex, Gemini, Pi, OpenCode, 스킬 워크플로 아래에 하나의 로컬 작업 프레임을 둡니다.
하네스가 엔진이라면, Framein은 그 엔진들이 함께 기록하는 공용 로그북입니다.
시작하고, 챌린지하고,전환하고, 검증합니다.
시작
framein start가 구현이 흔들리기 전에 요청을 공유 작업 계약으로 고정합니다.
챌린지
framein challenge가 리뷰어 판정, lead 1회 응답, 결정 브리프를 만듭니다.
전환
framein capsule이 계약, diff, 검증 결과, ADR, ledger에서 다음 리드가 읽을 사실을 준비합니다.
검증
framein verify와 ship이 빌드/테스트와 위험 게이트로 작업을 닫습니다.
스킬처럼 부르고,상태는 프로젝트에 남깁니다.
/fr:*가 에이전트 세션 안에서 같은 로컬 엔진을 호출합니다.
$fr-*가 deprecated prompt 파일 없이 같은 동사를 제공합니다.
프롬프트 프레임워크는 그대로 두고, 계약·원장·게이트만 공유합니다.
CLI, JSON 출력, wrapper, MCP 서버가 같은 로컬 작업 프레임을 읽고 씁니다.
설치해 두면, 모델을 오가도같은 작업 프레임을 씁니다.
npm으로 설치한 뒤 실제 프로젝트 안에서 Framein을 초기화합니다. 실제 사용에서는 에이전트가 /fr:* 또는 $fr-*로 같은 작업 프레임 동사를 호출할 수 있습니다.
npm 경로는 Node 22.5+ 환경의 Windows, macOS, Linux, WSL에서 동작합니다. Standalone 실행 파일은 Node와 Framein을 함께 담아 Windows npm shim 마찰을 줄이는 추가 편의 경로로 준비 중입니다.
npm install -g framein
framein --version
cd your-project
framein init
framein integrations install all --write
framein start "가장 작은 안전한 변경 완료하기"
# 다른 모델의 검토나 전환이 필요할 때
framein challenge "구현 전 계획 검토" --run
framein capsule codex
framein verify
framein ship새 하네스가 아닙니다.토큰도 중계하지 않습니다.
또 다른 하네스인가요?
아닙니다. Claude Code, Codex, Gemini, Pi, OpenCode는 그대로 작업 표면입니다. Framein은 그 아래에서 작업 상태를 저장소에 유지합니다.
제공자 토큰을 다루나요?
아닙니다. 자격증명을 수집하지 않고, 모델 트래픽을 프록시하지 않고, 구독을 공유하지 않습니다. 인증은 공식 CLI에 남습니다.
상태는 어디에 저장되나요?
저장소 안에 남습니다. git 친화 JSON snapshot과 로컬 SQLite cache를 씁니다. 전체 FAQ 보기.
로컬 우선.자격증명 중계 없음.
로컬 작업 프레임
작업 계약, ADR, 메모리, 원장, 검증 결과, 락은 저장소 안에 남습니다. SQLite store는 캐시이고 JSON snapshot은 git 친화 원천입니다.
프록시가 아닙니다
Framein은 제공자 자격증명을 수집하지 않고, 구독을 공유하지 않고, MCP 도구를 릴레이하지 않고, 터미널 입출력 장치(TTY)를 화면 스크래핑 방식으로 읽지 않습니다.