Files
ai-code-app/docs/features/plan-usage.md
2026-04-21 03:33:23 +09:00

2.4 KiB
Executable File

Plan 활용 가이드

목적

운영자, 검수자, 개발자가 현재 Plan 기능을 어떤 순서로 써야 하는지 정리한 실무 가이드입니다.

빠른 진입

  • 전체 목록 확인: 자동화 / 자동화
  • 상세 처리 중심: 자동화 / plan
  • release 검수: 자동화 / release 검수
  • 추이 확인: 자동화 / 차트
  • 반복 등록: 자동화 / 스케줄

통합 검색에서도 plan, release 검수, 스케줄로 바로 이동할 수 있습니다.

운영자 기준 사용 순서

  1. 자동화 / 자동화에서 작업을 찾습니다.
  2. 필요하면 빠른 필터로 현재 작업중, 현재 release 상태, 현재 자동화 실패를 좁힙니다.
  3. 상세 오버레이에서 현재 상태, 이슈, 최근 소스 작업을 확인합니다.
  4. 상황에 맞는 액션을 실행합니다.
  5. 후속 설명은 조치 기록 또는 이슈 조치 기록으로 남깁니다.

검수자 기준 사용 순서

  1. release 검수에서 main 대기 필터를 우선 봅니다.
  2. 검수 메모와 변경 파일, 관련 컴포넌트/위젯 샘플을 확인합니다.
  3. 확인한 항목은 체크 상태로 반영합니다.
  4. 이상 없으면 검수완료, 수정이 필요하면 수정필요로 저장합니다.

개발자 기준 확인 포인트

  • 실패 상태면 workerStatuslastError를 먼저 확인
  • 브랜치 누락 계열 실패는 브랜치 재시도 또는 작업 재처리 판단
  • release/main 반영 관련 문제는 상세의 소스 작업 내역과 diff를 먼저 확인
  • 메모 원문이 잠겨 있으면 추가 조치 기록으로 정정 사유를 남김

권한 없는 사용자 동작

  • 목록과 검수 현황은 조회 가능
  • 민감 메모는 마스킹
  • 상세 수정/삭제/조치 실행은 제한
  • 소스 작업 상세와 증적 확인도 제한될 수 있음

문서와 화면을 함께 운영하는 방법

  • 기능 변경 시 docs/features를 먼저 갱신
  • 새 문서를 만들면 앱 Docs / 기능문서에 자동 노출되는지 함께 확인
  • 증적이 필요한 변경은 Plan 상세의 Preview, diff, 파일 목록으로 확인
  • 작업일지에는 어떤 기능 문서를 왜 수정했는지 함께 남김

추천 문서 읽기 순서

  1. docs/features/plan-board-review.md
  2. docs/features/plan-automation.md
  3. docs/features/plan-schedule.md
  4. docs/features/plan-usage.md