| name | development-workflow |
| description | 이 저장소에서 신규 기능 개발, 기존 기능 리팩토링, 버그 수정, API 변경, 도메인 정책 변경을 수행할 때 설계 문서화, Red-Green-Refactor 테스트 작성, 구현, 관련 테스트와 전체 테스트 검증, 배포/PR 확인까지 자연스럽게 이어가도록 사용하는 워크플로우 스킬이다. |
Development Workflow
Overview
루트 AGENTS.md 규칙을 전제로 사용한다.
이 스킬은 기능 개발과 리팩토링 작업을 시작할 때 설계, 구현, 테스트, 검증 순서를 자동으로 끌고 오기 위한 오케스트레이터다. 필요한 세부 규칙은 기존 저장소 스킬을 함께 사용한다.
Workflow
-
작업 유형을 분류한다.
- 신규 기능, 버그 수정, API/DTO/정책 변경, 도메인 로직 변경: 설계와 TDD 흐름을 적용한다.
- 순수 리팩토링: 기존 동작 기준선을 먼저 테스트로 확인하고, red 테스트가 부자연스러운 이유를 명시한다.
- 단순 오타, 주석, 문서만 변경: 영향 없음과 검증 범위를 짧게 남긴다.
-
설계 필요 여부를 결정한다.
- API 계약, DB schema, Redis key, 외부 API, 결제/FCM/스케줄러, ErrorCode, 도메인 정책, SLO 영향이 있으면 to-prd를 사용해
docs/history/{0001}-{feature-slug}/PLAN.md를 생성하거나 갱신한다.
- 운영 의미가 큰 정책이나 기존 설계와 충돌 가능성이 있으면 grill-with-docs로 문서와 코드를 대조한다.
- PLAN.md가 필요 없으면 “설계 문서 생략 사유”를 작업 메모나 최종 응답에 남긴다.
-
테스트 계획을 먼저 세운다.
- write-test-code를 사용해 성공/실패 시나리오와 테스트 슬라이스를 정한다.
- controller, service, repository, Redis, integration 중 변경 책임에 맞는 테스트를 선택한다.
- SLO 영향이 있으면 slo-check로 latency, availability, error rate 관점의 검증 항목을 정리한다.
-
Red를 확인한다.
- 신규 기능, 버그 수정, 정책 변경은 구현 전에 핵심 계약을 검증하는 실패 테스트를 먼저 작성한다.
- 관련 테스트 명령으로 의도한 이유의 실패를 확인한다.
- 순수 리팩토링처럼 red가 부자연스러운 경우, 기존 관련 테스트를 먼저 실행해 기준선을 잡고 예외 사유를 남긴다.
-
구현한다.
- 레이어, 예외, 응답, mapper, entity/repository, DTO 규칙은 AGENTS.md를 따른다.
- 새 도메인이나 레이어 확장이 있으면 create-domain-layer를 사용한다.
- 새 ErrorCode, validation,
@CustomErrorCodes 변경이 있으면 handle-exception를 사용한다.
-
Green과 Refactor를 완료한다.
- 먼저 변경 범위의 관련 테스트를 통과시킨다.
- 중복, mapper 위치, 트랜잭션 경계, 레이어 의존을 정리한다.
- 테스트 자체의 구조와 네이밍은 review-test 기준으로 확인한다.
-
전체 검증을 실행한다.
- 작업 완료 전 기본 명령은
./gradlew test다.
- 전체 테스트를 실행할 수 없으면 미실행 사유, 대신 실행한 관련 테스트, 남은 리스크를 최종 응답과 PR 설명에 남긴다.
- CI/CD나 배포 영향이 있으면
.github/workflows, 운영 민감 파일, 환경 설정 변경 여부를 재확인한다.
-
마무리 산출물을 정리한다.
Completion Checklist
- PLAN.md 생성/갱신 필요 여부를 판단했는가?
- PLAN.md가 필요 없으면 생략 사유를 남겼는가?
- 신규 기능/버그 수정/정책 변경에서 red 테스트를 먼저 확인했는가?
- red 예외가 있다면 이유를 명시했는가?
- 관련 테스트를 먼저 통과시켰는가?
- 완료 전
./gradlew test를 실행했거나, 미실행 사유와 리스크를 남겼는가?
- 최종 응답에 문서, 구현, 테스트, 검증 결과가 함께 정리되었는가?
Related Skills
