AI가 기능을 잘못 이해한다면 프롬프트를 더 길게 쓰기 전에 프로젝트에서 쓰는 말과 규칙을 확인해 보세요. grill-with-docs는 질문을 통해 설계를 다듬으면서 프로젝트의 용어와 의사결정을 문서화하는 스킬입니다. 문서를 읽게 한다고 오류가 사라지는 것은 아니므로 코드와 실제 동작도 함께 확인해야 합니다.
왜 같은 단어가 문제가 될까요?
예를 들어 영상 제작 서비스에서 ‘피치’가 새 아이디어를 뜻하는지 승인된 제작안을 뜻하는지에 따라 저장할 정보와 처리 과정이 달라집니다. AI가 일반적인 의미로 추측하면 사용자의 의도와 다른 설계를 만들 수 있습니다. 팀이 합의한 정의와 예시를 기록하면 질문과 검토의 출발점이 명확해집니다.
Matt Pocock의 공식 스킬 저장소는 grill-with-docs를 질문을 통해 도메인 모델을 다듬고 용어 사전과 아키텍처 의사결정을 함께 정리하는 스킬로 설명합니다. 현재 저장소의 문서 이름과 설치 방식은 영상 제작 당시와 다를 수 있습니다.
질문에서 문서까지 이어지는 흐름
1. 현재 자료를 살펴봅니다
기존 용어 문서, 설계 기록과 관련 코드를 확인합니다. 문서가 오래됐을 수도 있으므로 실제 구현과 사용자의 현재 결정이 일치하는지 살펴봐야 합니다.
2. 모호한 관계를 질문합니다
누가 무엇을 만들고, 어떤 상태에서 변경하거나 삭제할 수 있는지 한 가지씩 묻습니다. 다음은 설명용 요청입니다.
현재 프로젝트의 용어 문서와 관련 코드를 확인해 주세요.
[새 기능]의 의미와 기존 개념이 충돌하는 지점을 찾아
제가 결정해야 하는 질문을 하나씩 해 주세요.
확인하지 못한 내용은 추측하지 말아 주세요.
3. 합의한 용어와 결정을 남깁니다
중요한 용어의 뜻과 예시, 서로 다른 개념과의 차이를 용어 문서에 정리합니다. 오래 영향을 줄 설계 선택은 이유와 대안을 의사결정 기록에 남길 수 있습니다. 파일명은 프로젝트가 이미 사용하는 기준을 따르세요.
4. 구현과 결과를 다시 확인합니다
문서는 합의를 전달하지만 코드의 실제 동작을 대신하지 않습니다. 요구사항과 변경 범위, 테스트 결과가 합의한 의미에 맞는지 확인하세요. AI의 질문이 부적절하거나 답이 자료와 충돌하면 사람이 판단하고 문서를 수정해야 합니다.
새 아이디어의 불확실성을 논의하는 질문 방식과 기존 문서까지 대조하는 방식은 함께 활용할 수 있습니다. 대화 언어가 다르게 나올 때는 원하는 언어와 유지할 전문 용어를 요청에 명시하는 방법도 있습니다.
다음 한 걸음
내 환경에서 막힌 부분은 실행 단계와 함께 질문해 주세요. 바꿔 만든 결과도 함께 나눌 수 있습니다.