작업을 시작하기 전에 관련 개발 가이드라인을 읽으세요.
다음 단계를 실행하세요:
-
현재 작업 아티팩트 읽기:
prd.md: 요구사항 및 승인 기준design.md(있는 경우): 기술 설계implement.md(있는 경우): 실행 순서 및 검증 계획
-
패키지 및 해당 사양 레이어 탐색:
python3 ./.trellis/scripts/get_context.py --mode packages -
작업에 적용되는 사양 식별:
- 수정 중인 패키지 (예:
cli/,docs-site/) - 작업 유형 (백엔드, 프론트엔드, 유닛 테스트, 문서 등)
- 작업 아티팩트에서 참조하는 사양/연구 경로
- 수정 중인 패키지 (예:
-
관련 모듈의 사양 인덱스 읽기:
cat .trellis/spec/<package>/<layer>/index.md인덱스의 "개발 전 체크리스트" 섹션을 따르세요.
-
개발 전 체크리스트에 나열된 관련 특정 가이드라인 파일 읽기. 인덱스 자체가 목표가 아니라 실제 가이드라인 파일(예:
error-handling.md,conventions.md,mock-strategies.md)을 가리킵니다. 코딩 표준과 패턴을 이해하기 위해 해당 파일을 읽으세요. -
항상 공유 가이드 읽기:
cat .trellis/spec/guides/index.md -
비자명한 작업의 경우 코드를 작성하기 전에 변경 경계를 명시하세요. 비자명하다는 것은 둘 이상의 파일을 건드리거나, 레이어를 넘거나, 공개 인터페이스를 변경하거나, 방금 작성하지 않은 코드를 수정하는 것을 의미합니다. 다음을 기록하세요:
- 현재 동작과 예상 동작 사이의 가장 작은 동작 차이
- 해당 동작이 실제로 존재하는 위치 (가장 쉽게 가로챌 수 있는 위치가 아님)
- 변경할 것으로 예상되는 파일과 각 파일이 필요한 이유
- 이 작업에서 명시적으로 수행하지 않는 작업
- 로컬 리팩터링이 필요한 경우, 동작을 변경하지 않았음을 어떻게 입증할지
작고 범위가 명확한 변경은 이 단계가 필요하지 않습니다. 바로 수행하세요.
실제 범위가 명백히 이보다 더 크다면, 계속 진행하기 전에 그 이유와 함께 말씀해 주세요. 스스로 변경 범위를 넓히지 마세요.
-
따라야 할 코딩 표준과 패턴을 이해한 후 개발 계획을 진행하세요.
이 단계는 코드를 작성하기 전에 필수입니다.