사용 방법

시작 전에 알아둘 구조

Elio 실행 하나는 RUN_ID로 구분됩니다. 같은 RUN_ID와 --repo를 사용하면 연구 요청서, 보고서, 근거 원장, 계획, 승인과 검증 결과를 같은 기록에서 이어갑니다.

ContextResearchEvidenceDecisionRequirementChange · Test

두 종류의 승인을 구분하세요.

implementation 승인은 계획대로 격리 worktree에서 구현할 권한이고, git 승인은 검증 이후 diff 지문을 사람이 확인했다는 기록입니다. 어느 승인도 commit이나 push를 자동으로 수행하지 않습니다.

1. 설치와 환경 확인

공개 게시 뒤에는 다음처럼 정확한 버전을 설치합니다. npm 패키지 페이지에서 버전을 확인하기 전에는 실행하지 마세요.

terminal

npm install --global @pengveloper/elio@0.1.0
elio --version
elio doctor --repo . --json

저장소 clone은 일반 설치 경로가 아닙니다.

source map, 타입 선언, 소스, 테스트와 내부 문서는 npm 패키지에서 제외합니다. 배포된 JavaScript는 열람할 수 있으므로 난독화를 보안 경계로 주장하지 않습니다.

2. 저장소 준비

init

elio init --repo .
elio doctor --repo .

init은 .r2c/ 제어 폴더와 .r2cignore를 만들고 실행 기록 경로를 Git 제외 목록에 추가합니다.

3. 실행과 연구 인계

manual research

elio run --repo . --task "입력 검증 방식을 조사하고 계획해줘"
elio status RUN_ID --repo .
elio export RUN_ID --target chatgpt --output RESEARCH.md

내보낸 요청서를 사용해 ChatGPT에서 Deep Research를 직접 실행합니다. 보고서를 Markdown으로 저장한 뒤 다음 단계로 이동합니다.

4. 보고서 가져오기와 계획

import and resume

elio import RUN_ID --stage research --file REPORT.md --repo .
elio resume RUN_ID --repo .
elio next RUN_ID --repo .

5. 근거와 추적 연결 검토

자동으로 발견한 URL과 주장 후보를 확인하고, 필요한 출처는 제목, 게시자, 확인일, 유형과 신뢰 등급을 보정합니다. 이어서 결정과 요구사항에 어떻게 연결됐는지 조회합니다.

evidence and trace

elio evidence list RUN_ID --repo .
elio evidence review-source RUN_ID --source SRC-001 --title "공식 문서 제목" --publisher "게시자" --source-type official --trust-tier primary --retrieved-at 2026-07-21 --repo .
elio trace RUN_ID --repo .
elio trace RUN_ID --repo . --json

trace는 조회 전용입니다. 구현 전에는 계획된 요구사항과 검증을, 구현 뒤에는 change map의 파일·검증·결과를 표시합니다.

6. 승인 준비도 확인

readiness로 승인 판단에 필요한 기록을 한 번 더 모아 봅니다. review-required는 승인이 금지됐다는 뜻이 아니라 사람이 확인할 경고가 남았다는 뜻입니다. blocked는 승인할 수 없으며, 각 검사의 확인·조치를 수행해야 합니다. 경고가 남았다면 내용을 검토한 뒤 명시적으로 확인을 기록합니다.

approval readiness

elio readiness RUN_ID --repo .
elio readiness RUN_ID --repo . --json

7. 구현 승인

계획 파일과 예상 범위를 먼저 검토하세요.

승인 명령은 구현을 허용하는 상태 변경입니다. 실제 builder Codex CLI adapter는 구현됐지만 실제 계정 실행 검증 전입니다. 기본 local verifier는 기준 commit, diff 형식과 민감 경로를 검사하며 저장소 테스트를 실행했다고 주장하지 않습니다. 구현 뒤에는 elio review RUN_ID로 변경 목록과 지문을 확인한 다음 출력된 승인 명령을 사용합니다.

approval

elio approve RUN_ID --gate implementation --acknowledge-warnings --repo .
elio resume RUN_ID --repo .

8. 구현 뒤 diff와 최종 승인

실제 Codex CLI builder를 선택한 실행은 구조 검증을 통과해도 자동 완료되지 않습니다. review의 파일과 지문을 실제 worktree diff 및 필요한 저장소 테스트와 대조한 뒤, 출력된 digest로 최종 승인을 기록합니다.

final review

elio review RUN_ID --repo .
elio trace RUN_ID --repo .
elio approve RUN_ID --gate git --digest REVIEW_DIGEST --repo .
elio report RUN_ID --format html --repo .

명령 빠른 참조

명령	언제 쓰나	데이터 변경
`doctor`	Node, Git, 선택 provider 진단	없음
`init`	제어 폴더와 ignore 경계 준비	설정 생성
`run`	새 RUN_ID와 연구 요청 시작	기록 생성
`status` / `next`	현재 상태와 다음 행동 확인	없음
`export` / `import`	수동 연구 요청·보고서 인계	원본 보존
`evidence`	출처 목록과 승인 전 검토	review-source만 변경
`trace`	근거→결정→요구사항→변경·검증 조회	없음
`readiness`	승인 차단 조건과 검토 경고 확인	없음
`approve`	implementation 또는 git gate 기록	승인 변경
`resume`	대기·실패 지점에서 다음 단계 실행	workflow 진행
`review` / `report`	지문과 전체 결과 확인	report만 생성

실패했을 때

elio status RUN_ID --repo . --json에서 failedFrom과 오류를 확인합니다.
elio next RUN_ID --repo .로 재시도 가능 여부를 확인합니다.
원인을 고친 뒤 허용된 단계만 elio resume으로 다시 실행합니다.
검증 뒤 worktree가 바뀌었다면 다시 resume해 지문을 갱신합니다.

진단과 보고서

elio doctor, elio status, elio next, elio report RUN_ID --format html로 현재 환경, 상태, 다음 작업과 결과를 확인할 수 있습니다.

상태·산출물 표는 상태·산출물 문서, 환경별 Codex 요청은 Codex 사용 안내, 구현된 큰 변화는 업그레이드 로그에서 확인할 수 있습니다. 같은 페이지의 반드시 확인과 알려진 제한 탭도 실행·승인·게시 전에 확인하세요.