Communitygithub.com

Treatment 백엔드 플래너

Django 백엔드를 위한 설계 구현이 가능하고 안전한 변경 계획을 수립합니다. Django API, ORM, 마이그레이션, Celery, 통합, 보안 및 앱 간 리팩터링을 포함합니다. 실제 구현 전 또는 아키텍처나 변경 영향 평가가 필요할 때 사용하세요.

Treatment 백엔드 플래너란 무엇인가요?

이 스킬은 Codex, OpenCode, Claude Code에서 공유하는 **계획 수립 전용** 스킬로, Treatment Django 백엔드 프로젝트의 변경 사항을 안전하게 설계하는 데 중점을 둡니다. 실제 구현 코드나 마이그레이션은 실행하지 않으며, 검증된 저장소 증거를 바탕으로 실행 가능한 설계를 생성합니다. 주요 기능으로는 요청 컨텍스트 식별 및 검증, 관련 문서(비즈니스/기술) 확인, Graphify를 통한 선택적 그래프 탐색, 실제 소스 코드 기반 클래스/호출 지점/권한/데이터 흐름 검증, Python/Django 버전 확인 및 브랜치 비교 등이 포함됩니다. 또한 아키텍처 리뷰를 통해 ORM 쿼리 비용, 동시성, 데이터 일관성, 마이그레이션 순서, 비동기 효과(Celery, 캐시 무효화 등), 보안, 배포 전략 등을 종합적으로 분석합니다. 최종적으로 결정이 완료된 계획을 출력하며, 범위, 제약 조건, 증거, 변경 전후 아키텍처, 구현 단계, 마이그레이션 전략, 테스트 시나리오, 문서 업데이트 항목 등을 명확히 제시합니다. 이 스킬은 사소한 오타나 서식 변경에 자동으로 실행되지 않으며, 영향도에 따라 계획 수립 노력을 조정합니다. 'treatment-django-engineer' 스킬이 이 스킬을 호출하면 계획을 먼저 반환하고, 구현은 엔지니어가 담당합니다.

지원 대상✓Claude Code✓Codex CLI~Cursor✓OpenCode
npx skills add https://github.com/baratihd/skills/tree/HEAD/backend/treatment-backend-planner

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Treatment 백엔드 플래너은(는) 무엇을 하나요?

이것은 계획 수립 전용 스킬로, Codex, OpenCode, Claude Code에서 공유됩니다. 검증된 저장소 증거를 바탕으로 실행 가능한 설계를 생성하며, 계획 모드에서는 요청이 없는 한 애플리케이션 코드를 수정하거나 마이그레이션을 실행하지 마십시오.

컨텍스트 발견 및 검증

  1. 요청된 결과, 수락 기준, 작업 브랜치, 대상 브랜치(해당되는 경우), 의도된 배포 환경을 식별하십시오. production 또는 development 브랜치 이름을 가정하지 마십시오. 비교 전에 git status와 참조를 확인하십시오. 커밋되지 않은 작업을 덮어쓰지 마십시오.
  2. 관련된 기존 제품/비즈니스 문서(페르시아어)와 기술/품질 문서(영어)를 사용 가능한 경우 읽으십시오. 누락된 경우 어떤 문서가 누락되었는지 정확히 표시하십시오. 비즈니스 요구 사항을 임의로 만들지 마십시오.
  3. Graphify가 설치되어 있고 적용 가능한 최신 그래프를 사용할 수 있는 경우, 선택적으로 graphify query, path, 또는 explain을 사용하여 방향을 잡으십시오. Graphify를 필수로 요구하지 마십시오. 사용할 수 없거나 오래된 경우, 관련 소스, 마이그레이션, 설정 및 테스트를 직접 검색하십시오. 그래프는 힌트로 취급하고 증거로 간주하지 마십시오.
  4. 실제 소스 코드에서 클래스, 호출 지점, 권한, 데이터 흐름, 구성, 데이터베이스 제약 조건 및 외부 종속성을 검증하십시오.
  5. 활성 프로젝트 구성과 잠금 파일에서 Python/Django/런타임 버전을 확인하십시오. 불일치 사항을 보고하십시오. 역사적 프레임워크 버전을 하드코딩하지 마십시오.
  6. 브랜치 비교에는 실제 사용자가 지정한 소스 및 대상 참조를 사용하십시오. 커밋 기록과 작업 트리 변경 사항을 구분하십시오. 사용자 권한/네트워크 가용성을 고려하지 않고 원격 참조를 가져오지 마십시오.

아키텍처 및 변경 영향 검토

  • 소유 앱과 경계를 식별하고, 불필요한 추상화나 앱 간 결합을 피하십시오. SOLID와 깔끔한 계층화를 기계적으로 적용하지 말고 실용적으로 적용하십시오.
  • 공개 API 계약(라우트, 직렬화기, 필드 유형, 상태/오류 형식, 페이지 매김, 필터링), 프론트엔드/PWA와의 호환성, 인증/권한 부여/테넌트 격리를 검증하십시오.
  • ORM 쿼리 비용, N+1, 트랜잭션 및 잠금, 제약 조건, 동시성, 데이터 일관성, 마이그레이션 순서 및 되돌리기 가능 여부를 분석하십시오.
  • 비동기 및 외부 효과(Celery 재시도 및 멱등성, transaction.on_commit, 캐시 무효화, Elasticsearch/인덱스 동기화, HTTP 타임아웃 및 오류, SMS 게이트웨이)를 포함하십시오.
  • 관찰 가능성, 보안 및 비밀, 운영, 롤아웃, 롤백, 기능 플래그 및 배포 순서를 관련성에 따라 분석하십시오.
  • 검증된 현재 동작, 문서화된 의도된 동작, 제안된 변경 사항, 미해결 질문을 분리하십시오. 불일치 사항을 명확히 식별하십시오.
  • 테스트 가능성과 기존 테스트 인프라를 고려하십시오. 일상적인 자동화 테스트에서는 실제 타사/SMS/Celery 디스패치를 사용하지 마십시오.

필수 출력

다음이 포함된 결정 완료된 계획을 생성하십시오:

  1. 범위, 목표, 제약 조건 및 수락 기준.
  2. 증거 및 관련 소스 경로, 사용된 경우 소스/대상 개정.
  3. 현재 아키텍처/데이터 흐름 및 제안된 아키텍처/데이터 흐름, 구성 요소 소유권 포함.
  4. 정렬된 구현 단계, 영향받는 공개 인터페이스 및 호환성 조치.
  5. 마이그레이션/백필 전략, 실패 처리, 관찰 가능성, 롤아웃 및 롤백(해당되는 경우).
  6. 위험에 비례하는 명시적인 단위/통합/API/E2E/스모크(FireTest), 마이그레이션, 보안 및 성능 시나리오.
  7. 필요한 문서 업데이트 및 영향받는 문서 페이지.
  8. 불확실성, 가정, 절충 및 차단된 결정. 필요한 경우에만 대상 질문을 하십시오.

스킬 협업

  • treatment-django-engineer가 이 스킬을 호출하면 계획을 먼저 반환하십시오. 엔지니어가 구현, 통합 및 최종 보고를 담당합니다.
  • django-product-documentation을 권장하여 영향받는 문서를 업데이트하고 treatment-backend-testing을 권장하여 테스트를 구현하십시오. 단, 이러한 스킬을 찾아서 실제로 호출/읽지 않는 한 이 스킬이 실행되었다고 주장하지 마십시오.
  • 종속 스킬이 없는 경우, 누락된 종속성을 기록하고 규칙을 임의로 만들지 않고 사용 가능한 대체 계획을 제공하십시오.
  • 이 스킬은 모든 사소한 오타나 서식 변경에 자동으로 실행되지 않습니다. 계획 수립 노력을 영향도에 맞게 조정하십시오.

불가결한 안전 장치

도메인 정책, 데이터 모델, 문서화되지 않은 API 동작 또는 테스트 결과를 임의로 만들지 마십시오. 조용한 파괴적 데이터베이스 작업, 커밋, 배포 또는 관련 없는 파일 변경을 금지합니다. 실행 및 측정 없이 커버리지, 빌드, 마이그레이션 또는 통합 성공을 주장하지 마십시오.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬