Setup Matt Pocock Skills: 먼저 프로젝트 규칙을 명확히 쓰기

이 Skill은 설치 문제를 해결하지 않습니다

/setup-matt-pocock-skills는 "설치 후 실행하는 초기화 명령"으로 오해하기 쉽습니다. 실제로는 프로젝트 계약 생성기에 더 가깝습니다. 후속 스킬에게 이 저장소가 어떻게 작업을 추적하고, 이슈를 어떻게 태그하며, 도메인 언어와 아키텍처 결정을 어디서 읽을지 알려줍니다.

Matt는 README의 Quickstart에서 설치 시 /setup-matt-pocock-skills를 선택한 다음 에이전트에서 실행하라고 특별히 강조합니다. 이유는 간단합니다. to-prd, to-issues, triage, diagnose, tdd, improve-codebase-architecture, zoom-out 모두 동일한 프로젝트 컨텍스트를 필요로 합니다. 각 스킬이 임시로 물어보면 프로세스가 너무 파편화될 것입니다.

이것은 "Claude의 선호도를 설정"하는 것이 아니라 세 가지 엔지니어링 질문에 답하는 것입니다.

왜 중요한가

이 스킬 세트의 핵심 아이디어는 "작고 조합 가능함"입니다. 작다는 것은 다음을 의미합니다. 전체 프로젝트 프로세스를 스스로 관리하고 싶어하지 않으므로 프로젝트 내의 실제 약속을 알아야 합니다.

예시: /to-issues는 이슈를 생성해야 합니다. 설정이 없으면 다음을 알아야 합니다.

• gh issue create 호출
• glab issue create 호출
• .scratch/<feature>/에 쓰기
• 또는 Linear/Jira 복사 가능한 텍스트 생성

또는 /triage는 이슈를 ready-for-agent로 이동해야 합니다. 저장소의 실제 태그가 ai:ready인데 스킬이 ready-for-agent라는 새 태그를 생성하면 이슈 트래커가 즉시 더러워집니다.

따라서 /setup-matt-pocock-skills의 가치는 자동화가 아니라 암묵적인 약속을 명시적으로 만드는 것입니다.

무엇을 읽는가

이 스킬은 먼저 저장소를 탐색하며 가정하지 않습니다.

• git remote -v 및 .git/config: GitHub/GitLab 프로젝트인지 판단
• 루트 디렉토리 AGENTS.md / CLAUDE.md: 이미 ## Agent skills 섹션이 있는지 확인
• 루트 디렉토리 CONTEXT.md / CONTEXT-MAP.md: 도메인 언어 문서 형식을 판단
• docs/adr/ 및 src/*/docs/adr/: ADR이 전역인지 모듈 수준인지 판단
• docs/agents/: 이미 설정이 실행되었는지 확인
• .scratch/: 로컬 markdown 이슈 약속이 이미 있는지 판단

이는 Matt의 전체 워크플로 스타일과 일치합니다. 먼저 프로젝트의 실제 상태를 보고 규칙을 작성합니다.

세 가지 결정

1. 이슈 트래커

이것은 후속 작업 단위가 구현되는 위치입니다.

기본값은 GitHub입니다. 이 스킬 세트가 GitHub Issues를 중심으로 처음 설계되었기 때문입니다. 그러나 GitLab과 로컬 markdown도 동등한 선택지로 고려했습니다.

핵심은 무엇을 선택하느냐가 아니라 팀이 실제로 사용하는 것을 선택하는 것입니다. 잘못 선택하면 후속 스킬이 잘못된 시스템에서 작업을 생성합니다.

2. 트리아지 태그 어휘

/triage는 내부적으로 5가지 상태 역할을 사용합니다.

설정은 이러한 역할에 해당하는 실제 태그 이름을 묻습니다. 프로젝트에 기존 태그가 없으면 기본 이름을 사용하면 됩니다. 이미 자체 명명 체계가 있다면 스킬이 새 것을 만들지 않도록 여기서 매핑해야 합니다.

3. 도메인 문서

이것은 Matt의 스킬 세트와 일반 프롬프트의 가장 큰 차이점입니다. 현재 대화만 보는 것이 아니라 프로젝트의 도메인 언어와 아키텍처 결정을 읽습니다.

가장 간단한 형태:

/
├── CONTEXT.md
└── docs/
    └── adr/

대형 모노레포는 다중 컨텍스트를 사용할 수 있습니다.

/
├── CONTEXT-MAP.md
├── apps/
│   └── web/
│       ├── CONTEXT.md
│       └── docs/adr/
└── services/
    └── billing/
        ├── CONTEXT.md
        └── docs/adr/

설정은 지금 모든 문서를 작성하도록 강요하는 것이 아니라 후속 스킬에게 어디서 찾아야 하는지, 찾지 못했을 때 어떻게 생성해야 하는지를 알려줍니다.

무엇을 작성하는가

최종적으로 두 가지 유형의 출력이 있습니다.

첫 번째 유형은 AGENTS.md 또는 CLAUDE.md의 ## Agent skills 섹션입니다.

## Agent skills

### Issue tracker

...

### Triage labels

...

### Domain docs

...

두 번째 유형은 docs/agents/ 아래의 세 가지 설명입니다.

기존 CLAUDE.md를 우선적으로 편집하며, CLAUDE.md가 없으면 AGENTS.md를 고려합니다. 이는 프로젝트에 서로 경쟁하는 두 개의 에이전트 규칙 진입점을 만들지 않는다는 중요한 절제를 반영합니다.

사용 권장 사항

Matt의 스킬 세트를 처음 설치할 때 순서는 다음과 같습니다.

1. 설치: npx skills@latest add mattpocock/skills
2. /setup-matt-pocock-skills 선택
3. /setup-matt-pocock-skills 실행
4. 실제 프로젝트 상태에 따라 이슈 트래커, 태그, 도메인 문서 세 가지 질문에 답합니다.
5. 생성된 ## Agent skills 및 docs/agents/*.md를 확인합니다.
6. 그런 다음 /grill-with-docs, /to-prd, /triage를 사용합니다.

/grill-me만 개별적으로 경험하고 싶다면 설정을 건너뛸 수 있습니다. 하지만 엔지니어링 프로세스에 진입한다면 먼저 하는 것이 좋습니다.

이 Skill의 설계 영감

/setup-matt-pocock-skills는 매우 단순해 보이지만 에이전트 워크플로에서 가장 흔한 문제 중 하나를 해결합니다. 규칙이 사람의 머릿속에 흩어져 있다는 것입니다.

많은 팀은 "어떤 태그를 사용하는가", "어떤 이슈를 AI에게 줄 수 있는가", "CONTEXT.md는 어디에 있는가"와 같은 정보를 구두 약속으로 간주합니다. 사람은 알지만 AI는 모릅니다. AI는 모르기 때문에 계속 묻거나, 더 나쁘게는 스스로 추측합니다.

설정의 역할은 이러한 구두 약속을 읽을 수 있는 파일로 만드는 것입니다. 후속 스킬은 더 똑똑해질 필요 없이 동일한 프로젝트 계약을 안정적으로 읽기만 하면 됩니다.

이것이 제가 이 스킬에 대해 별도의 글을 쓸 가치가 있다고 생각하는 이유입니다. 이것은 과시적인 스킬이 아니라 전체 워크플로가 장기적으로 실행될 수 있도록 하는 기반입니다.

참고 자료

다음 글: Grill Me: AI가 코드를 작성하기 전에 50가지 질문으로 당신을 심문하게 하세요.