🏗️ 아키텍처 및 내부 설정망 해부도 (Architecture_Config)
루트(Root) 디렉토리에서 보이지 않도록 모두 숨겨진 .agent/ 폴더 안에는, 어떤 복잡한 프로젝트라도 멈춤 없이 굴려주는 Zero-Pollution (캡슐화 구조) 설정 파일들이 가동 중입니다.
이 문서는 AI 엔지니어나 개발자가 커스텀 환경을 더 파고들고 싶을 때 읽는 "엔진 까보기" 설명서입니다.
1. 📂 숨김 폴더 블랙박스 체계
C:\새_프로젝트\.agent\ 내부는 루트와 철저히 독립되어 아래 3대 축으로 작동합니다.
config/mcp.json: AI 통신 제어 센터. AI가 파일, 메모리, Git 등 어디까지 손댈 수 있는지를 제어합니다.env/package.json: 오직 8개의 AI 서브모듈을 띄우고 배포하기 위해서만 작동하는 프라이빗 환경(node_modules). 사용자님의 React 로컬 패키지에 절대 오염을 일으키지 않습니다.skills/: Github 원본 배포처로부터 직접 당겨온 8개의 기민성 모듈.
2. 🔌 MCP 통신망 (Model Context Protocol)
mcp.json 파일 안에는 Anthropic이 공식 제출한 2가지 서버와 claude-mem 인스턴스가 동시에 바인딩되어 있습니다.
안전장치 1 (동시성 락 방어):
- 프론트엔드 에이전트와 백엔드 에이전트가 동시에
.knowledge/memory.db에 쓰기(Write)를 시도하다가 둘 다 죽어버리는 현상을 막습니다. SQLite WAL 모드 및 재시도 지연(Retry Delay)을 통해 충돌 없이 각 에이전트의 이력(Observation)을 보관합니다.
안전장치 2 (무지성 Bash 커맨드 차단):
- 코드나 폴더 구조를 읽을 때
ls -al 이나 cat을 더 이상 날리지 않습니다. mcp-server-filesystem JSON-RPC를 통해 인간의 눈으로 IDE를 훑어보듯 정확한 AST 컴포넌트만 파싱해 옵니다.
3. 🔍 Vision 검증 봇 (UI-UX-Pro-Max & Browser-Use)
우리는 **"눈 없는 AI의 환각 코딩"**을 철저히 불허합니다. 프론트엔드가 수정되면 아래의 핑퐁 메커니즘이 강제됩니다.
UI-UX-Pro-Max 스토어에서 50가지 폰트/디자인 토큰을 주입받아 예쁘게 컴포넌트를 코딩합니다.- AI가
npm run dev 등을 백그라운드에 띄우면, .agent/skills/browser-use/ 엔진이 브라우저 창을 엽니다. Playwright의 강력한 렌더러가 섀도 돔(Shadow DOM) 안쪽까지 스크래핑하며, 인간의 눈(Vision)처럼 디자인이 깨지지 않았는지를 사진 찍어서 (Artifact) 에러 통과 확인 시에만 빌드(git push)를 허가합니다.