AGENTS 기여 작업 흐름
이 저장소는 모든 기능 작업에 대해 구현 우선 작업 흐름을 사용합니다.
모든 기능에 필요한 순서
- 먼저 설계
- 문제, 목표, 비목표, API/CLI UX 및 엣지 케이스를 설명합니다.
docs/에 설계 문서를 추가하거나 업데이트합니다.
- 동작 문서화
- 명령어나 기능이 변경될 때 사용자 대상 문서(
README.md,docs/index.md)를 업데이트합니다.
- 명령어나 기능이 변경될 때 사용자 대상 문서(
- 테스트 작성
- 구현 전/함께 새 로직에 대한 대상 단위 테스트를 추가합니다.
- 코드 구현
- 변경 사항을 최소화하고 기존 프로젝트 스타일과 일관되게 유지합니다.
- 스킬 업데이트
- 명령어 세트나 작업 흐름이 변경될 때
skills/climate.md및skills/climate-generator/SKILL.md를 업데이트합니다.
- 명령어 세트나 작업 흐름이 변경될 때
- 로컬 검증
- 실행:
go build ./...go test ./...
- 개발 중 빠른 피드백을 위해 대상 테스트를 실행합니다.
- 실행:
- CI 상태 확인
- 병합 전 PR 검사가 모두 통과하는지 확인합니다.
- 커밋 규율
- 명확한 메시지와 함께 작고 의미 있는 커밋을 만듭니다.
- 푸시 및 PR 관리
- 브랜치 업데이트를 푸시하고, PR 설명/체크리스트를 최신 상태로 유지하며, 각 요청을 해결한 커밋 해시로 리뷰 코멘트에 응답합니다.
품질 규칙
- 관련 없는 테스트를 제거하거나 약화시키지 마십시오.
- 문서 및 마이그레이션 노트 없이 CLI 변경을 도입하지 마십시오.
- 결정론적 동작(정렬된 출력, 안정적인 반복)을 선호하십시오.
- 가능한 경우 생성/매니페스트 동작의 하위 호환성을 유지하십시오.
기능 체크리스트 템플릿
- 설계 문서 추가/업데이트
- README/문서 업데이트
- 스킬 업데이트
- 테스트 추가/업데이트
-
go build ./...통과 -
go test ./...통과 - CI 검사 모두 통과