001 / 만든 이유
oah는 각자에게 맞고 AI가 발전하는 만큼 함께 바뀌는 개발 환경을 만들도록 돕습니다. 가져다 고쳐 쓸 수 있는 참고 구현이자 가이드라인입니다. 코드를 만드는 것만으로 작업이 끝나지는 않습니다. 어디까지 바꿀지 정하고, 결과를 검증하고, 다음 세션이 읽을 기록도 남겨야 합니다. oah는 이 과정들을 연결해 하나의 요청이 작업과 확인, 기록까지 이어지게 합니다.
설치·운영v0.3.0에서 사용 가능
AI는 oah init이 설치한 규칙과 각 명령의 다음 단계 안내를 따라 대화 아래에서 oah 명령을 실행한다. 모든 명령은 --help를 받고, 종료 코드는 정해져 있으며(0 완료, 1 거절, 2 사용법, 69 환경, 75 대기 시간 초과), 모든 거절은 OAH_* 코드로 시작해 다음에 실행할 것을 알려 준다.
AI가 도구를 대신 실행하면 사용자는 설명서를 외우지 않고도 각 명령이 무엇을 했고 다음에 무엇을 해야 하는지 알아야 한다.
init, doctor, packet, intent, preflight, start/renew/status/finish/release/log, recommend, models, call/wait, gates, check, wiki, impact, eval, graph, review, fix, land, rules, skills, hooks, ci가 있다.oah fix는 다다른 단계부터 다음 단계를 한 줄씩 출력한다. 순서대로 따른다.다음 명령을 알려 주는 결과 줄(따라 하기 예제의 예시 리뷰 결과).
OAH_REVIEW_CHANGES_REQUESTED: R1 of task hello-name requested changes (P1×1). Correct them (oah fix --task hello-name runs Codex for that), commit, then run oah review --task hello-name again2는 oah preflight의 ABORT 판정이기도 하다. [abort] 줄을 모두 고치고 다시 시도한다.75는 실행이 아직 진행 중인데 oah wait이 제한 시간에 닿았다는 뜻이다. oah wait <run-id>를 다시 실행한다.oah eval은 정답을 숨긴 실제 사례를 다시 돌려 변형마다 결과와 한계를 보고한다.