source-driven-development

source-driven-development 스킬 개요

source-driven-development가 하는 일

source-driven-development 스킬은 공식 문서를 먼저 확인한 뒤에만 프레임워크별 코드를 작성하고, 구현 과정에서 그 출처를 인용하거나 반영하도록 돕습니다. “대충 맞는 코드”로는 부족한 작업, 예를 들어 스타터 코드, 반복되는 앱 패턴, 업그레이드 대응, 그리고 프레임워크 버전에 따라 정답이 달라지는 기능에 특히 적합합니다.

누가 사용하면 좋은가

React, Vue, Next.js, Svelte, Angular 같은 도구로 개발하면서 오래된 패턴을 덜 쓰고 싶다면 source-driven-development skill이 잘 맞습니다. 특히 폼, 라우팅, 인증, 상태 관리, 데이터 페칭, 프로젝트 스캐폴딩용 코드를 에이전트가 생성하는 작업에서 유용합니다.

일반적인 프롬프트와 다른 점

일반 프롬프트는 학습 데이터에 기반해 그럴듯한 코드를 만들어낼 수 있습니다. 반면 이 스킬은 스택을 식별하고, 공식 소스를 확인한 다음, 그 소스를 바탕으로 구현하는 verify-first 흐름으로 작업을 유도합니다. 그래서 프로덕션 작업, 버전에 민감한 API, 출처 추적이 중요한 코드 리뷰 상황에 더 잘 맞습니다.

source-driven-development 스킬 사용 방법

에이전트 설정에 스킬 설치하기

리포지토리의 스킬 설치 절차에 따라 설정한 뒤, 코드 생성을 요청하기 전에 에이전트 컨텍스트에 source-driven-development를 로드하세요. 일반적인 source-driven-development install 흐름은 repo의 skill manager command를 실행한 다음, 에이전트가 의도된 워크플로를 따를 수 있도록 스킬 파일 자체를 읽게 하는 방식입니다.

작업 요청을 source-first 프롬프트로 바꾸기

가장 좋은 source-driven-development usage를 원한다면 프레임워크, 알 수 있는 경우 버전, runtime, 그리고 정확한 목표를 함께 주세요. 좋은 입력 예시는 다음과 같습니다. “Use source-driven-development to add a protected dashboard route in Next.js App Router 15, using official docs only, and explain the source for each pattern.” 반대로 “build auth”처럼만 말하면 약한 입력입니다. 스택과 기능이 구체적일수록 에이전트가 추측할 여지가 줄어듭니다.

먼저 읽어야 할 파일

SKILL.md부터 읽고, 그다음 스킬이 참조하는 링크된 문서, 예제, 리포지토리 메모를 확인하세요. 이 리포지토리에는 따로 추적해야 할 helper folder가 없으므로, 핵심은 SKILL.md의 프로세스를 정확히 따르고 이를 대상 앱의 기존 관례에 맞게 연결하는 것입니다.

output 품질을 높이는 source-driven-development 워크플로

4단계 루프를 쓰세요. 스택과 버전을 식별하고, 공식 문서를 가져오고, 가장 작은 올바른 버전을 구현한 다음, 결과가 여전히 문서와 일치하는지 검증하는 방식입니다. 코드 생성을 요청할 때는 기존 폴더 구조, package manager, framework mode, 그리고 citation이 주석에 필요한지 별도 설명에 필요한지 같은 제약도 함께 적어두면 좋습니다.

source-driven-development 스킬 FAQ

source-driven-development는 큰 프레임워크에만 필요한가

아니요. source-driven-development guide는 API 변경이 잦거나 경쟁하는 패턴이 여러 개인 경우에 가장 가치가 큽니다. 이런 상황은 현대적인 프레임워크와 라이브러리에서 흔합니다. 반대로 단순한 문구 수정이나 프레임워크 버전에 의존하지 않는 로직에는 효용이 낮습니다.

일반 코드 프롬프트 대신 써야 하나

속도보다 정확성과 추적 가능성이 더 중요할 때 사용하세요. 단순하고 버전 비의존적인 수정에는 일반 프롬프트도 충분하지만, 현재 공식 문서를 근거로 방어할 수 있는 코드를 원한다면 source-driven-development for Code Generation 방식이 더 적합합니다.

초보자도 쓰기 쉬운가

네. 프레임워크 이름을 말할 수 있고 기능 요구를 설명할 수 있다면 충분히 사용할 수 있습니다. 초보자에게도 패턴을 추측하는 부담을 줄여준다는 장점이 있지만, 여전히 앱 스택과 목표 동작은 제공해야 합니다. 이 정보가 없으면 에이전트가 엉뚱한 문서를 검증할 수 있습니다.

언제는 잘 맞지 않는가

사소한 수정, 순수 로직, 또는 사용자가 검증보다 가장 빠른 답변을 명확히 원하는 경우에는 쓰지 않는 편이 낫습니다. 작업이 특정 프레임워크 버전에 의존하지 않는다면, 추가적인 source checking은 대개 오버헤드만 늘리고 얻는 가치가 크지 않습니다.

source-driven-development 스킬 개선 방법

에이전트에 더 정확한 source target 주기

가장 큰 품질 향상은 정확한 프레임워크, 버전, 기능을 지정하는 데서 나옵니다. 예를 들어 “Next.js stuff”라고 하지 말고 “official Next.js App Router docs for server actions”처럼 말하세요. 대상이 구체적일수록 잘못된 소스를 조회할 가능성이 줄고, 최종 코드 정확도도 높아집니다.

출력 제약을 처음부터 명시하기

citation이 필요하다면 형식을 분명히 적어두세요. 예를 들어 inline comments인지, 짧은 source note인지, 간단한 구현 요약인지 지정하면 됩니다. 또한 기존 types, file names, UI behavior처럼 바뀌면 안 되는 요소도 함께 적어야 합니다. 그래야 스킬이 source-driven 흐름을 유지하면서도 코드베이스를 과하게 뜯어고치지 않습니다.

흔한 실패 패턴 주의하기

주요 위험은 잘못된 버전의 문서를 보는 것, 여러 릴리스의 패턴을 섞는 것, 또는 튜토리얼 예제에 구현을 과하게 맞추는 것입니다. 첫 답변이 지나치게 일반적으로 느껴진다면, 에이전트에게 공식 문서를 다시 확인하고 현재 스택에 맞게 해법을 더 좁히라고 요청하세요.

추측이 아니라 source를 기준으로 반복 개선하기

첫 결과가 대체로 맞지만 아쉽다면, 이미 검증된 부분은 유지하고 빠진 동작만 조정하는 두 번째 패스를 요청하세요. source-driven-development에서는 스택을 더 명확히 하고, 소스를 다시 확인한 다음, 한 번에 하나의 구체적인 변경만 적용하며 구현을 다듬는 루프가 가장 효과적입니다.