django-tdd

django-tdd 개요

django-tdd는 어떤 용도인가

django-tdd skill은 Django 프로젝트에서 테스트 주도 개발(TDD)을 실무적으로 따라갈 수 있게 도와주는 가이드입니다. pytest, pytest-django, factory_boy, mocking, coverage 리포팅 같은 도구를 활용해, 먼저 테스트를 작성한 뒤 그 테스트를 통과시키기 위해 model, view, serializer, API를 구현하도록 안내합니다.

누가 사용하면 좋은가

기존 Django 앱에 기능을 추가하는 중이거나, 새 프로젝트를 처음 세팅하는 중이거나, 테스트 구조를 더 탄탄하게 다듬고 싶은 Django REST Framework 코드베이스를 다루고 있다면 django-tdd skill이 잘 맞습니다. 단발성 테스트 예시보다 반복해서 쓸 수 있는 테스트 습관이 필요할 때 특히 유용합니다.

무엇이 돋보이는가

일반적인 프롬프트와 비교하면 django-tdd는 TDD 루프에 대해 상당히 명확한 관점을 갖고 있습니다. 동작을 정의하고, 실패하는 테스트를 먼저 작성한 다음, 가장 작은 수정으로 구현하고, 마지막에 안전하게 리팩터링하는 흐름을 중시합니다. 그래서 회귀 방지, API 동작, 유지보수 가능한 fixture가 중요한 django-tdd for Test Automation 작업에 더 잘 맞습니다. 단순히 코드를 많이 만들어내는 것보다, 검증 가능하고 오래 유지할 수 있는 결과가 필요할 때 강점이 큽니다.

django-tdd skill 사용 방법

skill 설치 및 활성화하기

django-tdd install을 할 때는 repo의 skill 설치 흐름에 따라 Claude Code 환경에 skill을 추가한 뒤, skills/django-tdd 디렉터리에서 작업하세요. 핵심 진입점은 SKILL.md이며, 이 repo에는 이를 보완하는 scripts/, references/, resources/ 계층이 없습니다. 따라서 설치 여부는 보조 파일보다 skill 파일 자체를 기준으로 판단하는 것이 좋습니다.

skill에 맞는 시작 브리프를 주기

django-tdd usage를 가장 잘 활용하려면, 처음부터 세 가지를 알려주세요: Django 앱의 어느 부분인지, 어떤 동작을 테스트하고 싶은지, 그리고 구현에 영향을 주는 스택 정보가 무엇인지입니다. 예를 들어 “주문을 생성하는 DRF endpoint에 대한 테스트를 추가해 주세요. factory를 사용하고, 잘못된 입력이면 validation error와 함께 201을 반환해야 합니다”처럼 구체적으로 말하는 편이 좋습니다. 이렇게 하면 “API 테스트를 작성해 주세요”보다 훨씬 명확한 acceptance target이 생깁니다.

repo 파일을 올바른 순서로 읽기

먼저 SKILL.md를 보고, 그다음 프로젝트의 pytest.ini, test settings, 그리고 기존의 tests/ 또는 conftest.py 파일을 확인하세요. 이 skill의 가이드는 프로젝트의 현재 marker, database 전략, factory 패턴에 맞춰질 때 가장 강합니다. 별도의 병렬 설정을 새로 상상해 내기보다, 기존 구조에 맞춰 조율할수록 결과가 더 실용적입니다.

템플릿 덤프가 아니라 워크플로로 쓰기

django-tdd guide는 한 번에 하나의 동작 단위만 요청할 때 가장 잘 작동합니다. 예를 들어 model 규칙, serializer validation 경로, permission 검사, endpoint 응답처럼 범위를 좁게 잡으세요. 요청이 작을수록 skill이 실패 테스트, 최소 구현, 리팩터링 단계를 섞이지 않게 깔끔하게 제시할 수 있습니다.

django-tdd skill FAQ

django-tdd는 DRF 프로젝트에만 해당하나요?

아니요. 이 skill에는 Django REST Framework 예시가 포함되어 있지만, model, view, serializer, test setup도 함께 다룹니다. 프로젝트가 순수 Django라고 해도 TDD 우선 워크플로를 원한다면 충분히 도움이 됩니다.

pytest가 이미 설정되어 있어야 하나요?

가능하면 그렇습니다. django-tdd skill은 pytest 중심의 테스트 스택, 특히 pytest-django를 전제로 합니다. 아직 Django 기본 test runner만 쓰고 있다면, skill을 제대로 활용하기 전에 간단한 설정 정리가 먼저 필요할 수 있습니다.

언제 django-tdd를 쓰지 않는 게 좋나요?

빠르게 탐색하는 프로토타입, 일회성 스크립트, 또는 구체적인 test case 없이 넓은 범위의 product copy가 필요한 경우에는 건너뛰는 편이 낫습니다. django-tdd는 검증 가능하고, 반복 가능하며, 안전하게 진화해야 하는 코드에 초점을 맞춥니다.

초보자도 쓰기 쉬운가요?

예상되는 동작을 평이한 영어로 설명할 수 있다면 초보자에게도 도움이 됩니다. 반대로 무엇을 assert해야 하는지 아직 감이 없다면 덜 유용할 수 있습니다. 이 skill은 정확한 test intent에 의존하기 때문입니다.

django-tdd skill 개선 방법

기능 이름만 말하지 말고 동작을 제시하세요

입력이 구체적일수록 테스트도 좋아집니다. “인증 테스트 추가”라고만 하지 말고, “비인증 사용자는 POST /api/orders/에서 401을 받아야 하고, 인증된 사용자는 주문을 생성할 수 있어야 하며, 잘못된 payload는 field error를 반환해야 한다”처럼 말하세요. 이렇게 해야 django-tdd가 의미 있는 acceptance coverage를 작성할 수 있습니다.

프로젝트 제약을 초기에 공유하세요

factory_boy 사용 여부, custom user model, database dependency, 기존 fixture, DRF permission 또는 serializer 규칙을 먼저 알려주세요. 이런 제약은 test setup의 형태를 바꾸며, 보기에는 그럴듯하지만 실제 코드베이스에는 맞지 않는 출력을 줄이는 데 도움이 됩니다.

한 번에 하나의 red-green-refactor 조각만 요청하세요

가장 좋은 결과는 반복적인 django-tdd usage에서 나옵니다. 먼저 실패하는 테스트를 요청하고, 그다음 최소 구현을 받고, 마지막으로 정리 단계를 요청하세요. 첫 결과가 너무 넓다면, 아직 약하게 느껴지는 특정 assertion이나 edge case로 다음 프롬프트를 좁히세요.

자주 생기는 실패 패턴을 점검하세요

가장 흔한 실수는 행동이 아니라 구현을 설명하는 테스트입니다. 또 다른 문제는 더 단순한 assert로 충분한데 factories나 mocks를 과하게 쓰는 것입니다. 이런 징후가 보이면, 테스트를 더 단순하게 정리하고, 현재 앱 구조에 맞추고, TDD 순서를 유지한 채 최종 코드로 바로 건너뛰지 않도록 skill에 다시 요청하세요.