Files
guitar_score/.agent/workflows/pre-task.md
CD 3d3f74b082 feat(pipeline): YouTube Tab → PDF 자동 추출 파이프라인 초기 구현
- 5단계 파이프라인: 다운로드 → 프레임 추출 → 패턴 감지 → 중복 제거 → PDF 생성
- 3가지 패턴 지원: overlay, split, scroll
- MSE 기반 픽셀 비교 프레임 중복 제거
- split 모드: 42% 크롭 + 밝기 필터 + Tab 라인 검증
- overlay 모드: 320x120 정규화 + 슬라이딩 윈도우 비교
- 프로젝트 문서 초기 작성 (architecture, tech-stack, STATUS, known-issues)
2026-03-24 23:29:25 +09:00

1.6 KiB

description
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개 이상인 경우)
  • 작은 변경은 바로 실행하되, 변경 내용을 명확히 설명