variet-agent/.agent/workflows/pre-task.md

description

description
모든 구현 작업 전 실행하는 사전 점검 체크리스트 (pre-task, 준비, 시작 전, 계획, 구현)

Pre-Task Checklist

Important

코딩을 시작하기 전에 반드시 이 체크리스트를 순서대로 완료하세요. 체크리스트를 건너뛸 경우 불필요한 시행착오가 발생합니다.

Caution

Python 실행 시 반드시 절대경로 사용 (conda 환경이라 python이 PATH에 없음): C:\ProgramData\miniforge3\envs\agent_chat\python.exe 절대로 python, py, python.exe를 단독으로 쓰지 마세요.

1단계: 요구사항 정리

• 유저 요청을 구체적 작업 항목으로 분해
• 변경 범위(scope)를 명확히 정의 (영향받는 파일/모듈)
• 성공 기준(acceptance criteria) 확인

2단계: 레퍼런스 확인 (추측 금지)

• .agent/references/architecture.md — 현재 아키텍처 확인
• .agent/references/tech-stack.md — 기술 스택 및 버전 확인
• .agent/references/conventions.md — 코딩 컨벤션 확인
• .agent/references/known-issues.md — 과거 실패 패턴 확인
• 관련 기존 코드 최소 3개 파일 읽기

Caution

레퍼런스 문서가 존재하는 주제에 대해 추측하지 마세요. 문서가 없으면 유저에게 확인을 요청하세요.

3단계: 계획 수립

• 변경할 파일 목록 작성
• 의존성 순서 파악 (어떤 파일부터 수정해야 하는가?)
• 리스크 식별 (어디서 실패할 가능성이 높은가?)
• 테스트 방법 결정 (어떻게 검증할 것인가?)

4단계: 유저 확인

• 계획을 유저에게 보고하고 승인받기 (변경 파일 3개 이상인 경우)
• 작은 변경은 바로 실행하되, 변경 내용을 명확히 설명