왜 oah인가
oah는 각자에게 맞고 AI가 발전하는 만큼 함께 바뀌는 개발 환경을 만들도록 돕습니다. 가져다 고쳐 쓸 수 있는 참고 구현이자 가이드라인입니다. 코드를 만드는 것만으로 작업이 끝나지는 않습니다. 어디까지 바꿀지 정하고, 결과를 검증하고, 다음 세션이 읽을 기록도 남겨야 합니다. oah는 이 과정들을 연결해 하나의 요청이 작업과 확인, 기록까지 이어지게 합니다.
예전 규칙과 스킬은 새 모델의 능력을 막거나 결과를 나쁘게 만들 수 있습니다. 기본값은 이해하고 바꾸기 쉬워야 하며, 작업을 가로막는 규칙은 고쳐야 할 설계 문제입니다. 도움이 되는 것은 남기고 필요 없어진 것은 지웁니다. 전체 구성으로 시작해도 되고, 영향 지도·위키·리스·증거 게이트·리뷰 반복 가운데 프로젝트에 필요한 부분만 가져가도 됩니다.
이 역할 배정은 측정한 비교가 아니라 저자의 경험에서 나왔습니다. Claude는 첫 버전에서 초보자가 놓칠 세부를 채우고, Codex는 정해진 범위 안에서 검사하고 고칩니다. 현재 명령은 Claude Code와 Codex CLI를 움직입니다. 그 안의 아이디어는 다른 도구나 하네스에도 적용할 수 있고, AI 하나만 써도 여러 AI를 함께 써도 됩니다. 각 단계는 작업에 맞는 AI에게 맡기세요.
원하는 결과를 평소 말로 요청합니다. AI는 목표와 범위를 적고, 변경의 영향을 살피고, 고칠 경로를 예약하고, 작업에 쓸 도구를 고릅니다. Claude가 구현하면 Codex가 검토하고 수정한 뒤 다시 검토합니다. 게이트는 검사와 결과를, 프로젝트 위키는 결정과 이유를 코드 옆에 남깁니다. v0.3.0에서는 선택형 TypeSafe Jev가 난이도를 판단해 모델 선택에 반영할 수 있습니다. 사용할 수 없거나 확신이 낮으면 규칙이 판단합니다.
사용자는 요청하고, AI가 판단을 물으며 멈추면 답하고, 반영 전에 확인합니다. 같은 문제가 반복되거나 설계 선택이 필요해지면 작업을 계속 밀어붙이지 않고 사용자의 답을 구합니다. “리뷰 끝났어?”, “게이트 다 통과했어?”라고 물어보고 증거를 살펴보세요. 코드를 만드는 일, 결과를 검사하는 일, 반영을 승인하는 일은 각각의 단계이며 마지막 확인은 사용자에게 남습니다.
oah는 MIT 라이선스로 공개된 무료 오픈소스입니다. 소스를 읽고 고치고, 유용한 부분을 내 작업 방식에 가져다 쓸 수 있습니다. 함께 사용하는 AI 도구와 선택형 서비스는 각자의 계정과 이용 요금을 따릅니다. 현재 v0.3.0은 macOS와 네이티브 Windows를 지원하며 git과 pull request에 익숙한 개발자를 위한 버전입니다. 설치한 뒤 프로젝트에서 oah init을 실행하고 작은 hello-oah 예제로 시작해 보세요. 설치 안내와 문서에서 각 단계를 확인할 수 있습니다.
검토한 커밋의 공개 문서 고정 사본입니다. 파일을 고르고, EN/KO를 바꾸고, ⌘K로 검색하세요.
고정된 공개 문서 · cc0c0b6