Matt Pocock

메모나 녹취록을 독자가 이해하기 쉬운 순서의 글로 구성합니다. 대화로 도입부와 문단의 역할을 확인하고, 합의한 내용을 별도 파일에 저장합니다.

• 흩어진 메모를 글로 구성
• 녹취록을 바탕으로 글 작성
• 집필 전에 도입부의 관점 비교

Turn a course plan into numbered exercise folders with problem, solution, and explanation variants. Create starter readme files, check naming and links with the project’s linter, and fix structural errors before committing.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

• Set up exercise folders for a new course section
• Create problem, solution, and explanation stubs
• Renumber exercises and check their structure

코드 구조를 살펴 이해와 테스트를 어렵게 하는 부분의 개선안을 도표가 포함된 HTML 보고서로 정리합니다. 후보를 선택하면 제약과 설계 결정을 대화로 구체화합니다.

• 자주 변경하는 영역의 설계 검토
• 리팩터링 방안을 도표로 비교
• 테스트하기 쉬운 모듈 설계 검토

코딩 작업 기록을 돌아보며 파일 탐색, 자동 검사, 지침, 도구 사용 등을 점검합니다. 다음 작업을 위한 에이전트 환경 개선안을 중요도순으로 정리합니다.

• 시간이 오래 걸린 개발 작업 회고
• 반복되는 실수를 막을 자동 검사 검토
• 에이전트용 지침 정리

호출자가 익혀야 할 사용법은 줄이고 복잡한 처리는 내부에 모으는 모듈 설계를 돕습니다. 공통 용어와 판단 기준으로 사용 편의성과 테스트 용이성을 검토합니다.

• 모듈 호출 방법 간소화
• 흩어진 복잡한 처리 통합
• 구현을 교체할 위치 검토

현재 대화를 다른 에이전트가 작업을 이어 갈 인계 문서로 정리합니다. 기존 자료와 다음에 사용할 스킬을 기록하고 민감한 정보는 가립니다.

• 다른 에이전트에게 작업 인계하기
• 새 세션을 시작할 준비하기
• 다음 작업에 맞는 인계 문서 만들기

명세서나 티켓의 작업을 코드로 구현합니다. 유형 검사와 테스트로 확인하고 code-review 스킬로 변경 사항을 검토한 뒤 현재 브랜치에 커밋합니다.

• 명세서에 따른 기능 구현
• 지정한 티켓의 작업 구현
• 유형 검사와 테스트로 변경 사항 확인

Replace TypeScript type assertions in tests with functions from @total-typescript/shoehorn. Use partial objects when only a few properties matter, or deliberately invalid data for error tests, then run a type check to verify the migration.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

• Replace as assertions in TypeScript tests
• Build test objects with only the properties you need
• Pass deliberately invalid data for error tests

명세서와 관련 티켓의 의존 관계를 읽고 여러 에이전트가 구현을 진행합니다. 테스트와 검토를 거쳐 결과를 하나의 통합 브랜치로 모으고 티켓 완료 처리까지 진행합니다.

• 여러 티켓으로 나뉜 명세 구현
• 독립적인 작업의 병렬 구현
• 구현 결과를 통합 브랜치에 모으기

재현하기 어려운 오류와 성능 저하를 증상 감지 테스트나 스크립트로 조사합니다. 원인 후보를 검증하고 수정한 뒤 재발 방지 테스트까지 확인합니다.

• 재현하기 어려운 오류 조사
• 처리 속도가 느려진 원인 조사
• 간헐적 오류를 반복해서 검증

혼자 판단하기 어려운 문제를 필요한 지식을 가진 사람에게 전달할 질문지로 정리합니다. 답변자의 역할과 필요한 사실을 확인하고 답변란이 있는 Markdown 문서를 만듭니다.

• 판단에 필요한 정보 수집
• 전문가에게 물어볼 질문 준비
• 회의 전에 서면 답변 수집

학습 목표와 현재 이해도에 맞춰 짧은 대화형 수업을 만듭니다. 퀴즈와 피드백으로 연습하고, 복습 자료와 학습 기록을 쌓아 여러 세션에 걸친 학습을 지원합니다.

• 새로운 분야를 여러 세션에 걸쳐 학습
• 퀴즈와 피드백으로 연습
• 복습용 요약표 만들기

이슈와 외부 코드 변경 요청을 분류하고 보고 내용을 검증합니다. 누락된 정보와 처리 상태를 정리하며, 에이전트나 사람이 착수할 작업 설명을 남깁니다.

• 관리자의 검토가 필요한 이슈 찾기
• 버그 보고와 외부 코드 변경 요청 검증
• 에이전트용 작업 설명 작성

계획, 명세, 대화를 각각 동작을 확인할 수 있는 작은 개발 티켓으로 나눕니다. 의존 관계와 착수 순서를 명시하고 사용자 확인 후 로컬 파일이나 이슈 관리 도구에 등록합니다.

• 명세를 개발 티켓으로 나누기
• 티켓 의존 관계와 착수 순서 정리
• 광범위한 변경을 단계적으로 진행

TypeScript 패키지 내부 파일의 직접 참조와 순환 의존성을 감지합니다. 공개 파일만 진입점으로 쓰도록 설정하고 예제, 검증, 문서까지 마련합니다.

• 패키지 내부 파일의 직접 참조를 막을 때
• 타입 검사와 함께 패키지 경계를 확인할 때
• 복사해서 쓸 패키지 틀을 만들 때

직전 설명을 이해하기 어려울 때 배경을 보충해 다시 설명합니다. 간소화된 기술 영어 표준과 프로젝트 용어집을 따라 대화의 흐름을 전달합니다.

• 직전 설명을 이해하기 쉽게 다시 듣기
• 대화 흐름을 이해할 배경 설명 받기
• 프로젝트 공통 용어로 설명 받기

업무와 일상의 반복 작업을 질문으로 구체화하고 시작 조건, 사람의 확인, 판단용 요약을 정리해 구현 담당자가 추가 질문 없이 만들 수 있는 워크플로 명세로 작성합니다.

• 위임할 수 있는 반복 작업 찾기
• 워크플로 시작 조건 정리
• 사람이 확인할 시점 결정

구체적인 사례와 코드 대조로 프로젝트의 업무 용어와 개념 경계를 명확히 합니다. 합의한 정의를 용어집에 기록하고 필요에 따라 중요한 설계 결정의 이유도 남깁니다.

• 모호한 업무 용어 정리
• GLOSSARY.md 생성과 갱신
• 업무 정의와 코드의 일치 여부 확인

Claude Code에서 Git 푸시와 변경 사항 폐기 등을 실행 전에 차단하는 훅을 설정합니다. 프로젝트별 또는 전체 적용을 선택하고 차단 명령 조정과 동작 확인까지 진행합니다.

• Claude Code의 Git 푸시 차단
• 변경 사항 폐기와 브랜치 삭제 방지
• 프로젝트별 또는 전체 제한 설정

공식 문서, 소스 코드, 명세 등 일차 자료로 질문을 조사합니다. 백그라운드 에이전트가 주장마다 출처를 달아 하나의 Markdown 조사 노트로 정리하고 저장소에 저장합니다.

• 공식 자료로 API 명세 확인
• 출처가 포함된 조사 노트 보관
• 다른 작업 중 자료 조사 맡기기

아이디어 정리, 구현, 오류 조사에 맞는 관련 스킬과 사용 순서를 안내합니다. 작업의 규모와 단계에 따라 다음 절차를 선택하도록 돕습니다.

• 아이디어부터 구현까지의 절차 선택
• 오류 조사를 시작할 지점 찾기
• 여러 세션에 걸친 개발 진행 방식 상담

코드 검토자를 위한 풀 리퀘스트 본문을 작성합니다. 도식과 변경 비교, 변경 전후의 동작 증거를 담고 되돌리기 쉬운 정도와 영향 범위를 짧게 정리합니다.

• 풀 리퀘스트 본문 작성
• 파일 트리와 변경 비교로 구조 설명
• 화면 변경 전후의 증거 제시

AI 에이전트가 읽는 스킬과 지침 문서를 작성하고 편집하도록 돕습니다. 절차, 참고 정보, 완료 조건을 정리하고 자료를 읽을 조건과 중복 내용을 검토합니다.

• 스킬 문서 작성과 편집
• AGENTS.md와 CLAUDE.md 정리
• 참고 자료를 읽을 조건 명확화

질문으로 글의 주제를 깊이 탐색하고 문장, 경험, 비유, 미완성 생각을 모읍니다. 구성을 정하지 않고 하나의 Markdown 파일에 글감을 쌓습니다.

• 글의 구성을 정하기 전 소재 모으기
• 경험과 관찰을 글의 조각으로 남기기
• 생각의 중심이 될 비유와 표현 찾기