홈 / Skills / 개발 생산성 / Grill with Docs (질문하며 문서화)
개발 생산성

Grill with Docs (질문하며 문서화)

Matt PocockMITSkill 언어: 영어
라이선스 확인됨스크립트 없음중간 위험
실행 예시실제 실행 · claude-sonnet-5-5 · 2026년 10월
/grill-with-docs I'm designing a "meal plan" feature for my recipe-sharing site: users pick recipes for each day of the week and get a combined shopping list. Please grill me on the design and record decisions as you go.
Skill: grilling
Skill: domain-modeling
Read: /private/var/folders/ny/1wbtvz6s0hd918ll0msz_5680000gn/T/skill-trial-dcmv_6j_/GLOSSARY.md

No GLOSSARY.md exists yet, so I'll create one when the first term is settled. These are the questions with no prerequisites. The rest of the design depends on your answers to them.

❓ Q1 - What is a "meal plan"?: Is a Meal Plan a persistent object a user creates, names, and keeps (for example "Week of Oct 14"), or just the user's single current week view that gets overwritten? Is it tied to a calendar week (dated) or to a generic Mon–Sun template that can be reused?

➡️ Make it a persistent, named object tied to a specific calendar week (it has a start date). Users can duplicate a past plan into a new week. That covers the template use case without a second concept.


❓ Q2 - How many meals per day?: "Pick recipes for each day" is ambiguous. Does each day hold one recipe, or several, such as breakfast, lunch, dinner, and snack slots? Can one slot hold multiple recipes, such as a main and a side?

➡️ Each day has named meal slots (breakfast, lunch, dinner, snack). A slot can hold multiple recipes, and any slot can be left empty.


❓ Q3 - Which recipes can be planned?: Can users plan only recipes from the site (their own, other users' public ones, and saved ones), or also free-text entries like "leftovers" or "eating out"? What happens to a plan when the recipe's author edits or deletes the recipe?

➡️ Only site recipes, plus a free-text "note" entry that adds nothing to the shopping list. When a recipe is edited, the plan reflects the latest version. When a recipe is deleted or made private, the plan keeps a tombstone entry, and the shopping list excludes it with a visible warning.


❓ Q4 - Servings: Recipes have a fixed yield, such as "serves 4". Can the user set a servings count per planned entry (scaling the ingredient quantities), or is every entry one cooking of the recipe as written?

➡️ Yes. Each planned entry has its own servings count, which defaults to the recipe's yield. Ingredient quantities are scaled proportionally.


❓ Q5 - Shopping list: derived or stored?: Is the Shopping List always computed live from the plan, or is it a separate object created from the plan? If it's separate, it can hold checked-off items and manual additions. If it's live, those need somewhere else to live.

➡️ Make it a separate object generated from the plan. It stores check-off state and manual extra items. Regenerating is an explicit user action that preserves checked-off and manual items where it can.


❓ Q6 - Ownership and sharing: Is a meal plan private to its owner, or can it be shared or published, for example a household co-editing one or a public "my week of meals" post? This is a recipe-sharing site, so sharing is likely to come up.

➡️ Private to the owner in v1. Others can copy a plan only via an explicit share link that creates their own copy. There is no co-editing.


I'll record the terms (Meal Plan, Meal Slot, Planned Entry, Shopping List) in GLOSSARY.md as you settle them. Ingredient merging, unit conversion, and pantry handling come in the next round, once Q4 and Q5 are settled.

How it was tried: I installed grill-with-docs together with the grilling and domain-modeling skills it calls, in a clean temporary folder, and invoked it as a slash command with a made-up design (a meal-plan feature for a recipe site). Only Skill and Read tools were allowed, so no files could be written: the model says it will create GLOSSARY.md once terms are settled, and no document was actually produced in this run. It shows the first round of questions only.

하는 일

grill-me와 같은 집요한 인터뷰에 문서화가 더해집니다. 결정이 나오면 아키텍처 결정 기록(ADR)과 도메인 용어집으로 남깁니다. grilling(질문)과 domain-modeling(용어를 다듬고 기록) 두 Skill을 호출합니다.

동작 방식

  1. 직접 호출합니다(모델이 스스로 실행하지 않습니다).
  2. 에이전트가 grilling과 domain-modeling을 호출하게 합니다.
  3. 한 번에 한 질문씩 받는 동안 문서가 갱신됩니다.

적합한 상황

논의 과정을 채팅 속에 묻지 않고 남기고 싶은 설계 논의. grilling과 domain-modeling이 필요하며 프로젝트에 문서를 씁니다.

참고 사항 및 위험

중간 위험: 자체 스크립트나 네트워크 접근은 없지만, 시작하는 인터뷰는 결정이 나올 때마다 문서(ADR과 용어집)를 만들도록 되어 있어 프로젝트에 파일을 씁니다. 커밋 전에 변경 사항을 확인하고, 허용되는 저장소에서 사용하세요. `grilling`과 `domain-modeling`이 설치되어 있어야 하며 수동 호출 전용으로 표시되어 있습니다. `grilling`, `domain-modeling`을 함께 설치해 한 번 시험했습니다. 파일 쓰기를 막아 두었으므로 문서는 실제로 작성되지 않았고 첫 질문 라운드만 확인했습니다.

SKILL.md 원본패키지에 파일 3개