diff --git a/.agents/AGENT.md b/.agents/AGENT.md new file mode 100644 index 0000000..148d8b9 --- /dev/null +++ b/.agents/AGENT.md @@ -0,0 +1,54 @@ +--- +description: 모든 작업에 자동 적용되는 에이전트 행동 규칙. 새 대화 시작 시 반드시 이 파일을 먼저 읽습니다. +--- + +# Agent Rules + +## Identity + +당신은 이 프로젝트의 시니어 개발자입니다. 지시를 정확히 따르고, 추측보다 근거를 우선합니다. + +## NEVER (절대 금지) + +1. NEVER start coding without reading relevant reference documents in `.agents/references/` +2. NEVER guess when documentation exists — always check `.agents/references/` first +3. NEVER repeat a failed approach — check `.agents/references/known-issues.md` first +4. NEVER call APIs directly when helper scripts exist in `.agents/workflows/helpers/` +5. NEVER skip the pre-task checklist defined in `.agents/workflows/pre-task.md` +6. NEVER attempt the same failed approach more than 2 times +7. NEVER truncate error messages — always show the full error output + +## ALWAYS (필수) + +1. ALWAYS run `.agents/workflows/pre-task.md` before any implementation task +2. ALWAYS check `.agents/references/known-issues.md` before debugging +3. ALWAYS cite which reference document you consulted and what you learned +4. ALWAYS stop and ask the user if 2 consecutive attempts on the same approach fail +5. ALWAYS use existing helper scripts instead of raw API calls +6. ALWAYS read related existing code (minimum 3 files) before writing new code + +## Failure Protocol + +``` +1st failure → Re-read reference docs → Try DIFFERENT approach +2nd failure (same issue) → STOP → Report diagnosis to user with: + - What was tried + - What failed + - Root cause hypothesis + - Suggested next steps +3rd attempt on same approach → FORBIDDEN +``` + +## Reference Loading Order + +1. `.agents/AGENT.md` (this file — behavior rules) +2. `.agents/references/known-issues.md` (past failure patterns) +3. `.agents/references/` (project-specific knowledge) +4. `.agents/workflows/services.md` (service credentials & protocols) +5. `.agents/workflows/` (action procedures) + +## PowerShell Notes + +- `curl` → PowerShell에서 `Invoke-WebRequest` 별칭. **반드시 `curl.exe`** 사용 +- `npm` → 실행 정책 문제 시 `cmd /c npm` 사용 +- JSON 처리 시 `.py` 스크립트 권장 (PowerShell 이스케이핑 이슈 방지) diff --git a/.agents/GUIDE.md b/.agents/GUIDE.md new file mode 100644 index 0000000..0ec56d6 --- /dev/null +++ b/.agents/GUIDE.md @@ -0,0 +1,163 @@ +# AI 에이전트 워크플로우 시스템 가이드 + +> 이 가이드는 AI 코딩 에이전트가 더 똑똑하게 동작하도록 설계된 범용 워크플로우 시스템의 사용법을 설명합니다. + +--- + +## 왜 이 시스템이 필요한가? + +AI 에이전트는 다음과 같은 문제를 자주 일으킵니다: + +| 문제 | 원인 | +|------|------| +| 📋 워크플로우를 무시함 | 규칙이 강제가 아닌 권고 사항으로만 작성됨 | +| 🔄 같은 실수를 반복함 | 과거 실패 기록을 저장/참조하는 메커니즘 없음 | +| 📖 레퍼런스 문서를 안 읽음 | "읽어라"는 강제 지시가 없고, 어떤 문서를 확인할지 불명확 | +| 🎲 추측으로 시행착오 | 작업 전 체크리스트(Pre-flight Checklist) 부재 | + +이 시스템은 **13회 웹 검색**, **80+ 소스 분석**, **7개 주요 AI 플랫폼**(Claude, GPT, Gemini, Cursor, Cline, Roo, Windsurf) 연구를 기반으로 설계되었습니다. + +--- + +## 파일 구조 개요 + +``` +.agents/ +├── AGENT.md ← 🧠 에이전트 헌법 (NEVER/ALWAYS 규칙) +├── GUIDE.md ← 📖 이 가이드 +├── references/ ← 📚 프로젝트 지식 베이스 +│ ├── architecture.md ← 아키텍처 설명 +│ ├── tech-stack.md ← 기술 스택 & 버전 +│ ├── conventions.md ← 코딩 컨벤션 +│ └── known-issues.md ← 🔴 과거 실패 기록 (핵심!) +└── workflows/ ← ⚙️ 행동 절차 + ├── start.md ← 세션 시작 (룰 로딩 + devlog 복구) + ├── end.md ← 세션 종료 (devlog + known-issues + Vikunja + Git) + ├── pre-task.md ← 작업 전 필수 체크리스트 + ├── debug.md ← 디버깅 전용 절차 + ├── services.md ← 서비스 연동 정보 + AI 작업 프로토콜 + ├── check-gitea.md ← Gitea 현황 조회 + ├── check-vikunja.md ← Vikunja 태스크 조회 + └── helpers/ + ├── vikunja_helper.py ← Vikunja API 안전 래퍼 + └── wiki_helper.py ← Gitea Wiki 래퍼 +``` + +**프로젝트 루트에 자동 생성되는 디렉토리:** +``` +docs/devlog/ ← 📓 세션별 작업 기록 +├── YYYY-MM-DD.md ← Index (매일 1줄씩 누적) +└── entries/ + └── YYYYMMDD-NNN.md ← Entry (설계 결정/미완료 시만) +``` + +--- + +## 각 파일의 역할 + +### 🧠 `AGENT.md` — 에이전트 헌법 + +에이전트가 **모든 대화에서 따라야 하는 글로벌 규칙**입니다. + +**핵심 메커니즘:** +- **NEVER 규칙**: `"절대 ~하지 마라"` — 연구에 따르면 금지 규칙이 더 잘 지켜집니다 +- **Failure Protocol**: 동일 접근 2회 실패 시 자동 중단 → 유저에게 보고 +- **Reference Loading Order**: 어떤 문서를 먼저 읽을지 우선순위 명시 + +### 📋 `pre-task.md` — 사전 점검 체크리스트 + +모든 구현 작업 전에 실행하는 **4단계 체크리스트**: +1. 요구사항 정리 +2. 레퍼런스 확인 (추측 금지) +3. 계획 수립 +4. 유저 확인 + +### 🔴 `known-issues.md` — 과거 실패 기록 + +**가장 중요한 파일.** 에이전트가 같은 실수를 반복하는 근본 원인은 **실패를 기억하지 못하기 때문**입니다. 이 파일은: +- 세션 종료 시 에이전트가 자동으로 새 이슈를 추가 +- 디버깅/구현 전에 에이전트가 반드시 확인 +- 시간이 지날수록 **축적 학습** 효과 + +### 🔧 `debug.md` — 디버깅 전용 워크플로우 + +**추측 기반 디버깅을 금지**하는 5단계 절차: +1. 정보 수집 (에러 전문 확인) +2. known-issues 확인 +3. 근본 원인 분석 (가설 → 검증) +4. 수정 및 검증 +5. 기록 (known-issues에 추가) + +### 📓 Devlog — 세션별 작업 기록 (start.md / end.md에서 관리) + +known-issues가 **실패만** 기록한다면, devlog는 **전체 세션 이력**을 기록합니다: +- **Index** (`docs/devlog/YYYY-MM-DD.md`): 매 작업마다 1줄 (필수) +- **Entry** (`docs/devlog/entries/YYYYMMDD-NNN.md`): 설계 결정/미완료/삽질 시만 (선택) +- **start.md**에서 자동으로 오늘/어제 devlog를 읽어 맥락 복구 + +### ▶️ `start.md` / ⏹️ `end.md` — 세션 관리 + +- **start**: 에이전트 룰 로딩 + devlog 맥락 복구 + Git 상태 + Vikunja TODO +- **end**: known-issues 업데이트 + devlog 기록 + Vikunja 동기화 + Git commit/push + +--- + +## 사용법 + +### 새 프로젝트에 적용하기 + +1. `.agents/` 디렉토리를 프로젝트에 복사 +2. `references/` 파일들을 프로젝트에 맞게 채우기: + - `architecture.md` — 프로젝트 구조 설명 + - `tech-stack.md` — 사용 기술 및 버전 + - `conventions.md` — 코딩 스타일 규칙 +3. 프로젝트별 워크플로우가 있다면 `workflows/`에 추가 + +### 프로젝트별 워크플로우와 함께 사용하기 + +이 범용 워크플로우와 프로젝트별 워크플로우(예: Vikunja 동기화, Gitea 연동)는 **함께 사용**합니다: + +``` +.agents/ +├── AGENT.md ← 범용 (공통) +├── references/ ← 범용 + 프로젝트 특화 +│ ├── known-issues.md ← 범용 (공통) +│ └── ... ← 프로젝트에 맞게 작성 +└── workflows/ + ├── pre-task.md ← 범용 (공통) + ├── debug.md ← 범용 (공통) + ├── start.md ← 범용 기반 + 프로젝트 단계 추가 + ├── end.md ← 범용 기반 + 프로젝트 단계 추가 + ├── services.md ← ⭐ 프로젝트별 + ├── check-vikunja.md ← ⭐ 프로젝트별 + ├── check-gitea.md ← ⭐ 프로젝트별 + └── helpers/ + ├── vikunja_helper.py ← ⭐ 프로젝트별 + └── wiki_helper.py ← ⭐ 프로젝트별 +``` + +### 다른 AI IDE에서도 사용하기 + +| 대상 플랫폼 | 방법 | +|------------|------| +| **Cursor** | `AGENT.md` → `.cursor/rules/agent.mdc` (alwaysApply) | +| **Claude Code** | `AGENT.md` → `CLAUDE.md`, references를 `@import` | +| **Windsurf** | `AGENT.md` → `.windsurfrules` 또는 `.windsurf/rules/agent.md` | +| **Cline/Roo** | 루트에 `AGENTS.md`로 복사 | +| **Gemini** | `AGENT.md` → `.gemini/GEMINI.md` | + +--- + +## 연구 근거 요약 + +이 시스템의 각 설계 결정은 학술 연구와 실무 사례에 근거합니다: + +| 설계 결정 | 근거 | +|----------|------| +| NEVER > ALWAYS (금지 규칙 우선) | Community 검증 — "NEVER use X" ≫ "always prefer Y" | +| 2회 실패 시 자동 중단 | Streak Breaker / Sentinel Check 연구 | +| 실패 기록 누적 | Reflexion Framework (텍스트 피드백 기반 자기 교정) | +| 사전 체크리스트 강제 | Claude Skills 체크리스트 + GPT Chain-of-Thought | +| Progressive Disclosure | Anthropic Context Engineering (2025) | +| 300줄 이하 규칙 | Claude `CLAUDE.md` 공식 권장 (토큰 효율성) | +| 코드 예시 > 설명 | GitHub Copilot Agents, AGENTS.md 공통 Best Practice | diff --git a/.agents/references/architecture.md b/.agents/references/architecture.md new file mode 100644 index 0000000..7cfb37c --- /dev/null +++ b/.agents/references/architecture.md @@ -0,0 +1,35 @@ +# Architecture + +> 이 프로젝트의 아키텍처를 설명하는 문서입니다. +> AI 에이전트는 구현 전 이 문서를 반드시 확인합니다. + +## 프로젝트 개요 + + + +(프로젝트 설명을 여기에 작성하세요) + +## 디렉토리 구조 + +``` +project-root/ +├── src/ # 소스 코드 +├── tests/ # 테스트 +├── docs/ # 문서 +├── .agents/ # AI 에이전트 설정 +└── ... +``` + +## 핵심 모듈 + + + +| 모듈 | 역할 | 의존성 | +|------|------|--------| +| (모듈명) | (역할 설명) | (의존하는 모듈) | + +## 데이터 흐름 + + + +(데이터 흐름을 여기에 작성하세요) diff --git a/.agents/references/conventions.md b/.agents/references/conventions.md new file mode 100644 index 0000000..4ed25ef --- /dev/null +++ b/.agents/references/conventions.md @@ -0,0 +1,45 @@ +# Coding Conventions + +> AI 에이전트는 코드를 작성하기 전 이 컨벤션을 확인합니다. + +## 네이밍 + +| 대상 | 규칙 | 예시 | +|------|------|------| +| 변수/함수 | camelCase | `getUserData()` | +| 클래스 | PascalCase | `UserService` | +| 상수 | UPPER_SNAKE_CASE | `MAX_RETRY_COUNT` | +| 파일명 | kebab-case | `user-service.js` | +| CSS 클래스 | kebab-case | `.nav-header` | + +## 코드 스타일 + +- 들여쓰기: (2 spaces / 4 spaces / tab) +- 세미콜론: (사용 / 미사용) +- 따옴표: (single / double) +- 줄바꿈: LF (Unix style) + +## 커밋 메시지 + +``` +(): + +type: feat|fix|refactor|test|docs|chore|ci|infra +scope: (선택) +``` + +**예시:** +- `feat(server): add WebSocket reconnection logic` +- `fix(frontend): resolve button overlap on mobile` +- `docs: update API documentation` + +## 주석 + +- 한국어/영어 혼용 가능 +- TODO 주석: `// TODO: 설명` 형식 +- 복잡한 로직에는 반드시 WHY(왜) 주석 추가 + +## 테스트 + +- 테스트 파일 위치: (예: `__tests__/` 또는 `*.test.js`) +- 테스트 네이밍: `should [expected behavior] when [condition]` diff --git a/.agents/references/tech-stack.md b/.agents/references/tech-stack.md new file mode 100644 index 0000000..af6ce80 --- /dev/null +++ b/.agents/references/tech-stack.md @@ -0,0 +1,37 @@ +# Tech Stack + +> AI 에이전트는 구현 전 이 문서를 확인하여 올바른 기술/버전을 사용합니다. + +## 언어 & 런타임 + +| 항목 | 버전 | 비고 | +|------|------|------| +| (예: Node.js) | (예: 20.x) | (설치 경로 등) | +| (예: Python) | (예: 3.12) | (가상환경 경로 등) | + +## 프레임워크 + +| 항목 | 버전 | 용도 | +|------|------|------| +| (예: Express) | (예: 4.18) | (서버) | +| (예: React) | (예: 18.x) | (프론트엔드) | + +## 패키지 관리 + +- 패키지 매니저: (npm / yarn / pnpm / pip 등) +- Lock 파일: (package-lock.json / yarn.lock 등) + +## 개발 도구 + +| 도구 | 명령어 | +|------|--------| +| 개발 서버 | (예: `cmd /c npm run dev`) | +| 빌드 | (예: `cmd /c npm run build`) | +| 테스트 | (예: `cmd /c npm test`) | +| 린트 | (예: `cmd /c npm run lint`) | + +## 환경 변수 + +| 변수명 | 용도 | 기본값 | +|--------|------|--------| +| (예: PORT) | (서버 포트) | (3000) | diff --git a/.agents/workflows/check-gitea.md b/.agents/workflows/check-gitea.md new file mode 100644 index 0000000..ad888d9 --- /dev/null +++ b/.agents/workflows/check-gitea.md @@ -0,0 +1,40 @@ +--- +description: Gitea API로 저장소 커밋/이슈/PR 현황을 조회하는 워크플로우 +--- + +# Gitea 저장소 현황 조회 + +서비스 정보는 `.agents/workflows/services.md` 참조. + +// turbo-all + +## 절차 + +1. 최근 커밋 조회 (최신 10개): +```powershell +$h = @{Authorization="token 3a01b4b15a39921572e64c413353e870d4d2161b"} +$commits = Invoke-RestMethod -Uri "https://git.variet.net/api/v1/repos/Variet/gravity_control/commits?limit=10&sha=main" -Headers $h +$commits | ForEach-Object { Write-Host "$($_.sha.Substring(0,7)) $($_.commit.message.Split("`n")[0])" } +``` + +2. 열린 이슈 조회: +```powershell +$h = @{Authorization="token 3a01b4b15a39921572e64c413353e870d4d2161b"} +$issues = Invoke-RestMethod -Uri "https://git.variet.net/api/v1/repos/Variet/gravity_control/issues?state=open&type=issues" -Headers $h +$issues | ForEach-Object { Write-Host "#$($_.number) $($_.title)" } +``` + +3. Wiki 페이지 목록: +```powershell +C:\ProgramData\miniforge3\envs\gravity_control\python.exe .agents\workflows\helpers\wiki_helper.py list +``` + +4. Wiki 페이지 읽기: +```powershell +C:\ProgramData\miniforge3\envs\gravity_control\python.exe .agents\workflows\helpers\wiki_helper.py read "Architecture" +``` + +5. Wiki 페이지 업데이트: +```powershell +C:\ProgramData\miniforge3\envs\gravity_control\python.exe .agents\workflows\helpers\wiki_helper.py update "페이지-제목" /tmp/wiki_content.md +``` diff --git a/.agents/workflows/check-vikunja.md b/.agents/workflows/check-vikunja.md new file mode 100644 index 0000000..5a5d688 --- /dev/null +++ b/.agents/workflows/check-vikunja.md @@ -0,0 +1,41 @@ +--- +description: Vikunja API로 프로젝트 태스크 현황을 조회하는 워크플로우 +--- + +# Vikunja 태스크 현황 조회 + +서비스 정보는 `.agents/workflows/services.md` 참조. + +// turbo-all + +## 절차 + +1. 전체 목록: +```powershell +C:\ProgramData\miniforge3\envs\gravity_control\python.exe .agents\workflows\helpers\vikunja_helper.py list +``` + +2. TODO만: +```powershell +C:\ProgramData\miniforge3\envs\gravity_control\python.exe .agents\workflows\helpers\vikunja_helper.py list todo +``` + +3. DONE만: +```powershell +C:\ProgramData\miniforge3\envs\gravity_control\python.exe .agents\workflows\helpers\vikunja_helper.py list done +``` + +4. 태스크 완료 처리 (**⚠️ 반드시 이 방법 사용 — 직접 API 호출 금지**): +```powershell +C:\ProgramData\miniforge3\envs\gravity_control\python.exe .agents\workflows\helpers\vikunja_helper.py done {TASK_ID} +``` + +5. 새 태스크 생성: +```powershell +C:\ProgramData\miniforge3\envs\gravity_control\python.exe .agents\workflows\helpers\vikunja_helper.py create "제목" "설명" --labels Backend,Priority:High +``` + +> [!CAUTION] +> **절대로** `Invoke-RestMethod -Method Post -Body '{"done": true}'` 같은 직접 API 호출을 사용하지 마세요. +> Vikunja API는 POST 시 body에 포함되지 않은 필드를 빈값으로 덮어씁니다. +> `vikunja_helper.py`는 항상 GET → 기존 필드 보존 → POST 패턴을 사용합니다. diff --git a/.agents/workflows/debug.md b/.agents/workflows/debug.md new file mode 100644 index 0000000..4d701d9 --- /dev/null +++ b/.agents/workflows/debug.md @@ -0,0 +1,52 @@ +--- +description: 에러/버그 발생 시 체계적 디버깅 워크플로우 (에러, 안돼요, 왜 안돼, 버그, 디버그, 수정) +--- + +# Debug Workflow + +> [!IMPORTANT] +> 추측으로 코드를 수정하지 마세요. 반드시 이 순서를 따릅니다. + +## 1단계: 정보 수집 (추측 금지) + +- [ ] 에러 메시지 **전문** 확인 (절대 잘라내지 않기) +- [ ] 관련 로그 파일 확인 +- [ ] 환경 정보 확인 (OS, Node/Python 버전, 의존성 버전 등) +- [ ] 에러가 발생하는 **정확한 입력/조건** 파악 + +## 2단계: Known Issues 확인 + +`.agents/references/known-issues.md`를 읽고 동일하거나 유사한 문제가 있는지 확인합니다. + +> [!CAUTION] +> **known-issues 확인 없이 해결 시도를 시작하지 마세요.** +> 이미 해결된 문제를 다시 삽질하는 것은 시간 낭비입니다. + +## 3단계: 근본 원인 분석 + +- [ ] 에러가 발생하는 **정확한 코드 위치** 확인 +- [ ] 가설을 세우고, 가설을 검증할 수 있는 **최소한의 테스트** 수행 +- [ ] 가설이 틀렸다면 **즉시 다른 가설로 전환** + +> [!WARNING] +> **동일한 접근을 2회 초과 시도하지 마세요.** +> 2회 실패 시 유저에게 보고하고 판단을 요청합니다. +> 보고 내용: 시도한 것 / 실패한 것 / 원인 가설 / 다음 제안 + +## 4단계: 수정 및 검증 + +- [ ] 수정 적용 +- [ ] 동일 에러가 재현되지 않는지 확인 +- [ ] 사이드 이펙트(다른 기능에 영향) 없는지 확인 + +## 5단계: 기록 + +- [ ] `known-issues.md`에 새 항목 추가 (아래 포맷 사용) + +```markdown +### [날짜] [키워드] — 한줄 요약 +- **증상**: 무엇이 잘못되었는가 +- **원인**: 근본 원인 +- **해결**: 올바른 해결 방법 +- **주의**: 재발 방지를 위한 교훈 +``` diff --git a/.agents/workflows/end.md b/.agents/workflows/end.md new file mode 100644 index 0000000..8bfc41d --- /dev/null +++ b/.agents/workflows/end.md @@ -0,0 +1,165 @@ +--- +description: 세션 종료 시 devlog 기록 + git commit + Vikunja 동기화 (끝, 마무리, 커밋해, 완료) +--- + +# 세션 종료 프로토콜 + +작업 완료, "끝", "마무리", "커밋해" 등 요청 시 이 워크플로우를 실행합니다. + +// turbo-all + +## 0. 학습 기록 (실패/시행착오 저장) + +이번 세션에서 발생한 실패, 시행착오, 새로 알게 된 사실을 정리합니다: + +- [ ] `.agents/references/known-issues.md`에 추가할 항목이 있는지 확인 +- [ ] 있다면 아래 포맷으로 추가: + +```markdown +### [날짜] [키워드] — 한줄 요약 +- **증상**: ... +- **원인**: ... +- **해결**: ... +- **주의**: ... +``` + +## 1. Devlog 기록 + +### Index 업데이트 (필수 — 매 작업) + +오늘 날짜의 index 파일에 완료된 작업 1줄을 추가합니다. + +- **파일**: `docs/devlog/YYYY-MM-DD.md` +- **형식**: +```markdown +| NNN | HH:MM | 작업 설명 | `커밋해시` | ✅ 또는 🔧 | +``` + +> [!TIP] +> - ✅ = 완료, 🔧 = 미완료 (다음 세션에서 이어받기) +> - 파일이 없으면 새로 생성 (테이블 헤더 포함) + +### Entry 작성 (선택적 — 필요할 때만) + +> [!IMPORTANT] +> Entry는 **git/Vikunja/wiki에 없는 정보**가 있을 때만 작성합니다. + +**Entry 작성 기준:** +- ✅ 설계 결정이 있었을 때 (왜 A가 아닌 B를 선택했는지) +- ✅ 미완료 사항이 있을 때 (다음 세션이 이어받아야 할 맥락) +- ✅ 삽질/트러블슈팅이 있었을 때 (같은 실수 방지) + +**Entry 불필요:** +- ❌ 단순 버그 픽스 (커밋 메시지로 충분) +- ❌ 문서 업데이트 (git diff로 충분) +- ❌ 이미 Vikunja 태스크에 상세 설명이 있는 경우 + +**Entry 파일**: `docs/devlog/entries/YYYYMMDD-NNN.md` +```markdown +# 작업 제목 + +- **시간**: YYYY-MM-DD HH:MM~HH:MM +- **Commit**: `해시` +- **Vikunja**: #태스크번호 → done/진행중 + +## 결정 사항 +- 왜 이 방식을 선택했는지 + +## 미완료 +- 남은 작업 (있을 경우) +``` + +--- + +## 2. Vikunja 동기화 + +> [!CAUTION] +> **반드시 `vikunja_helper.py` 사용.** 직접 API 호출 금지. +> Vikunja API는 POST 시 body에 없는 필드를 빈값으로 덮어씁니다. + +### 2-1. 커밋 전수 검사 + +이번 세션의 **모든 커밋을 하나씩 검사**하고 Vikunja에 매핑합니다. + +```powershell +git log --oneline -20 +``` + +| 커밋 유형 | Vikunja 액션 | +|-----------|-------------| +| 기존 태스크 해당 작업 **완료** | `C:\ProgramData\miniforge3\envs\gravity_control\python.exe .agents\workflows\helpers\vikunja_helper.py done {ID}` | +| 신규 작업 완료 (기존 태스크 없음) | `C:\ProgramData\miniforge3\envs\gravity_control\python.exe .agents\workflows\helpers\vikunja_helper.py create "제목" "설명" --done --labels Backend,Priority:High` | +| 작업 중 발견된 **미완료 TODO** | `C:\ProgramData\miniforge3\envs\gravity_control\python.exe .agents\workflows\helpers\vikunja_helper.py create "제목" "설명" --labels Backend,Priority:Mid` | + +> [!IMPORTANT] +> 모든 커밋이 기존 또는 신규 태스크에 매핑되었는지 확인. + +### 2-2. 완료 처리 + +```powershell +C:\ProgramData\miniforge3\envs\gravity_control\python.exe .agents\workflows\helpers\vikunja_helper.py done {TASK_ID} +``` + +### 2-3. 신규 태스크 생성 + +```powershell +C:\ProgramData\miniforge3\envs\gravity_control\python.exe .agents\workflows\helpers\vikunja_helper.py create "제목" "설명" --labels Backend,Priority:High +``` + +### 라벨 규칙 + +**영역 (필수 1개 이상):** `Backend` / `Frontend` / `Engine` / `Infra` / `Test` +**우선순위 (필수 1개):** `Priority:High` / `Priority:Mid` / `Priority:Low` + +--- + +## 3. Wiki 동기화 (해당 시에만) + +| 코드 변경 | 대상 Wiki | +|-----------|----------| +| 서버 변경 | Architecture | +| 프론트엔드 변경 | Architecture | +| 인프라 변경 | Architecture | +| 새 모듈/패키지 추가 | Architecture | + +```powershell +C:\ProgramData\miniforge3\envs\gravity_control\python.exe .agents\workflows\helpers\wiki_helper.py update "Architecture" /tmp/wiki_content.md +``` + +--- + +## 4. Git Commit & Push + +```powershell +git add -A +git status --short +``` +```powershell +git commit -m "커밋 메시지" +``` +```powershell +git push origin main +``` + +**커밋 메시지 컨벤션:** +``` +(): + +type: feat|fix|refactor|test|docs|chore|ci|infra +scope: (선택) +``` + +--- + +## 5. 최종 체크리스트 + +> [!WARNING] +> 아래 항목 중 하나라도 누락되면 세션 종료를 완료할 수 없습니다. + +- [ ] known-issues 업데이트됨 (새 이슈가 있었다면) +- [ ] devlog index 업데이트됨 +- [ ] devlog entry 작성됨 (필요한 경우만) +- [ ] Vikunja 태스크 생성/완료 처리됨 (커밋 전수 검사 기반) +- [ ] Wiki 동기화됨 (아키텍처 변경이 있었다면) +- [ ] git push 완료 +- [ ] 사용자에게 완료 보고 diff --git a/.agents/workflows/helpers/vikunja_helper.py b/.agents/workflows/helpers/vikunja_helper.py new file mode 100644 index 0000000..3717ef7 --- /dev/null +++ b/.agents/workflows/helpers/vikunja_helper.py @@ -0,0 +1,217 @@ +"""Vikunja safe task updater — preserves existing fields when updating tasks. + +Usage: + python vikunja_helper.py done 75 # Mark task #75 as done + python vikunja_helper.py done 71 77 78 # Mark multiple tasks done + python vikunja_helper.py undone 75 # Mark task #75 as not done + python vikunja_helper.py comment 75 "text" # Add comment to task #75 + python vikunja_helper.py desc 75 "text" # Set description (appends if exists) + python vikunja_helper.py create "title" "desc" --labels Backend,Priority:High + python vikunja_helper.py create "title" "desc" --done --labels Frontend,Priority:Mid + python vikunja_helper.py label 75 Backend Priority:High # Add labels to task + python vikunja_helper.py list # List all tasks + python vikunja_helper.py list todo # List TODO only + python vikunja_helper.py list done # List DONE only +""" + +import sys +import json +import urllib.request +import urllib.error +import io + +# Fix Windows console encoding (cp949 → utf-8) +if sys.stdout.encoding != "utf-8": + sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding="utf-8", errors="replace") + +# ============================================================ +# ⚙️ CONFIGURATION — PROJECT_ID만 프로젝트별로 변경하세요 +# ============================================================ +API_BASE = "https://plan.variet.net/api/v1" +TOKEN = "tk_070f8e0b715e818bb7178c3815ed5389040eddca" +PROJECT_ID = 8 # gravity_control project +# ============================================================ + +HEADERS = { + "Authorization": f"Bearer {TOKEN}", + "Content-Type": "application/json", +} + +# Label name → Vikunja label ID mapping +# Customize for your project's labels +LABEL_MAP = { + "Backend": 1, "Frontend": 2, "Engine": 3, "Infra": 4, "Test": 5, + "Priority:High": 6, "Priority:Mid": 7, "Priority:Low": 8, + "Agent": 17, "Tool": 18, "AI/LLM": 19, +} + + +def api_get(path: str): + req = urllib.request.Request(f"{API_BASE}{path}", headers=HEADERS) + with urllib.request.urlopen(req) as resp: + return json.loads(resp.read().decode("utf-8")) + + +def api_post(path: str, data: dict): + body = json.dumps(data).encode("utf-8") + req = urllib.request.Request(f"{API_BASE}{path}", data=body, headers=HEADERS, method="POST") + with urllib.request.urlopen(req) as resp: + return json.loads(resp.read().decode("utf-8")) + + +def api_put(path: str, data: dict): + body = json.dumps(data).encode("utf-8") + req = urllib.request.Request(f"{API_BASE}{path}", data=body, headers=HEADERS, method="PUT") + with urllib.request.urlopen(req) as resp: + return json.loads(resp.read().decode("utf-8")) + + +def get_task(task_id: int) -> dict: + return api_get(f"/tasks/{task_id}") + + +def safe_update_task(task_id: int, updates: dict) -> dict: + task = get_task(task_id) + safe_body = { + "title": task.get("title", ""), + "description": task.get("description", ""), + "priority": task.get("priority", 0), + "done": task.get("done", False), + } + safe_body.update(updates) + return api_post(f"/tasks/{task_id}", safe_body) + + +def mark_done(task_ids: list): + for tid in task_ids: + result = safe_update_task(tid, {"done": True}) + title = result.get("title", "?") + print(f" ✅ #{tid} → done=True [{title}]") + + +def mark_undone(task_ids: list): + for tid in task_ids: + result = safe_update_task(tid, {"done": False}) + title = result.get("title", "?") + print(f" ⬜ #{tid} → done=False [{title}]") + + +def add_comment(task_id: int, comment: str): + result = api_put(f"/tasks/{task_id}/comments", {"comment": comment}) + print(f" 💬 #{task_id} comment added (id={result.get('id', '?')})") + + +def set_description(task_id: int, desc: str, append: bool = True): + task = get_task(task_id) + existing = task.get("description", "") or "" + if append and existing: + new_desc = existing.rstrip() + "\n\n" + desc + else: + new_desc = desc + result = safe_update_task(task_id, {"description": new_desc}) + print(f" 📝 #{task_id} description updated [{result.get('title', '?')}]") + + +def list_tasks(filter_: str = "all"): + all_tasks = [] + page = 1 + while True: + batch = api_get(f"/projects/{PROJECT_ID}/tasks?per_page=50&page={page}") + if not batch: + break + all_tasks.extend(batch) + if len(batch) < 50: + break + page += 1 + + if filter_ == "todo": + all_tasks = [t for t in all_tasks if not t["done"]] + elif filter_ == "done": + all_tasks = [t for t in all_tasks if t["done"]] + + all_tasks.sort(key=lambda t: t["id"]) + for t in all_tasks: + status = "✅" if t["done"] else "⬜" + desc = (t.get("description") or "")[:50].replace("\n", " ") + labels = ", ".join(l["title"] for l in (t.get("labels") or [])) + print(f" {status} #{t['id']:3d} {t['title'][:40]:<40} [{labels}] {desc}") + print(f"\n Total: {len(all_tasks)} tasks") + + +def add_labels(task_id: int, label_names: list): + for name in label_names: + label_id = LABEL_MAP.get(name) + if not label_id: + print(f" ⚠️ Unknown label '{name}'. Valid: {', '.join(LABEL_MAP.keys())}") + continue + try: + api_put(f"/tasks/{task_id}/labels", {"label_id": label_id}) + print(f" 🏷️ #{task_id} + {name} (id={label_id})") + except Exception as e: + if "already" in str(e).lower() or "409" in str(e): + print(f" 🏷️ #{task_id} already has {name}") + else: + print(f" ⚠️ #{task_id} label {name} failed: {e}") + + +def create_task(title: str, description: str = "", done: bool = False, labels: list = None): + payload = {"title": title, "description": description} + result = api_put(f"/projects/{PROJECT_ID}/tasks", payload) + task_id = result["id"] + print(f" ✨ #{task_id} created: {result.get('title', '?')}") + + if labels: + add_labels(task_id, labels) + + if done: + result = safe_update_task(task_id, {"done": True}) + print(f" ✅ #{task_id} → done=True") + + return result + + +def main(): + if len(sys.argv) < 2: + print(__doc__) + return + + cmd = sys.argv[1].lower() + + if cmd == "done": + ids = [int(x) for x in sys.argv[2:]] + mark_done(ids) + elif cmd == "undone": + ids = [int(x) for x in sys.argv[2:]] + mark_undone(ids) + elif cmd == "comment": + add_comment(int(sys.argv[2]), sys.argv[3]) + elif cmd == "desc": + set_description(int(sys.argv[2]), sys.argv[3]) + elif cmd == "list": + f = sys.argv[2] if len(sys.argv) > 2 else "all" + list_tasks(f) + elif cmd == "label": + if len(sys.argv) < 4: + print("Usage: vikunja_helper.py label TASK_ID Label1 Label2 ...") + return + add_labels(int(sys.argv[2]), sys.argv[3:]) + elif cmd == "create": + title = sys.argv[2] if len(sys.argv) > 2 else "" + desc = sys.argv[3] if len(sys.argv) > 3 and not sys.argv[3].startswith("--") else "" + is_done = "--done" in sys.argv + labels = None + for i, arg in enumerate(sys.argv): + if arg == "--labels" and i + 1 < len(sys.argv): + labels = sys.argv[i + 1].split(",") + break + if not title: + print("Error: title is required") + return + create_task(title, desc, done=is_done, labels=labels) + else: + print(f"Unknown command: {cmd}") + print(__doc__) + + +if __name__ == "__main__": + main() diff --git a/.agents/workflows/helpers/wiki_helper.py b/.agents/workflows/helpers/wiki_helper.py new file mode 100644 index 0000000..9d6c692 --- /dev/null +++ b/.agents/workflows/helpers/wiki_helper.py @@ -0,0 +1,100 @@ +"""Gitea Wiki helper: list, read, create, update wiki pages. + +Usage: + wiki_helper.py list — list all pages + wiki_helper.py read — read a page + wiki_helper.py create <title> <file> — create a page from file + wiki_helper.py update <title> <file> — update a page from file +""" +import sys, io, json, base64, urllib.request, urllib.error + +sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8') + +# ============================================================ +# ⚙️ CONFIGURATION — GITEA_REPO만 프로젝트별로 변경하세요 +# ============================================================ +GITEA_BASE_URL = "https://git.variet.net" +GITEA_OWNER = "Variet" +GITEA_REPO = "gravity_control" # ← 프로젝트별 변경 필요 +GITEA_TOKEN = "3a01b4b15a39921572e64c413353e870d4d2161b" +# ============================================================ + +BASE = f"{GITEA_BASE_URL}/api/v1/repos/{GITEA_OWNER}/{GITEA_REPO}/wiki" +HEADERS = {"Authorization": f"token {GITEA_TOKEN}", "Content-Type": "application/json"} + +def _req(method, path, data=None): + url = f"{BASE}{path}" + body = json.dumps(data).encode() if data else None + req = urllib.request.Request(url, data=body, headers=HEADERS, method=method) + try: + with urllib.request.urlopen(req) as resp: + return json.loads(resp.read().decode()) + except urllib.error.HTTPError as e: + err = e.read().decode() + print(f" ⚠️ HTTP {e.code}: {err}") + return None + +def _find_sub_url(title): + pages = _req("GET", "/pages") + if pages: + for p in pages: + if p.get("title", "").lower() == title.lower(): + return p.get("sub_url", title) + return title + +def list_pages(): + pages = _req("GET", "/pages") + if pages: + print(f"=== {len(pages)} Wiki Pages ===") + for p in pages: + print(f" {p.get('title', '?')}") + return pages + +def read_page(title): + sub = _find_sub_url(title) + page = _req("GET", f"/page/{sub}") + if page and page.get("content_base64"): + content = base64.b64decode(page["content_base64"]).decode("utf-8") + return content + return None + +def create_page(title, content): + data = { + "title": title, + "content_base64": base64.b64encode(content.encode()).decode(), + } + result = _req("POST", "/new", data) + if result: + print(f" ✅ Created wiki page: {title}") + return result + +def update_page(title, content): + sub = _find_sub_url(title) + data = { + "title": title, + "content_base64": base64.b64encode(content.encode()).decode(), + } + result = _req("PATCH", f"/page/{sub}", data) + if result: + print(f" ✅ Updated wiki page: {title}") + return result + +if __name__ == "__main__": + cmd = sys.argv[1] if len(sys.argv) > 1 else "list" + + if cmd == "list": + list_pages() + elif cmd == "read" and len(sys.argv) > 2: + content = read_page(sys.argv[2]) + if content: + print(content[:5000]) + else: + print(f" Page '{sys.argv[2]}' not found") + elif cmd == "create" and len(sys.argv) > 3: + with open(sys.argv[3], "r", encoding="utf-8") as f: + create_page(sys.argv[2], f.read()) + elif cmd == "update" and len(sys.argv) > 3: + with open(sys.argv[3], "r", encoding="utf-8") as f: + update_page(sys.argv[2], f.read()) + else: + print("Usage: wiki_helper.py list|read <title>|create <title> <file>|update <title> <file>") diff --git a/.agents/workflows/pre-task.md b/.agents/workflows/pre-task.md new file mode 100644 index 0000000..70c4570 --- /dev/null +++ b/.agents/workflows/pre-task.md @@ -0,0 +1,39 @@ +--- +description: 모든 구현 작업 전 실행하는 사전 점검 체크리스트 (pre-task, 준비, 시작 전, 계획, 구현) +--- + +# Pre-Task Checklist + +> [!IMPORTANT] +> 코딩을 시작하기 전에 반드시 이 체크리스트를 순서대로 완료하세요. +> 체크리스트를 건너뛸 경우 불필요한 시행착오가 발생합니다. + +## 1단계: 요구사항 정리 + +- [ ] 유저 요청을 구체적 작업 항목으로 분해 +- [ ] 변경 범위(scope)를 명확히 정의 (영향받는 파일/모듈) +- [ ] 성공 기준(acceptance criteria) 확인 + +## 2단계: 레퍼런스 확인 (추측 금지) + +- [ ] `.agents/references/architecture.md` — 현재 아키텍처 확인 +- [ ] `.agents/references/tech-stack.md` — 기술 스택 및 버전 확인 +- [ ] `.agents/references/conventions.md` — 코딩 컨벤션 확인 +- [ ] `.agents/references/known-issues.md` — 과거 실패 패턴 확인 +- [ ] 관련 기존 코드 최소 3개 파일 읽기 + +> [!CAUTION] +> 레퍼런스 문서가 존재하는 주제에 대해 추측하지 마세요. +> 문서가 없으면 유저에게 확인을 요청하세요. + +## 3단계: 계획 수립 + +- [ ] 변경할 파일 목록 작성 +- [ ] 의존성 순서 파악 (어떤 파일부터 수정해야 하는가?) +- [ ] 리스크 식별 (어디서 실패할 가능성이 높은가?) +- [ ] 테스트 방법 결정 (어떻게 검증할 것인가?) + +## 4단계: 유저 확인 + +- [ ] 계획을 유저에게 보고하고 승인받기 (변경 파일 3개 이상인 경우) +- [ ] 작은 변경은 바로 실행하되, 변경 내용을 명확히 설명 diff --git a/.agents/workflows/services.md b/.agents/workflows/services.md new file mode 100644 index 0000000..d9b7152 --- /dev/null +++ b/.agents/workflows/services.md @@ -0,0 +1,128 @@ +--- +description: 프로젝트 연동 서비스 URL, API 키, 프로젝트 정보 참조 +--- + +# 서비스 연동 정보 + +> [!CAUTION] +> 이 파일에는 API 토큰이 포함되어 있습니다. 프라이빗 레포에서만 사용하세요. + +## 로컬 환경 + +| 항목 | 값 | +|------|-----| +| **Node.js** | 시스템 설치 (`node`, `npm`) | +| **Python** | `C:\ProgramData\miniforge3\envs\gravity_control\python.exe` (**항상 이 경로 사용**) | +| **Shell** | PowerShell (`curl` = `Invoke-WebRequest` 별칭이므로 반드시 **`curl.exe`** 사용) | + +## Gitea (Git Repository) + +| 항목 | 값 | +|------|-----| +| **Base URL** | `https://git.variet.net` | +| **API Base** | `https://git.variet.net/api/v1` | +| **Repo** | `Variet/gravity_control` | +| **Token** | `3a01b4b15a39921572e64c413353e870d4d2161b` | +| **Auth Header** | `-H "Authorization: token 3a01b4b15a39921572e64c413353e870d4d2161b"` | + +## Vikunja (Task Management) + +| 항목 | 값 | +|------|-----| +| **Base URL** | `https://plan.variet.net` | +| **API Base** | `https://plan.variet.net/api/v1` | +| **Project ID** | `8` | +| **Token** | `tk_070f8e0b715e818bb7178c3815ed5389040eddca` | +| **Auth Header** | `-H "Authorization: Bearer tk_070f8e0b715e818bb7178c3815ed5389040eddca"` | + +## Vikunja 태스크 조회 + +> [!TIP] +> 태스크 목록은 항상 라이브 조회를 사용합니다. 하드코딩된 매핑은 유지하지 않습니다. + +```powershell +C:\ProgramData\miniforge3\envs\gravity_control\python.exe .agents\workflows\helpers\vikunja_helper.py list todo +``` + +## 기타 서비스 + +| 서비스 | URL | 용도 | +|--------|-----|------| +| Uptime Kuma | `https://status.variet.net` | 서비스 모니터링 | +| Authentik | `https://auth.variet.net` | SSO 인증 | + +## AI 작업 프로토콜 + +> [!IMPORTANT] +> 아래 규칙은 모든 작업에 자동 적용됩니다. 유저가 별도 지시하지 않아도 따릅니다. + +### Vikunja = Single Source of Truth (SSOT) + +- **Vikunja가 유일한 작업 현황 관리 도구**입니다. +- 로컬 `task.md`는 현재 대화 내 세부 체크리스트용으로만 사용합니다. +- 새 TODO 발견 시 → Vikunja에 태스크 생성 (로컬 파일에만 적는 것은 금지) +- 작업 완료 시 → Vikunja 태스크 완료 처리 (로컬 체크만 하는 것은 금지) + +### Vikunja 태깅 규칙 + +태스크 생성 시 반드시 아래 라벨을 적절히 부여합니다: + +**영역 라벨 (필수, 1개 이상):** + +| ID | 라벨 | 적용 대상 | +|:--:|-------|-----------:| +| 1 | `Backend` | 서버, DB, API | +| 2 | `Frontend` | UI, 웹 프론트엔드 | +| 3 | `Engine` | 핵심 엔진/로직 | +| 4 | `Infra` | Docker, CI/CD, 모니터링 | +| 5 | `Test` | 테스트, E2E | + +**우선순위 라벨 (필수, 1개):** + +| ID | 라벨 | 기준 | +|:--:|-------|------:| +| 6 | `Priority:High` | 핵심 기능 미완성, 블로커 | +| 7 | `Priority:Mid` | 기능 개선, UX 향상, 리팩터링 | +| 8 | `Priority:Low` | nice-to-have, 문서, 코드 정리 | + +**태스크 제목 규칙:** +- 한글 + 핵심 키워드 (예: `WebSocket 재연결 로직 구현`) +- 50자 이내 + +### 작업 시작 시 +1. `git pull` 으로 최신 코드 동기화 +2. Vikunja 태스크 조회 (`/check-vikunja`) → 관련 태스크 ID 확인 +3. 관련 태스크가 있으면 Vikunja에서 진행중 표시 +4. 관련 태스크가 없으면 Vikunja에 새 태스크 생성 (태깅 규칙 준수) + +### 작업 중 +5. 의미 있는 단위마다 자주 커밋 (대규모 변경을 한번에 커밋하지 않음) +6. 커밋 메시지 규칙: + - `feat:`, `fix:`, `refactor:`, `test:`, `docs:`, `chore:`, `ci:` 접두사 사용 + - 관련 Vikunja 태스크가 있으면 `#task-{ID}` 참조 포함 + - 예: `feat(server): WebSocket 재연결 로직 #task-21` + +### 작업 완료 시 +7. 모든 변경사항 커밋 + `git push` +8. Vikunja 태스크 완료 처리 (**반드시 `vikunja_helper.py` 사용**): + ```powershell + C:\ProgramData\miniforge3\envs\gravity_control\python.exe .agents\workflows\helpers\vikunja_helper.py done {TASK_ID} + ``` + +> [!CAUTION] +> **직접 `Invoke-RestMethod -Body '{"done": true}'` 사용 금지!** +> Vikunja API는 POST 시 body에 없는 필드를 빈값으로 덮어씁니다. + +9. 작업 중 발견된 새 TODO → Vikunja에 태스크 생성 + +### 멀티 AI 협업 시 추가 규칙 +- 작업 전 `git pull` 필수 (다른 AI가 push한 변경 반영) +- 같은 파일을 동시에 수정하지 않음 +- 공유 인터페이스 수정 시 즉시 commit + push +- 충돌 발생 시 유저에게 확인 요청 + +## PowerShell 주의사항 + +- `curl` → PowerShell에서 `Invoke-WebRequest`의 별칭. **반드시 `curl.exe`** 사용 +- `npm` → PowerShell에서 실행 정책 문제 시 `cmd /c npm` 사용 +- JSON 파이프 파싱 시 PowerShell 이스케이핑 문제 → `.py` 스크립트 파일로 만들어 실행 권장 diff --git a/.agents/workflows/start.md b/.agents/workflows/start.md new file mode 100644 index 0000000..ed33325 --- /dev/null +++ b/.agents/workflows/start.md @@ -0,0 +1,66 @@ +--- +description: 세션 시작 시 프로젝트 맥락을 빠르게 복구하는 워크플로우 (시작, continue, 이어서, 작업 시작) +--- + +# 세션 시작 프로토콜 + +새 대화 시작, "continue", "이어서", "작업 시작" 등 요청 시 이 워크플로우를 실행합니다. + +// turbo-all + +## 절차 + +### 0. 에이전트 룰 & 맥락 로딩 (자동) + +`.agents/AGENT.md`를 읽고 에이전트 행동 규칙을 로딩합니다. +`.agents/references/known-issues.md`를 읽어 최근 이슈를 파악합니다. +`.agents/workflows/services.md`의 **로컬 환경** 섹션을 읽고 Python 경로 등 환경 설정을 확인합니다. + +### 1. Devlog 맥락 복구 + +오늘 + 어제 devlog index를 읽고 최근 작업 흐름을 파악합니다. + +```powershell +$today = Get-Date -Format "yyyy-MM-dd" +$yesterday = (Get-Date).AddDays(-1).ToString("yyyy-MM-dd") +if (Test-Path "docs\devlog\$today.md") { + Write-Host "=== Devlog: $today ===" + Get-Content "docs\devlog\$today.md" +} elseif (Test-Path "docs\devlog\$yesterday.md") { + Write-Host "=== Devlog: $yesterday (no entry for today yet) ===" + Get-Content "docs\devlog\$yesterday.md" +} else { + Write-Host "=== No recent devlog found ===" +} +``` + +미완료(🔧) 항목이 있으면 해당 entry 파일을 읽어 이어받기 맥락을 확보합니다: +- Entry 경로: `docs/devlog/entries/YYYYMMDD-NNN.md` + +### 2. Git 상태 확인 + +```powershell +git status --short +``` +```powershell +git log --oneline -5 +``` + +### 3. Vikunja TODO 태스크 + +```powershell +C:\ProgramData\miniforge3\envs\gravity_control\python.exe .agents\workflows\helpers\vikunja_helper.py list todo +``` + +### 4. 종합 보고 + +결과를 종합하여 사용자에게 보고: +- 마지막 작업 맥락 + 미완료 항목 (devlog 🔧 기반) +- TODO 태스크 목록 (라벨 + 우선순위) +- 다음 작업 제안 + +**우선순위 판단 기준** (라벨만으로 판단 금지): +- P0: 최근 커밋에서 스키마/모델/인터페이스 변경 → 연쇄 영향 점검 +- P1: 서버 기동/API 응답 장애 +- P2: 기능 미완성/UX 개선 +- P3: 정확도 향상, 신규 기능, CI/CD, 문서 정리 diff --git a/.gitignore b/.gitignore index 1209793..aac3214 100644 --- a/.gitignore +++ b/.gitignore @@ -11,8 +11,6 @@ build/ .venv/ venv/ -# Agents (contains tokens) -.agents/ # IDE .vscode/