Community코딩 & 개발github.com

mattpocock/ask-matt

현재 상황에 가장 적합한 스킬이나 워크플로우를 물어보세요. 이 저장소의 모든 스킬을 안내하는 라우터입니다.

ask-matt란 무엇인가요?

이 스킬은 개발자가 다양한 AI 에이전트 스킬 중 현재 상황에 가장 적합한 것을 찾을 수 있도록 돕는 라우터 역할을 합니다. 특히 `mattpocock` 저장소의 여러 스킬들을 체계적으로 연결하여 '아이디어 → 출시'의 메인 흐름, 버그 수정이나 기능 요청 같은 온-램프(on-ramp), 코드베이스 건강 관리, 도메인 모델링과 같은 어휘 레이어 등을 안내합니다. 이 스킬은 명확한 컨텍스트 관리를 강조하여, 각 세션의 컨텍스트 윈도우가 효율적으로 유지되도록 `/handoff` 및 `/compact`와 같은 교차 세션 도구를 제공합니다. 또한 `Claude Code`, `Cursor`, `Codex` 등 다양한 AI 코딩 에이전트 플랫폼에서 사용할 수 있도록 설계되었으며, 사용자가 직접 스킬을 작성하거나 편집할 수 있는 `/writing-great-skills` 같은 지원 도구도 포함하고 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mattpocock/skills/tree/main/skills/engineering/ask-matt

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Ask Matt

모든 스킬을 기억할 필요는 없습니다. 그냥 물어보세요.

**플로우(flow)**란 스킬을 통과하는 경로입니다. 대부분의 경로는 하나의 메인 플로우를 따라 흐르며, 두 개의 **온-램프(on-ramps)**가 그 위에 합류합니다. 그 외의 모든 것은 독립 실행형이거나, 그 아래에서 실행되는 어휘 레이어입니다.

메인 플로우: 아이디어 → 출시

대부분의 작업이 거치는 경로입니다. 아이디어를 구체화하여 제품으로 만들고자 할 때 시작합니다.

  1. /grill-with-docs — 인터뷰를 통해 아이디어를 다듬습니다. 코드베이스가 있을 때 시작하세요: 상태를 유지하며 CONTEXT.md와 ADR에 학습한 내용을 보관합니다. (코드베이스가 없다면 /grill-me를 사용하세요 — Standalone 참조. 둘 다 동일한 /grilling 프리미티브를 실행하지만, grill-with-docs는 문서 기록을 남깁니다.)

  2. 분기 — 모든 질문을 대화로 해결할 수 있습니까? 질문에 실행 가능한 답변(상태, 비즈니스 로직, 직접 봐야 하는 UI)이 필요하다면 프로토타입을 통해 우회하고, 양방향으로 /handoff 로 연결합니다 (Crossing sessions 참조):

    • /handoff 로 나간 후, 해당 파일을 대상으로 새 세션을 엽니다.
    • /prototype 으로 임시 코드를 통해 질문에 답합니다.
    • /handoff 로 학습한 내용을 다시 가져와 원래 아이디어 스레드에서 참조합니다.
  3. 분기 — 여러 세션에 걸친 작업입니까?

    • 예 → /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 — 첫 번째 엔지니어링 플로우 전에 실행하여 이슈 트래커, 분류 레이블, 문서 레이아웃을 다른 스킬이 가정하는 대로 구성합니다. 사용자 정의 이슈 트래커도 작동합니다.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

mattpocock/caveman

Ultra-compressed communication mode. Cuts token usage ~75% by dropping filler, articles, and pleasantries while keeping full technical accuracy. Use when user says "caveman mode", "talk like caveman", "use caveman", "less tokens", "be brief", or invokes /caveman.

mattpocock/claude-handoff

Hand the current conversation off to a fresh background agent that picks up the work immediately.

mattpocock/codebase-design

Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.

mattpocock/design-an-interface

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

mattpocock/diagnose

Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce → minimise → hypothesise → instrument → fix → regression-test. Use when user says "diagnose this" / "debug this", reports a bug, says something is broken/throwing/failing, or describes a performance regression.

mattpocock/diagnosing-bugs

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.

mattpocock/domain-modeling

Build and sharpen a project's domain model. Use when the user wants to pin down domain terminology or a ubiquitous language, record an architectural decision, or when another skill needs to maintain the domain model.

mattpocock/edit-article

Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.

mattpocock/git-guardrails-claude-code

Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.

mattpocock/grilling

Grill the user relentlessly about a plan or design. Use when the user wants to stress-test a plan before building, or uses any 'grill' trigger phrases.

mattpocock/grill-me

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

mattpocock/grill-with-docs

Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.

mattpocock/handoff

Compact the current conversation into a handoff document for another agent to pick up.

mattpocock/implement

Implement a piece of work based on a PRD or set of issues.

mattpocock/implement-spec

Implement a specification in code.

mattpocock/improve-codebase-architecture

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.

mattpocock/loop-me

Grill me about specs for the workflows I want to build, within this workspace.

mattpocock/migrate-to-shoehorn

Migrate test files from `as` type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace `as` in tests, or needs partial test data.

mattpocock/obsidian-vault

Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.

mattpocock/prototype

Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.

관련 스킬