database-driver-design

database-driver-design 개요

이 스킬은 무엇을 위한 것인가

database-driver-design 스킬은 데모용이 아니라 실제 운영에 올릴 수 있는 Swift 데이터베이스 클라이언트 라이브러리를 설계하는 데 도움을 줍니다. SwiftNIO와 Swift Concurrency를 기반으로 드라이버, 와이어 프로토콜 클라이언트, 커넥션 풀링 계층, 스트리밍 쿼리 API를 만드는 Backend Development 팀을 대상으로 합니다.

가장 잘 맞는 경우

프로토콜 상태 머신, 커넥션 생명주기 설계, 커맨드 타입 설계, 결과 스트리밍에서의 backpressure, actor/event-loop 정렬이 필요할 때 이 database-driver-design 스킬을 사용하세요. 일회성 래퍼를 만드는 것이 아니라, 실제 Swift 드라이버 패턴과 설계 선택을 비교하면서 판단해야 할 때 특히 유용합니다.

무엇을 피하게 해 주는가

이 스킬의 핵심 가치는 나중에 되돌리기 어려운 구조적 실수를 줄이는 데 있습니다. 안전하지 않은 쿼리 구성, 누수되기 쉬운 풀링 동작, 맞지 않는 동시성 모델, 잘못 호출하기 쉬운 커맨드 API 같은 문제를 예방하는 데 도움이 됩니다. 이건 설계 가이드이므로, 기능 수를 늘리는 것보다 정확성과 유지보수성을 더 크게 개선합니다.

database-driver-design 스킬 사용 방법

설치하고 올바른 진입점을 여세요

사용 중인 skill runner에서 database-driver-design install 흐름으로 설치한 뒤, 먼저 SKILL.md부터 보세요. 이 repo에는 지원용 rules/, resources/, scripts/ 폴더가 없으므로, 스킬 자체가 의도적으로 단독형으로 구성되어 있습니다. 즉, 첫 읽기가 곧 전체 판단 범위입니다.

스킬에 구체적인 드라이버 문제를 주세요

database-driver-design usage는 대상 데이터베이스, transport, 그리고 해결하려는 실패 모드를 구체적으로 적을 때 가장 잘 작동합니다. 예를 들어 “NIO 위의 텍스트 기반 wire protocol에 대해 pipelined queries, pooling, streaming rows를 지원하는 Swift 클라이언트를 설계해 달라” 또는 “이 ad hoc query layer를 안전한 bindings를 갖춘 typed commands로 리팩터링해 달라”처럼 입력하세요. “database driver 도움 필요”처럼 넓은 요청은 실행 가능한 아키텍처 결론을 내기엔 너무 모호합니다.

제약 조건을 명시한 프롬프트를 쓰세요

좋은 database-driver-design guide 프롬프트에는 프로토콜 스타일, 동시성 모델, API 형태가 들어가야 합니다. 예를 들어 async/await가 필요한지, event-loop-first API가 필요한지, result streaming, TLS, prepared statements, command cancellation이 필요한지까지 지정하세요. 그러면 스킬이 일반적인 드라이버 개념 설명에 머무르지 않고, 중요한 트레이드오프에 집중할 수 있습니다.

먼저 이 부분들을 읽으세요

개요를 먼저 보고, 그다음 agent behavior contract, 이어서 command typing, interpolation, pooling, protocol state machines 관련 핵심 패턴을 읽으세요. 이 부분들이 설치 판단의 질과 구현 형태에 가장 큰 영향을 줍니다. database-driver-design for Backend Development 적합성을 평가하는 중이라면, 이 순서가 아키텍처 기대치를 가장 빨리 파악하는 방법입니다.

database-driver-design 스킬 FAQ

이건 Swift 데이터베이스 드라이버에만 해당하나요?

네, 가장 잘 맞는 경우는 Swift와 SwiftNIO 기반 클라이언트 설계입니다. 다른 언어로 드라이버를 작성하더라도 아이디어 자체는 도움이 될 수 있지만, 이 스킬은 Swift concurrency, event loop, type-safe command modeling에 맞춰 최적화되어 있습니다.

일반 프롬프트와 다른가요?

네. 일반 프롬프트로도 데이터베이스 클라이언트를 설명할 수는 있지만, database-driver-design은 typed commands, query binding rules, state transitions, backpressure, pooling discipline 같은 설계 어휘를 더 선명하게 제공합니다. 보통은 왕복 질문이 줄고, 빠뜨리는 제약도 줄어듭니다.

초보자도 사용할 수 있나요?

네, 구조를 갖춘 드라이버를 만들거나 검토하려는 목적이라면 가능합니다. 프로토콜 전문 지식이 깊지 않아도 시작할 수 있지만, 데이터베이스, transport, 예상 트래픽 패턴, 그리고 클라이언트가 sync인지 async인지 stream-based인지 같은 맥락은 반드시 제공해야 합니다.

언제는 쓰지 말아야 하나요?

ORM 사용법, 단순 SQL 예시, 일반적인 repository layer만 필요하다면 건너뛰세요. 이 스킬은 애플리케이션 레벨의 쿼리 작성이 아니라, 드라이버 아키텍처와 통합 세부 사항을 위한 것입니다.

database-driver-design 스킬 개선 방법

정확한 운영 모델을 알려 주세요

가장 좋은 결과는 드라이버가 어떻게 동작할지 구체적으로 적을 때 나옵니다. 요청당 1개 커넥션인지, pooled connections인지, multiplexing인지, streaming cursor인지 명시하세요. 예상 부하, 지연 시간 목표, cancellation이나 retries 필요 여부도 함께 넣어야 합니다. 이런 세부 정보가 database-driver-design의 권장안을 직접 바꿉니다.

가장 어려운 제약을 먼저 드러내세요

가장 큰 리스크가 protocol correctness인지, memory pressure인지, backpressure인지, actor/event-loop mismatch인지 처음부터 말하세요. 이 스킬은 모든 것을 한 번에 해결하려고 하기보다, 실제 병목을 중심으로 최적화할 때 가장 강합니다.

한 번에 한 레이어씩 요청하세요

더 나은 database-driver-design usage를 원한다면 요청을 설계 단계로 나누세요. API surface, connection lifecycle, query binding, 그다음 streaming과 pooling 순으로 분리하면 됩니다. 이렇게 하면 한 번에 전체 드라이버를 요구하는 것보다 출력이 훨씬 깔끔해지고, 결과를 SKILL.md와 대조해 검토하기도 쉬워집니다.

실제 예시로 반복하세요

첫 답변을 받은 뒤에는 실제 command 하나, connection failure 사례 하나, 또는 샘플 response stream 하나를 다시 넣어 보세요. 그러면 스킬이 type shape, error handling, state transitions를 더 정교하게 다듬을 수 있고, 추상적인 설명에 머물지 않게 됩니다. database-driver-design install 판단에서도, 이 방식이 backend workflow와 맞는지 가장 빨리 확인하는 방법입니다.