Architecture Analysis

Self-Evolving
System

Claude Code 하네스 엔지니어링의 폐루프 자가진화 시스템. 실수에서 규칙이 태어나고, 규칙이 스스로 강해지며, 효과가 자동으로 검증됩니다.

33
Hooks
12
Hard Enforced
51
Auto-Improvements
31+
Never Do Rules
Core Concept
폐루프 자가개선

일반적인 Claude Code / Cursor 설정은 정적입니다. 사람이 규칙을 미리 작성하고, AI가 따르거나 무시합니다. 이 시스템은 3개의 피드백 루프가 자동으로 돌며 스스로 강해집니다.

Loop 1 — Reactive

실수 학습

fix: 커밋이 발생하면 자동으로 감지하여 scaffold에 NEVER DO 규칙을 추가합니다.

→ fix: 커밋 발생
→ self-improve-trigger.sh 감지
→ diff 분석 → 패턴 추출
→ scaffold NEVER DO 추가
→ exit 2 동일 패턴 차단
Loop 2 — Proactive

불만 학습

사용자 불만 키워드를 자동 수집하여 근본 원인을 분석하고 규칙을 생성합니다.

→ "왜이래", "안돼", "또" 감지
→ feedback-detector.sh 수집
→ feedback.jsonl 기록
→ /self-improve Phase 0 분석
→ 근본 원인 → 규칙 생성
Loop 3 — Meta

효과 검증

규칙 추가 후 30일 경과하면 자동으로 효과를 평가하여 강제력을 조정합니다.

→ 규칙 추가 후 30일 경과
→ rule-effectiveness-check.sh
→ 재발 0건: effective
→ 재발 1건: warning
→ 재발 2건+: SOFT→HARD 승격
Enforcement
SOFT → HARD 자동 승격

모든 다른 시스템은 규칙이 SOFT로 영원히 남습니다. 이 시스템은 재발 횟수에 비례하여 강제력이 자동으로 올라갑니다.

1st
Soft Rule
rules/*.md에 자연어 규칙 추가.
AI가 무시할 수 있음.
→
2nd
Pattern Match
scaffold NEVER DO에 추가.
violation-check.sh 경고.
→
3rd
Hard Block
soft-to-hard-promoter.sh 자동 승격.
exit 2 무시 불가능.
Comparison
에이전트 시스템과의 비교
시스템 규칙 생성 규칙 강제 실수 학습 크로스세션 자가 진화
Devin (Cognition) 사용자 수동 Playbook 없음 세션 메모리 없음
OpenHands (ex-OpenDevin) 사용자 수동 Microagent 세션 내 없음 없음
Codex (OpenAI CLI) 사용자 수동 Sandbox 세션 내 없음 없음
Cline / Roo Code 사용자 수동 Mode Rules 없음 없음 없음
이 시스템 자동 생성 Hook exit 2 크로스세션 자동 6개 영구 저장소 폐루프 진화
Architecture
시스템 구성 요소 간 관계
Input — 자동 감지
사용자 불만 → feedback-detector.sh
fix: 커밋 → self-improve-trigger.sh
에러 3회 → error-tracker.sh
↓
Analysis Engine — /self-improve
Phase 0: 불만 분석
Phase 1: Memory-Bank 검색
Phase 1.45: SOFT→HARD 판정
Phase 1.5: fix diff → scaffold 진화
Phase 1.6: Pruning
Phase 1.7: Cross-Project 승격
Phase 2: 방향성 필터
Phase 2.5: 효과 30일 평가
Phase 3-4: 생성 → 적용
↓
Output — 규칙 생성
scaffold NEVER DO 추가
rules/*.md 글로벌 규칙
violation-check.sh 패턴
self-improve.jsonl 이력
↓
Enforcement — 12개 HARD Hooks
scaffold-violation-check.sh
code-quality-check.sh
qa-gate-before-push.sh
no-localstorage.sh
no-env-commit.sh
portless-required.sh
auto-validate.sh
task-quality-gate.sh
html-api-gate.sh
validate-before-commit.sh
verify-before-deploy.sh
subagent-verify.sh
Differentiators
핵심 차이점 5가지
특성 Devin / OpenHands / Codex 이 시스템
규칙 생성 사용자가 Playbook/Microagent 작성 fix: 커밋에서 자동 추출
강제력 프롬프트 주입 (우회 가능) bash hook exit 2 (하네스 차단)
프로젝트 학습 범용 규칙 or 수동 설정 프로젝트별 독립 scaffold 진화
크로스세션 Devin만 부분 지원 6개 영구 저장소에 축적
효과 측정 측정 없음 30일 자동 평가 + SOFT→HARD 승격
Per-Project
프로젝트별 독립 진화

각 scaffold가 해당 프로젝트의 fix: 커밋에서만 학습합니다. 2개 이상 프로젝트에서 동일 패턴 발견 시 글로벌 rule로 자동 승격.

article21-page
21
never do rules
Vue / PrimeVue 관리자
bisframework
25
never do rules
BIS 프레임워크
match-system
6
never do rules
Kotlin + Next.js
memory-bank
—
never do rules
Python
Evolution History
자동 개선 실제 이력

article21-page-scaffold에서 자동 추출된 규칙들. 모든 규칙이 실제 fix: 커밋에서 생성.

2026-03-20
accountPwd → password
6f81cfa
필드명
2026-03-20
contact → contactPhoneNum
6cc9da8
필드명
2026-03-20
scrollable + scrollHeight 필수
2955142
UI패턴
2026-03-20
FileDropZone 강제 (input[type=file] 금지)
d8874d4
컴포넌트
2026-03-24
localStorage 사용 금지
12401e8
보안
2026-03-24
Controller 중복 매핑 방지
a010d1f
백엔드
2026-03-25
action→actionType, code→permissionCode
8192370
필드명
2026-03-26
RichEditor plain text 변환 필수
5998c50
에디터
2026-03-30
DatePicker fluid 필수
9b8ab68
UI패턴
2026-03-30
AutoComplete completeOnFocus + fluid 필수
c908607
UI패턴
2026-03-30
handleSubmit에 Toast 필수
c95ec93
UX
2026-03-30
form 초기값 DB NOT NULL Boolean 기본값 필수
4197f23
데이터
Roadmap
현재 한계와 고도화 방향
한계 현재 상태 가능한 고도화
Memory-Bank 통합 SKILL.md에 선언, 실행 코드 부분적 MCP 도구 직접 호출로 완전 통합
행동 패턴 차단 코드 패턴만 HARD "확인해주세요" 같은 행동도 감지
규칙 품질 키워드 기반 패턴 매칭 AST 기반 정밀 분석
효과 측정 시스템 7일차 (too_early) 30일 경과 후 본격 작동
Conclusion
폐루프의 힘
개방 루프 (일반 하네스)
사람이 규칙 작성 → AI에게 제시 → 끝
폐루프 (이 시스템)
실수 감지 → 자동 규칙 생성 → HARD 강제 → 효과 측정 → 미효과 시 강화

7일간 51건의 자동 개선, 4개 프로젝트 독립 scaffold, 12개 HARD hook이 이 루프의 산물입니다. 시스템은 사용할수록 강해지며, 사용자의 개입은 에스컬레이션 시에만 필요합니다.