edf/.agents/workflows/services.md

description

description
프로젝트 연동 서비스 URL, API 키, 프로젝트 정보 참조

서비스 연동 정보

Caution

이 파일에는 API 토큰이 포함되어 있습니다. 프라이빗 레포에서만 사용하세요.

로컬 환경

항목	값
Python	C:\ProgramData\miniforge3\envs\edf\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/edf
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	11
Token	tk_070f8e0b715e818bb7178c3815ed5389040eddca
Auth Header	-H "Authorization: Bearer tk_070f8e0b715e818bb7178c3815ed5389040eddca"

Vikunja 태스크 조회

Tip

태스크 목록은 항상 라이브 조회를 사용합니다. 하드코딩된 매핑은 유지하지 않습니다.

C:\ProgramData\miniforge3\envs\edf\python.exe .agents\workflows\helpers\vikunja_helper.py list todo

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, 문서, 코드 정리

작업 시작 시

1. git pull 으로 최신 코드 동기화
2. Vikunja 태스크 조회 (/check-vikunja) → 관련 태스크 ID 확인
3. 관련 태스크가 있으면 Vikunja에서 진행중 표시
4. 관련 태스크가 없으면 Vikunja에 새 태스크 생성 (태깅 규칙 준수)

작업 중

5. 의미 있는 단위마다 자주 커밋 (대규모 변경을 한번에 커밋하지 않음)
6. 커밋 메시지 규칙:
   • feat:, fix:, refactor:, test:, docs:, chore:, ci: 접두사 사용
   • 관련 Vikunja 태스크가 있으면 #task-{ID} 참조 포함

작업 완료 시

7. 모든 변경사항 커밋 + git push
8. Vikunja 태스크 완료 처리 (반드시 vikunja_helper.py 사용):

   C:\ProgramData\miniforge3\envs\edf\python.exe .agents\workflows\helpers\vikunja_helper.py done {TASK_ID}
   

Caution

직접 Invoke-RestMethod -Body '{"done": true}' 사용 금지! Vikunja API는 POST 시 body에 없는 필드를 빈값으로 덮어씁니다.

PowerShell 주의사항

• curl → PowerShell에서 Invoke-WebRequest의 별칭. 반드시 curl.exe 사용
• JSON 파이프 파싱 시 PowerShell 이스케이핑 문제 → .py 스크립트 파일로 만들어 실행 권장