Ask Matt
모든 스킬을 기억할 필요는 없습니다. 그냥 물어보세요.
**플로우(flow)**란 스킬을 통과하는 경로입니다. 대부분의 경로는 하나의 메인 플로우를 따라 흐르며, 두 개의 **온-램프(on-ramps)**가 그 위에 합류합니다. 그 외의 모든 것은 독립 실행형이거나, 그 아래에서 실행되는 어휘 레이어입니다.
메인 플로우: 아이디어 → 출시
대부분의 작업이 거치는 경로입니다. 아이디어를 구체화하여 제품으로 만들고자 할 때 시작합니다.
-
/grill-with-docs— 인터뷰를 통해 아이디어를 다듬습니다. 코드베이스가 있을 때 시작하세요: 상태를 유지하며CONTEXT.md와 ADR에 학습한 내용을 보관합니다. (코드베이스가 없다면/grill-me를 사용하세요 — Standalone 참조. 둘 다 동일한/grilling프리미티브를 실행하지만,grill-with-docs는 문서 기록을 남깁니다.) -
분기 — 모든 질문을 대화로 해결할 수 있습니까? 질문에 실행 가능한 답변(상태, 비즈니스 로직, 직접 봐야 하는 UI)이 필요하다면 프로토타입을 통해 우회하고, 양방향으로
/handoff로 연결합니다 (Crossing sessions 참조):/handoff로 나간 후, 해당 파일을 대상으로 새 세션을 엽니다./prototype으로 임시 코드를 통해 질문에 답합니다./handoff로 학습한 내용을 다시 가져와 원래 아이디어 스레드에서 참조합니다.
-
분기 — 여러 세션에 걸친 작업입니까?
- 예 →
/to-prd(스레드를 PRD로 전환) →/to-issues(PRD를 독립적으로 처리 가능한 이슈로 분할). 이슈는 독립적이므로 각 이슈 간에 컨텍스트를 명확히 초기화하세요: 이슈당 새 세션을 시작하고/implement에 PRD와 해당 이슈 하나를 전달하여 시작합니다. - 아니오 → 동일한 컨텍스트 윈도우에서 바로
/implement를 실행합니다.
어느 쪽이든
/implement는 내부적으로/tdd를 구동하여 각 이슈를 한 번에 하나의 레드-그린 슬라이스로 빌드한 후, 커밋하기 전에/code-review(diff에 대한 표준 + 스펙의 두 축 리뷰)를 실행하여 마무리합니다. 전체 스펙 없이 특정 동작을 테스트 우선으로 빌드하려면/tdd만 사용하고, 브랜치나 PR을 고정된 기준에 대해 리뷰하려면/code-review를 단독으로 사용하세요. - 예 →
컨텍스트 위생
1~3단계를 하나의 끊어지지 않은 컨텍스트 윈도우 안에서 유지하세요 — /to-issues 이후까지 압축하거나 초기화하지 마십시오. 그래야 그릴링, PRD, 이슈가 모두 동일한 사고를 기반으로 구축됩니다. 이후 각 /implement 는 이슈를 기반으로 새로 시작합니다.
이에 대한 한계는 스마트 존(smart zone) 입니다: 모델이 여전히 날카롭게 추론할 수 있는 윈도우(최신 모델에서 약 120k 토큰)입니다. 세션이 /to-issues 전에 이 한계에 도달하면 성능이 저하된 상태로 진행하지 말고 /handoff 후 새 스레드에서 계속하세요.
온-램프(On-ramps)
작업을 생성한 후 메인 플로우에 합류하는 시작 상황입니다.
-
버그와 요청이 쌓이고 있음 →
/triage. 이슈를 분류 역할을 통해 이동시키고 에이전트가 처리 가능한 이슈를 생성하며, 이후/implement가 이를 처리합니다.분류는 직접 생성하지 않은 이슈 — 버그 리포트, 들어오는 기능 요청, 원시 상태로 도착하는 모든 것 — 에만 해당합니다.
/to-issues가 생성한 이슈는 이미 에이전트가 처리 가능하므로 분류하지 마세요. -
무언가 고장 났음 →
/diagnosing-bugs. 어려운 버그를 위한 것입니다: 한눈에 파악되지 않는 버그, 간헐적 오류, 두 개의 알려진 정상 상태 사이에 스며든 회귀. 빠른 피드백 루프(이 버그에서 이미 빨간색이 되는 하나의 명령)를 가질 때까지 이론을 세우지 않으며, 그런 다음 회귀 테스트와 함께 수정합니다. 사후 분석에서 실제 발견 사항이 버그를 고정할 좋은 접합부(seam)가 없다는 것이라면/improve-codebase-architecture로 넘깁니다.
코드베이스 건강
기능 작업이 아닌 유지보수입니다.
/improve-codebase-architecture— 에이전트가 작업하기 좋은 코드베이스를 유지하기 위해 여유 시간이 있을 때 실행하세요. 심화 기회를 표면화하며, 하나를 선택하면/grill-with-docs에서 메인 플로우로 가져갈 수 있는 _아이디어_를 생성합니다. 이것은 후보를 찾는 설문조사이며,/codebase-design(아래 참조)은 선택한 대상을 설계하는 벤치입니다.
그 아래의 어휘(Vocabulary underneath)
다른 스킬 아래에서 실행되는 두 개의 모델 호출 참조입니다 — 각각 해당 어휘의 단일 진실 공급원입니다. 문제가 프로세스가 아니라 단어 자체일 때 직접 사용하거나, 위의 스킬이 이를 불러오도록 두십시오.
/domain-modeling— 프로젝트의 도메인 언어를 다듬습니다: 모호한 용어에 도전하고, 과부하된 단어(세 가지 일을 하는 "account")를 해결하며, 되돌리기 어려운 결정을 ADR로 기록합니다./grill-with-docs가CONTEXT.md를 깔끔한 용어집으로 유지하기 위해 구동하는 능동적인 규율입니다./codebase-design— 모듈의 형태를 설계하기 위한 심화 모듈 어휘(모듈, 인터페이스, 깊이, 접합부(seam), 어댑터, 레버리지, 지역성(locality))입니다. 작은 인터페이스 뒤에 많은 동작을 깨끗한 접합부에 배치합니다./tdd와/improve-codebase-architecture모두 이 언어를 사용합니다.
교차 세션(Crossing sessions)
/handoff— 스레드가 가득 차거나 분기가 필요할 때(예:/prototype세션으로), 대화를 마크다운 파일로 압축합니다. 그 자리에서 계속하지 않고 새 세션을 열고 해당 파일을 참조하여 컨텍스트를 이어갑니다. 양방향으로 컨텍스트 윈도우 간의 브리지 역할을 합니다. 새 세션을 원하지만 현재 대화를 보존해야 할 때 사용하세요./compact(내장) — 동일한 대화 안에 머물며, 이전 턴을 요약합니다. 단계 사이의 의도적인 중단점에서 사용하세요. 말 그대로의 기록을 잃어도 괜찮을 때 사용합니다. 단계 중간에는 압축하지 마십시오 — 에이전트가 길을 잃을 수 있습니다./handoff는 포크(fork)하고,/compact는 계속합니다.
독립 실행형(Standalone)
메인 플로우에서 완전히 벗어납니다.
/grill-me—/grill-with-docs와 동일한 끈질긴 인터뷰이지만, 코드베이스가 없을 때 사용합니다. 무상태(stateless): 로컬에 아무것도 저장하지 않으며CONTEXT.md도 만들지 않습니다. 저장소에 속하지 않는 계획이나 설계를 다듬을 때 사용하세요./prototype— 하나의 설계 질문에 답하는 작고 임시적인 프로그램: 이 상태 모델이 적절한가, 또는 이 UI는 어떻게 보여야 하는가. 처음부터 임시적입니다 — 답변은 유지하고 코드는 삭제하세요. 메인 플로우의 2단계에서 우회로이지만, 설계 질문이 종이 위에서 해결하기 어려울 때 언제든지 사용하세요./research— 읽기 작업을 백그라운드 에이전트에 위임합니다: 일차 출처를 대상으로 질문을 조사한 후, 인용된 마크다운 파일을 저장소에 남깁니다. 에이전트가 읽는 동안 계속 작업하세요. 생성된 파일은/grill-with-docs에서 메인 플로우로 가져갈 내용입니다 — 리서치는 사고에 영양을 공급하지만, 대체하지는 않습니다./teach— 현재 디렉토리를 상태 저장 작업 공간으로 사용하여 여러 세션에 걸쳐 개념을 학습합니다./writing-great-skills— 스킬을 잘 작성하고 편집하기 위한 참고 자료입니다.
전제 조건
/setup-matt-pocock-skills — 첫 번째 엔지니어링 플로우 전에 실행하여 이슈 트래커, 분류 레이블, 문서 레이아웃을 다른 스킬이 가정하는 대로 구성합니다. 사용자 정의 이슈 트래커도 작동합니다.