안내형 설정 oah init

하네스를 손으로 꾸리려면 맞춰야 할 파일, 도구, 로그인이 많고, 프로젝트를 몰래 바꾸는 설정은 믿기 어렵다.

1. 프로젝트 안에서 oah init을 실행한다.
2. 단계별 에이전트 파일, 훅, 게이트 검사기 unlazy, 지식 그래프, CI 시작 워크플로, 동반 앱 Orca와 Aside, TypeSafe Jev 재정렬기, 스킬 자동 업데이트를 하나씩 한 번 묻는다.
3. 도구를 모두 확인하고 사용자가 확인한 것만 설치하며, Claude Code와 Codex 로그인을 각 도구의 상태 명령으로 확인하고 빠졌으면 실행할 명령을 알려 준다.
4. 전체 계획을 승인하면 .oah/config.toml, AGENTS.md의 규칙 블록(CLAUDE.md가 불러온다), docs/wiki/의 위키, .oah/templates/의 템플릿, 로컬 비밀 파일을 위한 .gitignore 항목을 쓰고 첫 영향 지도를 만든다.
5. 마지막 줄은 OAH_INIT_DONE이거나 남은 일과 함께 OAH_INIT_INCOMPLETE다. 쓴 파일을 커밋하면 그다음부터는 설치된 규칙이 AI에게 하네스를 진행하는 방법을 알려 준다.

원격이 연결된 git 저장소에서 프로젝트마다 한 번 실행한다.

oah init

• 설치된 oah와 원격이 연결된 git 저장소.
• 질문마다 --with-unlazy, --without-ci 같은 옵션이 있어 묻지 않고 답할 수도 있다.

• 두 번째로 실행하면 아직 빠진 것만 쓴다. --force 없이는 기존 파일을 바꾸지 않고, 위키의 색인과 로그는 언제나 그대로 둔다.
• init은 Python 바이트코드 패턴을 .gitignore에 넣지 않는다. 따라 하기 예제는 게이트를 돌리기 전에 __pycache__/와 *.py[cod]를 더한다.
• unlazy를 고칠 때 --force는 피한다. 맞지 않는 프로젝트 사본을 바꾸지 못하고 .oah/config.toml을 기본값으로 되돌릴 수 있다.
• v0.3.0에서는 작업이 끝난 뒤의 도구 업데이트도 한 번 묻는다.

• README.ko.md ↗탐색기에서 열기
• hello-oah(영문) › 2. Set up oah in the project ↗탐색기에서 열기
• docs/ko/upgrade.md ↗탐색기에서 열기
• 동작 방식 › 처음 실행하기 ↗탐색기에서 열기

• 설치와 oah doctor
• 선택 설치하는 훅
• 동반 앱 Orca와 Aside
• CI 스타터