laravel-tdd

laravel-tdd 개요

laravel-tdd 스킬은 Laravel에서 테스트를 먼저 작성한 뒤, PHPUnit 또는 Pest로 코드를 구현하는 실용적인 테스트 주도 개발 가이드입니다. 새 기능, 버그 수정, 리팩터링, 테스트 자동화를 Laravel에서 반복 가능한 워크플로우로 가져가고 싶지만 매번 테스트 전략을 즉흥적으로 정하고 싶지는 않은 개발자에게 특히 잘 맞습니다.

laravel-tdd가 유용한 이유는 팀 작업을 자주 느리게 만드는 판단을 직접 다루기 때문입니다. 어떤 테스트 레이어를 쓸지, 언제 데이터베이스 리프레시를 적용할지, fakes를 어디까지 쓸지, 커버리지 목표를 얼마나 현실적으로 잡을지 같은 결정을 도와줍니다. 그래서 laravel-tdd skill은 단순히 “테스트를 작성하세요”라는 일반적인 프롬프트보다 훨씬 실행 가능성이 높습니다.

Laravel 테스트 자동화에 가장 잘 맞는 경우

Laravel 코드에서 HTTP, auth, validation, Eloquent, jobs, notifications, queues를 넘나드는 테스트 자동화가 필요하다면 laravel-tdd를 사용하세요. 프로젝트가 이미 빠른 피드백 루프를 중시하고 있고, red-green-refactor 원칙을 꾸준히 지키도록 스킬이 도와주길 바란다면 특히 잘 맞습니다.

더 빨리 판단할 수 있게 도와주는 것

laravel-tdd skill의 핵심 가치는 추상적인 TDD 이론이 아닙니다. 대신 다음을 더 빨리 결정하게 해줍니다:

• 변경 작업을 unit, feature, integration test 중 어디서 시작할지
• 저장소의 기본 테스트 도구로 Pest와 PHPUnit 중 무엇이 더 나은지
• 테스트에 실제로 어느 정도의 데이터베이스 준비가 필요한지
• fakes만으로 충분한지, 아니면 실제 경계를 통과하게 해야 하는지

이 선택이 맞지 않을 수 있는 경우

한 번 쓸 코드 샘플만 필요하다면, 더 넓은 범위의 Laravel 프롬프트가 오히려 단순할 수 있습니다. laravel-tdd skill은 결과가 실제로 동작하는 테스트 워크플로우와 맞아야 하고, 유지보수성·커버리지·일관된 구조까지 신경 써야 할 때 가장 가치가 큽니다.

laravel-tdd skill 사용법

Claude Code 설정에 스킬 설치하기

다음 명령으로 laravel-tdd를 설치하세요:
npx skills add affaan-m/everything-claude-code --skill laravel-tdd

이것이 대부분의 사용자가 필요한 laravel-tdd install 단계입니다. 설치 후에는 모델이 기존 테스트, 테스트 설정, 변경 대상 코드를 살펴볼 수 있는 Laravel 저장소에서 이 스킬을 호출하세요.

스킬에 맞는 작업 형태로 요청하기

가장 좋은 laravel-tdd usage는 막연한 구현 요청이 아니라, 구체적인 동작 요구사항에서 시작합니다. 좋은 입력에는 다음이 포함됩니다:

• 기능 또는 버그
• 사용자에게 보이는 예상 동작
• 관련된 기존 모델, routes, controllers, jobs, notifications
• 저장소에서 이미 사용 중인 테스트 프레임워크 선호도

더 강한 프롬프트 예시:
“laravel-tdd를 사용해 이메일 링크 기반 비밀번호 없는 로그인을 추가해 주세요. 기존 테스트 스타일을 우선 따르고, 실패하는 feature test를 먼저 작성한 뒤 최소한의 코드만 구현해 주세요. 필요한 곳에서는 fakes를 사용하고, 현재 Laravel 관례에 맞춰 테스트를 유지해 주세요.”

먼저 읽어야 할 가장 유용한 파일

이 laravel-tdd guide에서는 먼저 SKILL.md를 보고, 그다음 저장소에 보조 문서가 있으면 함께 살펴보세요. 이 저장소에서는 SKILL.md가 주된 기준 문서이며, 특히 중요한 섹션은 다음과 같습니다:

• When to Use
• How It Works
• Red-Green-Refactor Cycle
• Test Layers
• 데이터베이스 전략 안내

프로젝트에 자체 Laravel 관례가 있다면, 테스트를 작성하기 전에 그것과 스킬의 지침을 비교하세요. 그래야 로컬 테스트 스타일과 충돌하지 않습니다.

스킬의 의도에 맞는 워크플로우 사용하기

좋은 laravel-tdd 워크플로우는 다음 순서입니다:

1. 동작을 한 문장으로 정의한다
2. 그 동작을 증명할 테스트 레이어를 고른다
3. 실패하는 테스트를 먼저 작성한다
4. 통과할 최소한의 코드만 구현한다
5. 테스트가 초록색이 된 뒤에만 리팩터링한다

이 순서를 모델에게 명확히 요청하면, 과장된 구현 디테일이 줄어들고 실제 Laravel 코드베이스에 적용하기 쉬운 결과를 얻기 좋습니다.

laravel-tdd skill FAQ

laravel-tdd는 PHPUnit 사용자만 위한 건가요?

아닙니다. 이 스킬은 PHPUnit과 Pest를 모두 지원하며, 새 테스트는 프로젝트가 이미 PHPUnit을 표준으로 삼고 있지 않다면 Pest를 우선 권장합니다. 저장소가 혼합 상태라면, 어떤 스타일을 맞춰야 하는지 모델에 알려서 일관성이 깨지지 않게 하세요.

큰 테스트 스위트가 있어야 사용 가능한가요?

아닙니다. laravel-tdd skill은 작은 프로젝트에서도 유용합니다. 각 변경마다 적절한 테스트 수준을 고르는 데 도움을 주기 때문입니다. 특히 처음 몇 개의 테스트가 이후 팀 전체가 따를 패턴을 만드는 상황에서 효과가 큽니다.

일반적인 Laravel 프롬프트와 무엇이 다른가요?

일반적인 프롬프트는 한 번은 동작하는 코드를 만들 수 있지만, 테스트 구조는 놓칠 수 있습니다. laravel-tdd skill은 테스트 우선 워크플로우, 테스트 레이어 선택, 데이터베이스 전략을 중심에 두기 때문에 Test Automation에 더 적합하고, 실제 Laravel 프로젝트에 들어맞을 가능성도 높습니다.

언제 이 스킬을 건너뛰어야 하나요?

Laravel 동작을 테스트하는 상황이 아니거나, 테스트 규율이 전혀 없는 빠른 프로토타입이 필요하거나, 앱에 스킬의 PHPUnit/Pest 전제를 충돌시킬 정도로 엄격한 내부 테스트 프레임워크가 있다면 건너뛰세요.

laravel-tdd skill 개선하기

구현 목표만 말하지 말고 동작을 구체적으로 제시하기

가장 좋은 laravel-tdd 결과는 동작 명세에서 나옵니다. “알림 시스템을 만들어 주세요”보다 “청구서가 연체 상태가 되면 이메일 알림을 보내고, feature test로 검증해 주세요”라고 말하는 편이 좋습니다. 이렇게 하면 스킬이 테스트 가능한 목표를 잡기 쉬워지고, 불필요한 왕복 질문도 줄어듭니다.

경계와 테스트 스타일을 처음부터 밝히기

무엇을 어떻게 테스트할지 모델에 먼저 알려 주세요. 예를 들면:

• “HTTP 엔드포인트에는 feature test를, 가격 규칙에는 unit test를 사용해 주세요.”
• “이 테스트는 Eloquent와 policies를 건드리므로 RefreshDatabase를 사용해 주세요.”
• “기존 스위트가 PHPUnit이 아니라면 Pest를 사용해 주세요.”

이런 세부 정보가 laravel-tdd skill이 잘못된 기본값을 피하고, 저장소에 맞는 출력을 내는 데 도움이 됩니다.

자주 생기는 두 가지 실패 패턴을 주의하기

가장 흔한 문제는 구현 세부사항을 과도하게 테스트하는 것과, 잘못된 테스트 레이어를 고르는 것입니다. 첫 결과가 너무 낮은 수준에 치우쳐 있다면 동작 중심으로 다시 써 달라고 요청하세요. 테스트 설정이 지나치게 무겁게 느껴지면, fixtures를 줄이고 factories를 우선 사용하며 데이터베이스 설정을 가능한 한 단순화해 달라고 하세요.

실패하는 테스트를 리뷰하면서 반복 개선하기

첫 결과를 받은 뒤에는, 코드 변경 전에 해당 테스트가 정말 올바른 이유로 실패할지 확인하세요. 그렇지 않다면 더 엄격한 assertion, 더 깔끔한 fixture, 더 좁은 범위를 요청하세요. 실제 프로젝트에서 Test Automation용 laravel-tdd 출력을 개선하는 가장 빠른 방법입니다.