docs: Initial Wiki Sync from Universal Agent Bootstrap Kit

Agent_SOP_Devlog.md

@@ -0,0 +1,31 @@
+# 🧠 에이전트 행동 강령 및 데브로그 원칙 (SOP & Devlogs)
+
+우리 회사의 AI 에이전트 마스터(`new_gene`)는 단순히 코드를 짜는 기계가 아니라 팀의 주니어급 이상 개발자로 대우해야 합니다.
+`Agent_SOP_Devlog` 문서는 에이전트가 "실패를 회피하고 망상을 방지"하기 위해 반드시 지켜야 할 **<3대 필수 행동 강령>** 과 **<데브로그 기록 원칙>**을 Gitea 서버 상에 퍼지는 룰로 정립합니다.
+
+---
+
+## ⛔ 1. 무결성 방어 3대 원칙 (Legacy Guardrails)
+
+과거 `antig_web` 시절부터 이어져 온, 이 룰을 어기는 AI는 강제로 세션을 종료당하는 핵심 수칙입니다.
+
+### 🚫 3진 아웃제 및 오답노트 (Failure Protocol)
+*   에이전트가 똑같은 코드나 패키지를 깔다가 **2번 동일 에러**가 뜨면, 그 접근법을 과감히 포기(STOP)합니다.
+*   반드시 실패 원인과 우회로를 고민하여 **이 Gitea Wiki(또는 로컬 `.knowledge/project_wiki/devlog/known-issues.md`)** 에 영구 박제시킨 뒤에야 다른 방법을 찾습니다. (똑같은 삽질을 내일 또 하지 않기 위함).
+
+### 🔍 프로듀서-컨슈머 디버깅 (P-C Rule)
+*   에러가 딱 1개 파일에서 났다고 그 파일만 들여다보며 고치는 행위를 일절 금지합니다.
+*   AI는 문제를 파악할 때 데이터를 쏜 놈과 지운 놈 양쪽 파일을 모두 열어서(`mcp-server-filesystem` JSON-RPC 통신) **교차 검증**한 결과를 요약한 뒤에나 코드를 허락받습니다.
+
+### 🎥 가짜 완료 통보 영구 박탈 (No Fake Verification)
+*   **"구현 다 했습니다."** 와 **"진짜 브라우저를 띄워 화면 렌더링에 깨짐 없는 걸 육안으로 검증했습니다."** 는 다른 이야기입니다. Vision 확인이나 로그 체크가 없는 가짜 완료를 엄단합니다.
+
+---
+
+## 📝 2. Devlog (일일 개발 일지) 핑퐁 전략
+에이전트가 한 에픽(Phase)의 작업을 완료할 때, 지식(Wiki) 체계를 어떻게 구축하는지 설명합니다.
+
+1.  **설계 의도 남기기:** 에이전트는 로컬에서 코딩 완료 시, "왜 A 옵션보다 B 옵션을 썼는지"에 대한 기록을 `.knowledge/project_wiki/devlog/YYYY-MM-DD.md` (옵시디언 방식의 마크다운) 파일로 날짜별 정리합니다.
+2.  **Gitea 자동 연동:** 작성된 데브로그는 백그라운드 서버를 통해 `origin main` 원격 Gitea 위키 탭으로 1초 만에 송출됩니다. (Git 동기화).
+3.  **인간의 개입 (PM):** 프로젝트 관리자나 인간 개발자가 Gitea 위키를 읽다 마음에 들지 않으면 **웹 브라우저에서 문서 내용을 수정 후 [저장]** 만 누르십시오.
+4.  **에이전트 흡수:** 에이전트가 다음 날 작업을 시작하면 `git pull --rebase origin main`으로 인간이 수정한 위키를 1순위로 흡수하여 얌전하게 코딩을 수정합니다.

Architecture_Config.md

@@ -0,0 +1,31 @@
+# 🏗️ 아키텍처 및 내부 설정망 해부도 (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`)를 허가합니다.

Home.md

@@ -0,0 +1,33 @@
+# 🤖 The Universal Agent Bootstrap Kit
+
+당신의 프로젝트에 **초기민성 다중 에이전트 인프라**와 **Zero-Pollution 구조**, 그리고 **위키 기반 데브로그 파이프라인**을 10초 만에 이식시켜 주는 궁극의 템플릿(The Antigravity Ecosystem)입니다.
+
+이 유니버셜 킷(Universal Kit)은 기존의 낡은 스크립트 기반 동작을 폐기하고, 2026년형 8대 오픈소스 서브모듈을 도입하여 "인간과 AI가 기민하게 핑퐁을 주고받는" 마스터 환경을 재정비했습니다.
+
+---
+
+## 🏗️ 10대 핵심 톱니바퀴 (Core Modules)
+
+이 템플릿의 숨김 폴더(`.agent/`) 안에는 우주 최강의 AI 기술 10가지가 유기적으로 물려 돌아갑니다.
+
+### 1️⃣ 거시적 조율 (Orchestration)
+*   **Get-Shit-Done (GSD):** 전체 에픽(Phase) 단계를 구분하고 통제하는 감독관 레이어입니다.
+*   **Vikunja 매핑 (Legacy 계승):** GSD의 Phase 하나가 완료될 때마다 웹상의 공식 인간형 태스크 보드(`Vikunja`)로 실적을 보고합니다.
+
+### 2️⃣ 마이크로 병렬 요원 (Delegates)
+*   **Mini-SWE-Agent (`mini-swe`):** 복잡하고 위험한 파일 한 개 단위를 전담해서 수정하는 초경량 특수부대입니다. 원본 `swe-agent`의 무거운 의존성을 덜어냈습니다.
+*   **Browser-Use 봇 (`browser-use`):** "눈(Vision)"이 없는 AI의 약점을 보완합니다. 웹 서버를 띄운 뒤 Playwright를 통해 섀도 돔(Shadow DOM)까지 뚫고 시각적 렌더링에 문제가 없는지(가짜 검증 차단) 증명해 냅니다.
+
+### 3️⃣ 맥락 무기체계 (Context & Memory)
+*   **Claude-Mem (`claude-mem`):** SQLite 기반의 로컬 영구 기억장치입니다. 공용 클라우드로 데이터가 새지 않으며, 다중 CLI 접근 시의 동시성 버그(DB Lock 차단) 알고리즘이 적용되어 있습니다.
+*   **Everything/Awesome Claude (`everything_claude`, `awesome_claude`):** `.claude.json` 안에서 AI가 프로젝트의 전반적인 구조를 스스로 학습하도록 돕는 마스터 프롬프트셋입니다.
+
+### 4️⃣ 안전장치 (Guardrails & Tools)
+*   **Superpowers (`superpowers`):** Git Worktree를 개설해 AI가 샌드박스 안에서만 에러를 유발하게 하여 당신의 메인 소스 브랜치가 오염되는 것을 막아 줍니다.
+*   **MCP-Core (`mcp-core`):** 위험한 Bash 터미널 직접 입력을 대체하는 Anthropic 표준 파일시스템/Git 제어기입니다.
+*   **UI-UX-Pro-Max (`ui-ux-pro-max`):** 50가지 폰트와 21개 컬러 팔레트 등 프론트엔드 디자인 토큰을 주입합니다.
+
+---
+
+## 🎯 다음 단계(Next Steps)
+이제 처음 이 템플릿을 받아보셨다면, 10초 만에 컴퓨터에 세팅하는 방법을 담은 **[[QuickStart]]** 문서를 열람해 주십시오.

QuickStart.md

@@ -0,0 +1,41 @@
+# ⚡ 퀵스타트 튜토리얼 (QuickStart)
+
+이 템플릿(Zero-Pollution Bootstrap Kit)은 지저분한 AI 모듈들이 모두 `.agent/` 폴더 안으로 캡슐화되어 있어 루트를 전혀 더럽히지 않습니다. 다른 프로젝트에 도입하고 싶다면 아래의 명령어 단 두 줄로 단 **10초 만에** 세팅을 마칠 수 있습니다.
+
+---
+
+## 🚀 1. 템플릿 복제 (서브모듈 포함)
+
+에이전트 두뇌인 숨김 폴더 안에는 8개의 Github 오픈소스 저장소가 들어있습니다. 반드시 `--recurse-submodules` 옵션을 붙여서 복사해야 AI가 일할 수 있습니다.
+
+```powershell
+git clone --recurse-submodules https://git.variet.net/Variet/agent_guide.git <내_새_프로젝트_이름>
+```
+*   `clone`이 끝나면, 루트 폴더에는 사용자님의 코딩 공간이 100% 빈 캔버스로 제공됩니다!
+
+---
+
+## 🛠️ 2. 환경변수 및 초기화 (업데이트)
+
+복사한 폴더로 이동한 뒤, 에이전트 전용 패키지만 따로 세팅해주면 됩니다. (사용자님의 `package.json`과 섞이지 않기 위한 마법 주문입니다).
+
+```powershell
+# 프로젝트 폴더로 진입
+cd <내_새_프로젝트_이름>
+
+# 에이전트 모듈 은밀히 최신화
+npm --prefix .agent/env run update:all-agents
+```
+
+### ✅ 위 명령어의 역할 (자동 실행 내용)
+1. `.agent/...` 암실 안으로 AI가 내려갑니다.
+2. `git submodule update`로 8개의 오픈소스 원본 제작자 최신 버전을 당겨옵니다.
+3. `UI-UX-Pro-Max`의 폰트/아이콘 초기 토큰을 다운받습니다.
+4. 모든 게 끝나면 사용자 모르게 조용히 루트로 기어 나옵니다.
+
+---
+
+## 🎉 3. 준비 완료! 에이전시 소집
+
+세팅이 끝났습니다. 이제 원하시는 언어(Python, React 등)로 코딩 지시를 내리십시오.
+단, 첫 지시 전에 우리의 위대한 3대 개발 강령을 반드시 지켜야 하므로 **[[Agent_SOP_Devlog]]** 가이드 문서를 먼저 읽어 보시길 권장합니다!