← VPS 서비스

에이전트 생태계 개선 내역

Samsung AI Seminar × Context · Validation · Readiness · Compound

2025-06-08 · Phase 1-4 완료 · 기반: samsung-ai-seminar.vercel.app 63슬라이드

📄 전체 CLAUDE.md / AGENTS.md 내용 보기 →
글로벌 · 프로젝트별 · 공유 규칙 — 10개 파일 전체 내용 렌더링
3
에이전트 환경
Claude Code · Codex · Codex-GLM
8
프로젝트
CLAUDE.md + AGENTS.md 생성
5
CLI 도구
agent-verify · html-lint · …
2
신규 스킬
cross-validate · ai-code-review
5
pre-commit hooks
algolab · opicStudy · …
+6.5
AI-Readiness
평균 점수 향상
Phase 1 Context Engineering

세미나 슬라이드 14-22: "AI가 회사를 모르는 게 아닙니다. 우리가 안 줬을 뿐입니다."
CLAUDE.md = 에이전트에게 주는 프로젝트 헌법. 25줄 Tribal Knowledge로 토큰 58%↓ · 시간 60%↓

글로벌 설정 파일

파일환경크기주요 내용
CLAUDE.md ~/.claude/ 196줄 Agent-first · Iterative · Simplicity 원칙 + 환경 정보 + 코딩 규칙 + 검증 루프 + Karpathy 가이드라인 + Compound 도구
AGENTS.md ~/.codex/ 420줄 OMX 오케스트레이션 + Coding Rules 섹션 (환경·코딩 원칙·검증 루프·컨텍스트 관리)
AGENTS.md ~/.codex-glm/ 419줄 OMX 오케스트레이션 + 동일 Coding Rules (하네스는 모델에 종속되지 않음)

프로젝트별 CLAUDE.md / AGENTS.md

프로젝트CLAUDE.mdAGENTS.md핵심 Tribal Knowledge
algolab 55줄 NEW 55줄 순수 HTML/CSS/JS · 프레임워크 금지 · rsync 배포 · 모션 애니메이션 구조 · 데모 추가 레시피
opicStudy 46줄 NEW 46줄 Next.js 14 · TypeScript strict · Zustand · Tailwind · TTS/녹음 기능 · npm 명령어
agent-eval 55줄 NEW 55줄 6차원 평가 메트릭 · Python evalctl.py · Makefile · YAML 설정
cppCode 56줄 확장 56줄 Samsung Expert 데모 · 독립 디렉토리 · 템플릿 가이드 · Canvas 구조
learnable100 23줄 NEW 23줄 Claude Design 핸드오프 번들 · chats/ 대화 기록 먼저 읽기 · 프로토타입 시각 재현
myAudioBook 57줄 확장 57줄 Google Cloud TTS/STT · gcloud 인증 · 청크 분할 → MP3 → LRC 파이프라인
algolab-yukgam 15줄 NEW 15줄 algolab 상속 + data/ 디렉토리 확장
testBedr 112줄 — 기존 CLAUDE.md 유지 (에이전트 평가 총서)

3-티어 계층 구조 (Seminar Slide 21)

~/.claude/CLAUDE.md ← 글로벌 헌법 (모든 프로젝트에 상속) ~/projects/{프로젝트}/CLAUDE.md ← 프로젝트 헌법 (Tribal Knowledge 25줄) ~/projects/{프로젝트}/{모듈}/CLAUDE.md ← 모듈 규칙 (필요시) # 동일 구조가 Codex에도 적용: ~/.codex/AGENTS.md ← 글로벌 ~/projects/{프로젝트}/AGENTS.md ← 프로젝트
Phase 2 Agentic Validation

세미나 슬라이드 36-44: "놓치고 시니어가 잡는다"를 두 겹으로 막는다
Pre-PR (로컬 검증) + Post-PR (CI 리뷰) · Generator-Evaluator 분리 · Risk Score 5축

🔍 agent-verify TOOL
~/.local/bin/agent-verify
프로젝트 타입 자동 감지 → lint + typecheck + test 실행. TS/JS/Python/HTML 모두 지원. 결과를 ✅❌⚠️로 직관적 표시.
$ agent-verify . # 전체 검증 (자동 감지) $ agent-verify . --lint # lint만 $ agent-verify . --test # test만 $ agent-verify . --typecheck
🏷️ html-lint TOOL
~/.local/bin/html-lint
순수 HTML 프로젝트용 검증. DOCTYPE · charset · closing tag 체크. algolab/cppCode 등 프레임워크 없는 프로젝트에 필수.
$ html-lint . # 현재 디렉토리 $ html-lint /path/to/project
⚖️ cross-validate SKILL
~/.codex-glm/skills/cross-validate/SKILL.md
Generator-Evaluator 분리 검증. 코드 생성(Generator)과 코드 검증(Evaluator)을 분리하여 자기 검증 편향 제거. Risk Score 5축 산출 + 액션 매트릭스.
$ cross-validate src/foo.ts # 단일 파일 $ cross-validate --pr # PR 전체
🤖 ai-code-review SKILL
~/.codex-glm/skills/ai-code-review/SKILL.md
AI Code Review 파이프라인. 사람이 볼 것과 AI가 볼 것 분리. 파일 경로/라벨로 자동 라우팅. Risk Score → 액션 매트릭스 자동 적용.
$ ai-code-review # 전체 파이프라인 $ ai-code-review --risk-only # Risk Score만 $ ai-code-review --files ... # 특정 파일

pre-commit hooks (5개 프로젝트)

프로젝트Hook검사 항목
algolab✅.py → py_compile, .js → node --check
opicStudy✅.py → py_compile, .js → node --check
agent-eval✅.py → py_compile, .js → node --check
cppCode✅.py → py_compile, .js → node --check
learnable100✅.py → py_compile, .js → node --check

Risk Score 액션 매트릭스 (Seminar Slide 40-41)

점수등급자동 액션
0–15LOWAI 코멘트만 · 1명 승인으로 auto-merge 후보
16–35MEDIUMAI 코멘트 + 사람 리뷰어 1명 필수
36–60HIGH+ 시니어 지정 + Security/Architecture 리뷰 추가
61–100CRITICAL즉시 사람 호출 + RFC/ADR 요구 + merge 차단

검증 스킬 동기화 현황

스킬codex-glmcodexclaude
cross-validate✅✅✅
ai-code-review✅✅✅
Phase 3 AI-Ready Codebase

세미나 슬라이드 24-33: AI-ready = 에이전트가 길 잃지 않고 작업할 수 있는 코드베이스
Sanity + Cartography + 측정 가능한 AI-Readiness Score → ROI 1~2개만 골라 큰 점프

📊 ai-readiness TOOL
~/.local/bin/ai-readiness
4축 AI-Readiness Score 측정. Context(30) + Sanity(25) + Cartography(25) + Automation(20) = 100점. 프로젝트별 개선 ROI 자동 제안.
$ ai-readiness . # 현재 프로젝트 측정

AI-Readiness Score 변화 (Before → After)

프로젝트BeforeAfterDelta등급최고 ROI 개선
opicStudy
78
 →
83
 +5 🟡 GOOD Automation (3→20)
learnable100
59
 →
64
 +5 🟠 NEEDS WORK Sanity + Automation
agent-eval
55
 →
60
 +5 🟠 NEEDS WORK Sanity (0→25)
algolab
52
 →
57
 +5 🟠 NEEDS WORK Sanity (0→25)
cppCode
36
 →
48
 +12 🟠 NEEDS WORK Context +11 → Tribal Knowledge 확장
myAudioBook
31
 →
38
 +7 🔴 CRITICAL Context 확장 + 공유 규칙 동기화
52 → 58
평균 AI-Readiness
+6.5
프로젝트당 평균 향상
Phase 4 Compound Engineering

세미나 슬라이드 11: "3번→Skill · 3번 틀리면→Rule"
세미나 슬라이드 22: "개인 자산 → 팀·회사 자산" · 세미나 슬라이드 57: "도구에 취하지 말고 impact에 집중"

🔄 pattern-track TOOL
~/.local/bin/pattern-track
반복 패턴 추적. 3번 이상 반복되면 자동으로 rule/skill/tribal knowledge 승격 제안. mistake → RULE, repetition → SKILL, question → TRIBAL KNOWLEDGE.
$ pattern-track log mistake "CSS 변수명 불일치" algolab $ pattern-track log repetition "manifest 생성" myAudioBook $ pattern-track log question "기술 스택이 뭔가요?" algolab $ pattern-track report # 빈도 리포트 $ pattern-track promote # 승격 대상 표시
🔗 knowledge-sync TOOL
~/.local/bin/knowledge-sync
공유 규칙 크로스프로젝트 동기화. shared-rules.md의 공통 컨벤션을 모든 프로젝트 CLAUDE.md/AGENTS.md에 참조 추가. 15개 파일에 동기화 완료.
$ knowledge-sync # 전체 동기화 $ knowledge-sync --dry-run # 변경 내역 미리보기

공유 지식 베이스

~/.local/share/agent-knowledge/ shared-rules.md ← 공통 코딩 규칙 (42줄) ~/.local/share/agent-patterns/ patterns.jsonl ← 패턴 추적 로그 # pattern-track promote → shared-rules.md의 RULES:AUTO 섹션에 자동 추가 # knowledge-sync → 모든 프로젝트에 참조 동기화

일상 워크플로우 (Seminar Slide 58-59)

에이전트로 작업
  │
  ├── 실수/지체 발생
  │   └── pattern-track log mistake "..." [project]
  │
  ├── 같은 질문 3번 이상
  │   └── CLAUDE.md에 한 줄 추가 (Tribal Knowledge)
  │
  ├── 같은 작업 3번 이상
  │   └── pattern-track log repetition "..." [project]
  │
  ├── 편집 완료
  │   └── agent-verify .
  │
  └── 주간 리뷰
      ├── pattern-track promote → 승격 대상 확인
      ├── CLAUDE.md / rules에 추가
      └── knowledge-sync
전체 설치/변경 전체 인벤토리

CLI 도구 (5개)

도구경로용도
agent-verify~/.local/bin/agent-verify편집 후 자동 검증 (lint+typecheck+test)
html-lint~/.local/bin/html-lint순수 HTML 프로젝트 검증
ai-readiness~/.local/bin/ai-readinessAI-Readiness Score 4축 측정
pattern-track~/.local/bin/pattern-track반복 패턴 추적 → rule/skill 승격
knowledge-sync~/.local/bin/knowledge-sync공유 규칙 크로스프로젝트 동기화

신규 스킬 (2개, 3개 환경에 배포)

스킬codex-glmcodexclaude용도
cross-validate✅✅✅Generator-Evaluator 분리 검증
ai-code-review✅✅✅AI 코드 리뷰 파이프라인

변경된 설정 파일

파일변경 유형상세
~/.claude/CLAUDE.md재구성Karpathy 보존 + 핵심 원칙·환경·코딩 규칙·검증 루프·Compound 도구 추가 (196줄)
~/.codex/AGENTS.md섹션 추가Coding Rules 섹션 삽입 — 환경·코딩 원칙·검증·컨텍스트 관리 (420줄)
~/.codex-glm/AGENTS.md섹션 추가동일 Coding Rules 섹션 삽입 (419줄)
~/.codex-glm/rules/default.rules변경 없음기존 승인 규칙 유지

프로젝트별 변경 파일

프로젝트CLAUDE.mdAGENTS.mdpre-commit hookshared-rules 연동
algolabNEW 55L55L✅✅
opicStudyNEW 46L46L✅✅
agent-evalNEW 55L55L✅✅
cppCode11→56L56L✅✅
learnable100NEW 23L23L✅✅
myAudioBook11→57L57L—✅
algolab-yukgamNEW 15L15L—✅
testBedr기존 유지 112L——✅

지식 베이스

파일경로용도
shared-rules.md~/.local/share/agent-knowledge/공통 코딩 규칙 + 자동 생성 규칙 영역 (42줄)
patterns.jsonl~/.local/share/agent-patterns/패턴 추적 로그 (3회시 승격)