Living Handbook 시작

`ai-rules`는 원래 규칙과 동기화 시스템 중심으로 설계되었다. 하지만 실제 운영 과정에서 규칙의 배경, 하네스 설계 철학, 위험도 체계 같은 내용을 노션이 아닌 저장소 안에서 함께 관리할 필요가 커졌다.

배경

ai-rules는 원래 규칙과 동기화 시스템 중심으로 설계되었다. 하지만 실제 운영 과정에서 규칙의 배경, 하네스 설계 철학, 위험도 체계 같은 내용을 노션이 아닌 저장소 안에서 함께 관리할 필요가 커졌다.

이번 변경은 ai-rules를 단순 rule set이 아니라 living handbook으로 확장하기 위한 첫 단계다.

이번에 추가한 것

• docs/00_INDEX.md 진입점 문서
• docs/guide/HARNESS_ENGINEERING.md
• docs/guide/AI_RISK_TIERS.md
• docs/guide/AI_VIBE_CODING_GUIDE.md
• docs/changes/ 변화 기록 디렉토리 시작

의도

• 규칙과 참고 가이드를 분리한다.
• handbook 안에서 설계 배경과 예시를 관리한다.
• 날짜별 판단 변화와 운영 철학을 누적 기록한다.
• 안정화된 내용만 나중에 core/ 규칙으로 승격한다.

문서 계층

• core/, extensions/: 실제 실행 규칙
• docs/guide/: 배경지식, 사례, 운영 가이드
• docs/changes/: 변경 이력과 이유

다음 단계

• HARNESS_ENGINEERING.md 기반으로 충돌 매트릭스와 가역성 원칙을 실제 규칙으로 승격할지 검토
• risk tier를 manifest나 validation 로직과 연결할지 검토
• handbook 진입 링크를 README.md 또는 관련 guide에 추가할지 검토