AI 코딩 에이전트를 위한 로컬 작업 프레임

Claude, Codex,Gemini를 오가도작업 기준은 하나로.

한 모델로 시작하고, 막히면 다른 모델의 시선을 불러오고, 필요할 땐 같은 작업 상태 위에서 리드 모델을 바꿉니다. 마지막은 검증으로 닫습니다.

pre-release v0.0.4 243 tests 런타임 의존성 0 Node 22.5+
# 이미 쓰는 에이전트에서 시작합니다.
$ framein start "Google OAuth 추가"
contract set: email login 보존
lead claude

# 다른 모델에게 범위를 좁혀 검토를 맡깁니다.
$ framein challenge "OAuth callback state in session" --run
reviewer codex
verdict change required
required nonce/state 검증 추가

# 필요하면 리드 모델을 바꾸고, 검증으로 닫습니다.
$ framein capsule gemini
next lead facts:
contract · diff · tests · decisions

$ framein ship
build ok · tests 42/42
risk high: auth/ touched
=> READY WITH HUMAN GATE
왜 필요한가

좋은 프롬프트만으로는작업이 계속 이어지지 않습니다.

PRD, Plan, ADR, 스킬팩이 잘 갖춰지면 어떤 모델이든 더 잘 일합니다. 문제는 리드 모델이 막히거나, 다른 모델의 외부 시선이 필요하거나, 쿼터와 모델 적합성 때문에 전환하고 싶을 때 시작됩니다.

Framein은 새 IDE나 자동 에이전트 팀이 아닙니다. 이미 쓰는 Claude, Codex, Gemini 아래에 하나의 로컬 작업 프레임을 둡니다.

막힌 리드 모델한 모델이 같은 계획이나 실패 모드만 반복합니다.
단일 모델의 사각지대설계, 보안, 테스트 관점에서 다른 모델의 검토가 필요합니다.
전환할 때 리셋모델을 바꿀 때마다 의도, 위험, 결정을 다시 설명해야 합니다.
검증 없는 마무리마지막 답변은 여전히 빌드, 테스트, 위험 게이트를 통과해야 합니다.
작업 루프

시작하고, 챌린지하고,전환하고, 검증합니다.

1

시작

framein start가 구현이 흔들리기 전에 요청을 공유 작업 계약으로 고정합니다.

2

챌린지

framein challenge가 다른 리뷰어 역할에게 제한된 반론을 요청합니다.

3

전환

framein capsule이 계약, diff, 검증 결과, ADR, ledger에서 다음 리드가 읽을 사실을 준비합니다.

4

검증

framein verifyship이 빌드/테스트와 위험 게이트로 작업을 닫습니다.

익숙한 사용감

스킬처럼 부르고,상태는 프로젝트에 남깁니다.

Claude와 Gemini slash command

/fr:*가 에이전트 세션 안에서 같은 로컬 엔진을 호출합니다.

Codex project skill

$fr-*가 deprecated prompt 파일 없이 같은 동사를 제공합니다.

기존 스킬팩과 페르소나

프롬프트 프레임워크는 그대로 두고, 계약·원장·게이트만 공유합니다.

터미널, CI, MCP 클라이언트

CLI, JSON 출력, wrapper, MCP 서버가 같은 로컬 작업 프레임을 읽고 씁니다.

실제 저장소에서 시작

설치해 두면, 모델을 오가도같은 작업 프레임을 씁니다.

공개 npm 릴리스 전까지는 GitHub release tarball로 설치합니다. 아래는 수동으로 확인하는 가장 작은 흐름입니다. 실제 사용에서는 에이전트가 /fr:* 또는 $fr-*로 같은 작업 프레임 동사를 호출할 수 있습니다.

gh release download v0.0.4 -R jahoku/framein -p "*.tgz"
npm i -g ./framein-0.0.4.tgz

cd your-project
framein init
framein integrations install all --write

framein start "가장 작은 안전한 변경 완료하기"

# 다른 모델의 검토나 전환이 필요할 때
framein challenge "구현 전 계획 검토" --run
framein capsule codex

framein verify
framein ship
신뢰 경계

로컬 우선.자격증명 중계 없음.

로컬 작업 프레임

작업 계약, ADR, 메모리, 원장, 검증 결과, 락은 저장소 안에 남습니다. SQLite store는 캐시이고 JSON snapshot은 git 친화 원천입니다.

프록시가 아닙니다

Framein은 제공자 자격증명을 수집하지 않고, 구독을 공유하지 않고, MCP 도구를 릴레이하지 않고, 터미널 입출력 장치(TTY)를 화면 스크래핑 방식으로 읽지 않습니다.