openproject-conventions

OpenProject 사용 규칙

이 프로젝트는 OpenProject MCP 서버에 연결되어 있습니다.

유형/상태/우선순위 조회 규칙 (필수)

중요: 유형, 상태, 우선순위, 활동 ID는 인스턴스마다 다릅니다. 절대 ID를 추측하거나 임의로 사용하지 마세요. 반드시 아래 MCP 도구로 실제 값을 조회한 후 사용하세요.

필요한 정보	조회 도구	사용 시점
유형 (Task, Bug 등)	list_types	작업 패키지 생성/필터링 전
상태 (New, Closed 등)	list_statuses	상태 변경/필터링 전
우선순위 (Normal, High 등)	list_priorities	작업 패키지 생성 전
시간 기록 활동	list_time_entry_activities	시간 기록 전
프로젝트 목록	list_projects	프로젝트 지정 전
사용자 목록	list_users	담당자 지정 전
역할 목록	list_roles	멤버십 관리 전

• 세션 내 첫 호출 시 한 번 조회하면 이후 재조회 불필요
• 조회 결과에서 이름과 ID를 매핑하여 사용할 것

작업 패키지 규칙

생성 규칙

• 담당자(assignee_id)는 반드시 지정할 것 (미지정 금지)
• Bug 유형은 description에 재현 절차(재현 단계, 예상 결과, 실제 결과)를 포함할 것
• Feature 및 Task 유형은 description에 기능 명세(목적, 동작 설명)를 포함할 것
• 날짜 형식은 반드시 YYYY-MM-DD (예: 2026-04-15)

업데이트 규칙

• 상태 변경 시 comment에 변경 사유를 기록할 것
• 완료율(percentageDone) 변경은 10% 단위를 권장
• 삭제는 원칙적으로 금지 - 잘못 생성한 경우 상태를 Rejected로 변경

관계 규칙

• 작업 패키지 간 의존성이 있으면 relation을 반드시 설정
• 관계 유형: follows(선행), blocks(차단), relates(관련)
• follows 관계에는 lag(대기 근무일)를 설정할 수 있음

시간 기록 규칙

• 기본 활동 유형은 개발 관련 활동을 사용 (list_time_entry_activities로 조회)
• comment에는 수행한 작업 내용을 간략히 기술 (예: "ADC 드라이버 코드 리뷰 및 수정")
• hours는 0.5 단위로 기록 권장 (0.5, 1.0, 1.5, ...)
• spent_on 날짜 형식: YYYY-MM-DD

검색/필터 참고

• list_work_packages의 필터 파라미터로 status, assignee, type 등을 지정 가능
• search_work_packages로 제목/ID 기반 검색 가능
• 날짜 기반 필터 시 ISO 8601 형식(YYYY-MM-DD) 사용