From ebdc6b805b37e37f962b14e6c1b4e3364eb381a9 Mon Sep 17 00:00:00 2001 From: Variet Agent Date: Wed, 11 Mar 2026 00:31:59 +0900 Subject: [PATCH] chore: migrate .agent/ to .agents/ directory structure --- .agent/README.md | 67 ------------------- {.agent/.agents => .agents}/AGENT.md | 6 ++ {.agent/.agents => .agents}/GUIDE.md | 0 .../references/architecture.md | 0 .../references/conventions.md | 7 ++ .../references/known-issues.md | 0 .../references/tech-stack.md | 0 .../workflows/check-gitea.md | 0 .../workflows/check-vikunja.md | 0 .../.agents => .agents}/workflows/debug.md | 0 {.agent/.agents => .agents}/workflows/end.md | 0 .../workflows/helpers/vikunja_helper.py | 0 .../workflows/helpers/wiki_helper.py | 0 .../.agents => .agents}/workflows/pre-task.md | 0 .../.agents => .agents}/workflows/services.md | 0 .../.agents => .agents}/workflows/start.md | 0 16 files changed, 13 insertions(+), 67 deletions(-) delete mode 100644 .agent/README.md rename {.agent/.agents => .agents}/AGENT.md (90%) rename {.agent/.agents => .agents}/GUIDE.md (100%) rename {.agent/.agents => .agents}/references/architecture.md (100%) rename {.agent/.agents => .agents}/references/conventions.md (85%) rename {.agent/.agents => .agents}/references/known-issues.md (100%) rename {.agent/.agents => .agents}/references/tech-stack.md (100%) rename {.agent/.agents => .agents}/workflows/check-gitea.md (100%) rename {.agent/.agents => .agents}/workflows/check-vikunja.md (100%) rename {.agent/.agents => .agents}/workflows/debug.md (100%) rename {.agent/.agents => .agents}/workflows/end.md (100%) rename {.agent/.agents => .agents}/workflows/helpers/vikunja_helper.py (100%) rename {.agent/.agents => .agents}/workflows/helpers/wiki_helper.py (100%) rename {.agent/.agents => .agents}/workflows/pre-task.md (100%) rename {.agent/.agents => .agents}/workflows/services.md (100%) rename {.agent/.agents => .agents}/workflows/start.md (100%) diff --git a/.agent/README.md b/.agent/README.md deleted file mode 100644 index a27f130..0000000 --- a/.agent/README.md +++ /dev/null @@ -1,67 +0,0 @@ -# Agent Guide — AI 에이전트 범용 워크플로우 시스템 - -> AI 코딩 에이전트가 더 똑똑하게 동작하도록 설계된 범용 워크플로우 템플릿. -> 새 프로젝트에서 `.agents/` 폴더를 통째로 복사하고, `{{PLACEHOLDER}}`를 교체하면 즉시 사용 가능합니다. - -## Quick Start - -```bash -# 1. 이 레포를 클론하거나 .agents/ 폴더를 복사 -git clone https://git.variet.net/Variet/agent_guide.git -cp -r agent_guide/.agents/ your-project/.agents/ - -# 2. 프로젝트별 값 2개만 교체 -# - {{GITEA_REPO}} → services.md, check-gitea.md, wiki_helper.py -# - {{VIKUNJA_PROJECT_ID}} → services.md, vikunja_helper.py (PROJECT_ID) -# - references/ → 프로젝트별 아키텍처, 기술스택, 컨벤션 채우기 - -# 3. docs/devlog/ 디렉토리 생성 -mkdir -p docs/devlog/entries - -# 4. AI 에이전트에게 "시작" 또는 "/start" 명령 -``` - -## 파일 구조 - -``` -.agents/ -├── AGENT.md ← 🧠 글로벌 NEVER/ALWAYS 규칙 -├── GUIDE.md ← 📖 상세 가이드 -├── references/ ← 📚 프로젝트 지식 베이스 -│ ├── architecture.md ← 아키텍처 (템플릿) -│ ├── tech-stack.md ← 기술 스택 (템플릿) -│ ├── conventions.md ← 코딩 컨벤션 (템플릿) -│ └── known-issues.md ← 과거 실패 기록 (공통 이슈 포함) -└── workflows/ ← ⚙️ 행동 절차 - ├── start.md ← 세션 시작 (룰 로딩 + Git + Vikunja + Wiki) - ├── end.md ← 세션 종료 (학습 기록 + Vikunja + Git) - ├── pre-task.md ← 작업 전 필수 체크리스트 - ├── debug.md ← 체계적 디버깅 - ├── services.md ← 서비스 연동 정보 ({{PLACEHOLDER}}) - ├── check-gitea.md ← Gitea 현황 조회 - ├── check-vikunja.md ← Vikunja 태스크 조회 - └── helpers/ - ├── vikunja_helper.py ← Vikunja API 안전 래퍼 - └── wiki_helper.py ← Gitea Wiki 래퍼 -``` - -## 교체해야 하는 값 (프로젝트별) - -> Gitea/Vikunja 토큰은 이미 입력되어 있습니다. 프로젝트별로 아래 2개만 교체하면 됩니다. - -| Placeholder | 설명 | 파일 | -|-------------|------|------| -| `{{GITEA_REPO}}` | Gitea 저장소명 | services.md, check-gitea.md, wiki_helper.py | -| `{{VIKUNJA_PROJECT_ID}}` | Vikunja 프로젝트 ID | services.md, vikunja_helper.py (`PROJECT_ID`) | - -## 상세 가이드 - -[GUIDE.md](.agents/GUIDE.md) 참조. - -## 연구 기반 - -7개 AI 에이전트 플랫폼 (Claude, GPT, Gemini, Cursor, Cline, Roo, Windsurf) 분석 + Reflexion Framework, Context Engineering, Sentinel Check 등 최신 연구 기반. - -## License - -Internal — Variet diff --git a/.agent/.agents/AGENT.md b/.agents/AGENT.md similarity index 90% rename from .agent/.agents/AGENT.md rename to .agents/AGENT.md index 148d8b9..e918b96 100644 --- a/.agent/.agents/AGENT.md +++ b/.agents/AGENT.md @@ -47,6 +47,12 @@ description: 모든 작업에 자동 적용되는 에이전트 행동 규칙. 4. `.agents/workflows/services.md` (service credentials & protocols) 5. `.agents/workflows/` (action procedures) +## Python Environment + +- **경로**: `C:\ProgramData\miniforge3\envs\quant` +- **실행**: `C:\ProgramData\miniforge3\envs\quant\python.exe` +- 모든 Python 스크립트 실행 시 위 경로의 python을 사용합니다. + ## PowerShell Notes - `curl` → PowerShell에서 `Invoke-WebRequest` 별칭. **반드시 `curl.exe`** 사용 diff --git a/.agent/.agents/GUIDE.md b/.agents/GUIDE.md similarity index 100% rename from .agent/.agents/GUIDE.md rename to .agents/GUIDE.md diff --git a/.agent/.agents/references/architecture.md b/.agents/references/architecture.md similarity index 100% rename from .agent/.agents/references/architecture.md rename to .agents/references/architecture.md diff --git a/.agent/.agents/references/conventions.md b/.agents/references/conventions.md similarity index 85% rename from .agent/.agents/references/conventions.md rename to .agents/references/conventions.md index eb86240..be79d6c 100644 --- a/.agent/.agents/references/conventions.md +++ b/.agents/references/conventions.md @@ -22,6 +22,13 @@ - 주석 언어: 한국어 (모듈/함수 docstring은 한국어) - Type hints: 사용 권장 (`def foo(x: float) -> np.ndarray:`) +## Python 환경 + +- **경로**: `C:\ProgramData\miniforge3\envs\quant` +- **실행**: `C:\ProgramData\miniforge3\envs\quant\python.exe` +- 모든 Python 스크립트 실행 시 위 경로의 python.exe를 사용 +- PowerShell에서: `& "C:\ProgramData\miniforge3\envs\quant\python.exe" script.py` + ## 커밋 메시지 ``` diff --git a/.agent/.agents/references/known-issues.md b/.agents/references/known-issues.md similarity index 100% rename from .agent/.agents/references/known-issues.md rename to .agents/references/known-issues.md diff --git a/.agent/.agents/references/tech-stack.md b/.agents/references/tech-stack.md similarity index 100% rename from .agent/.agents/references/tech-stack.md rename to .agents/references/tech-stack.md diff --git a/.agent/.agents/workflows/check-gitea.md b/.agents/workflows/check-gitea.md similarity index 100% rename from .agent/.agents/workflows/check-gitea.md rename to .agents/workflows/check-gitea.md diff --git a/.agent/.agents/workflows/check-vikunja.md b/.agents/workflows/check-vikunja.md similarity index 100% rename from .agent/.agents/workflows/check-vikunja.md rename to .agents/workflows/check-vikunja.md diff --git a/.agent/.agents/workflows/debug.md b/.agents/workflows/debug.md similarity index 100% rename from .agent/.agents/workflows/debug.md rename to .agents/workflows/debug.md diff --git a/.agent/.agents/workflows/end.md b/.agents/workflows/end.md similarity index 100% rename from .agent/.agents/workflows/end.md rename to .agents/workflows/end.md diff --git a/.agent/.agents/workflows/helpers/vikunja_helper.py b/.agents/workflows/helpers/vikunja_helper.py similarity index 100% rename from .agent/.agents/workflows/helpers/vikunja_helper.py rename to .agents/workflows/helpers/vikunja_helper.py diff --git a/.agent/.agents/workflows/helpers/wiki_helper.py b/.agents/workflows/helpers/wiki_helper.py similarity index 100% rename from .agent/.agents/workflows/helpers/wiki_helper.py rename to .agents/workflows/helpers/wiki_helper.py diff --git a/.agent/.agents/workflows/pre-task.md b/.agents/workflows/pre-task.md similarity index 100% rename from .agent/.agents/workflows/pre-task.md rename to .agents/workflows/pre-task.md diff --git a/.agent/.agents/workflows/services.md b/.agents/workflows/services.md similarity index 100% rename from .agent/.agents/workflows/services.md rename to .agents/workflows/services.md diff --git a/.agent/.agents/workflows/start.md b/.agents/workflows/start.md similarity index 100% rename from .agent/.agents/workflows/start.md rename to .agents/workflows/start.md