chore: 프로젝트 초기 구조 + .agent 워크플로우 + 설계 문서

README.md

@@ -0,0 +1,32 @@
+# Variet Agent
+
+AI Agent Team — Gemini CLI 기반 자동화 개발 에이전트 시스템
+
+## 목표
+
+사용자가 디스코드에서 추상적 명령을 주면, AI Agent Team이 작업을 분석/분해/실행하고, Gitea CI로 PR/빌드/배포까지 수행.
+
+## 핵심 특징
+
+- **Context Manager**: Gemini CLI의 Context Rot 문제 해결 (관련 파일만 선별 주입)
+- **역할별 Headless 호출**: `gemini -p`로 매번 독립 컨텍스트
+- **API 추상화**: Discord / Web UI 동일 파이프라인
+- **Gitea + Vikunja 연동**: PR/CI/태스크 자동 관리
+
+## 구조
+
+```
+api/            # FastAPI 서버 + Discord Bot
+core/           # Orchestrator, Context Manager, Pipeline
+integrations/   # Gitea, Vikunja, CI
+prompts/        # 역할별 프롬프트
+sessions/       # 작업 로그
+docs/           # 설계 문서
+```
+
+## 환경
+
+- Python 3.12 (`C:\ProgramData\miniforge3\envs\quant`)
+- Gemini CLI v0.32+ (AI Ultra)
+- Gitea: git.variet.net
+- Vikunja: plan.variet.net/projects/7