규칙 승격 체계

규칙을 많이 쓰는 것보다 **검증된 규칙만 유지하는 것**이 더 중요하다.

ai-rules의 핵심 차별점. 실제 프로젝트에서 검증된 패턴만 규칙으로 승격된다.

---

왜 승격 체계가 필요한가

규칙을 많이 쓰는 것보다 검증된 규칙만 유지하는 것이 더 중요하다.

• 검증 없이 규칙을 추가하면 CLAUDE.md가 비대해지고 노이즈가 된다
• 실제로 AI가 어긴 패턴과 어기지 않은 패턴을 구분해야 한다
• 승격 체계가 없으면 "모든 것이 규칙"이 되어 아무것도 규칙이 아니게 된다

---

승격 단계

복사candidate → validated → recommended → mandatory

단계	의미	저장 위치	승격 조건
candidate	한 프로젝트에서 제안된 패턴	docs/guide/RULE_CANDIDATES.md	실제 사고/반복 실수에서 파생
validated	2개 이상 프로젝트에서 검증	extensions/ 또는 core/ 초안	동일 패턴이 2개 프로젝트에서 재현
recommended	core에 포함, 선택 적용	core/*.md	3개 이상 프로젝트에서 효과 확인
mandatory	모든 프로젝트 필수 적용	core/*.md + profiles/global.yaml	보안/데이터 손실 방어 또는 광범위 적용 확인

---

승격 프로세스

1. Candidate 등록

실제 사고나 반복 실수가 발생했을 때 docs/guide/RULE_CANDIDATES.md에 등록:

복사## [CANDIDATE] {규칙 이름}

- **발생 프로젝트**: AITEM
- **발생 날짜**: 2026-04-01
- **사고 내용**: HTML 목업 파일이 있었으나 AI가 발견하지 못하고 임의 디자인으로 구현
- **근본 원인**: "스캔 금지" 규칙이 신규 프로젝트 탐색 자체를 차단
- **제안 규칙**: 탐색 앵커 부재 시 1회 제한 탐색 허용
- **상태**: candidate

2. Validated 전환 조건

동일 패턴이 2개 이상 프로젝트에서 독립적으로 재현되면 validated로 전환:

• FAILURE_LOG.md에서 동일 증상 2회 이상 확인
• 또는 다른 프로젝트에서 같은 규칙이 필요하다는 요청

3. Recommended 전환 조건

• 3개 이상 프로젝트에서 적용 후 재발 0회
• 규칙 적용 전/후 재발률 비교 가능한 경우

4. Mandatory 전환 조건

다음 중 하나:

• 보안 또는 데이터 손실 직결 (03-security, 07-db 수준)
• 5개 이상 프로젝트에서 mandatory 없이는 사고 반복됨이 확인

---

강등 조건 (Demotion)

규칙이 실제로 도움이 안 되거나 역효과를 내면 강등 또는 삭제:

조건	조치
규칙을 따랐는데 더 많은 실수 발생	candidate로 강등 후 재검토
3개 이상 프로젝트에서 항상 예외 처리됨	삭제 또는 기본값 반전
더 좋은 규칙이 같은 문제를 커버함	중복 제거 (상위 규칙만 유지)

---

현재 규칙 승격 이력

규칙	단계	최초 프로젝트	날짜
08-ui-first (HTML 목업 우선 탐색)	recommended	AITEM	2026-04-01
탐색 앵커 부재 예외 (05-responses)	candidate	AITEM	2026-04-01
DB migrate reset 금지 (07-db)	mandatory	AX-Studio	2026-04-01
git stash drop 금지 (04-workflow)	mandatory	AITEM	2026-03-xx
SESSION.md HANDOFF 패턴 (06-session)	recommended	AITEM	2026-03-xx

참고:

• mandatory는 보안/데이터 손실 방어 또는 광범위 검증을 통과한 규칙에만 부여한다.
• 특정 규칙이 이미 여러 프로젝트에 배포되어 있어도, 승격 단계는 실제 검증 수준 기준으로 관리한다.

---

Adoption Matrix (프로젝트별 채택 현황)

규칙 파일	global	aitem	ax-studio	lro-engine	ai-saas
00-identity	✅	✅	✅	✅	✅
01-git	✅	✅	✅	✅	✅
02-code	✅	✅	✅	✅	✅
03-security	✅	✅	✅	✅	✅
04-workflow	✅	✅	✅	✅	✅
05-responses	✅	✅	✅	✅	✅
06-session	✅	✅	✅	✅	✅
07-db	✅	✅	✅	✅	✅
08-local-env	✅	✅	✅	✅	✅
08-ui-first	✅	✅	✅	✅	✅
aitem-frontend ext	❌	✅	❌	❌	❌
aitem-backend ext	❌	✅	❌	❌	❌
ax-studio-contracts ext	❌	❌	✅	❌	❌

업데이트 주기: 새 프로젝트 추가 또는 규칙 승격/강등 시.