name	task-done
description	작업 완료 후 Lock 해제, 정리, 지식 갱신까지 수행하는 마무리 루틴. 세션 중 새로 알게 된 이 프로젝트만의 기획·시스템·유기적 관계를 도메인 지식으로 승격 제안합니다.

Skill: /task-done (Task Completion)

코드 수정이 끝나면 반드시 이 마무리를 수행한다. 코드를 수정하고 세션을 끝내는 것은 반쪽짜리 작업이다.

STEP 1 — 변경 사항 요약

수정한 파일, 변경한 심볼, 추가/삭제 라인 수를 나열한다.
의도한 변경과 실제 변경이 일치하는지 확인한다.
의도하지 않은 변경이 있으면 즉시 보고한다.

STEP 2 — 자체 검증

신규 이벤트 구독이 있다면 → OnDestroy() / OnDisable()에서 해제 쌍이 존재하는가
async 메서드가 있다면 → CancellationToken이 인자로 전달되는가 (RULE-05)
static 변수를 추가했다면 → [RuntimeInitializeOnLoadMethod]로 초기화하는가
에디터 전용 코드가 있다면 → #if UNITY_EDITOR 또는 Assets/Editor/ 아래에 있는가
물리 API 호출이 FixedUpdate에 있는가 (RULE-04)
RULES.md 전 규칙 위반이 없는가

STEP 3 — Lock 해제

/task-start STEP 4에서 Lock을 획득했다면 반드시 해제한다.
하네스가 없으면 건너뜀.

STEP 4 — worktree 정리

워크트리에서 작업했다면 머지 상태를 확인한다.
아키텍트 리뷰 대기 중이면 워크트리를 그대로 둔다.

STEP 5 — 도메인 지식 승격 (Level 2)

이번 세션에서 이 프로젝트만의 새로운 것을 알게 되었는가?

승격 대상 예시:

기획 의도 ("왜 인벤토리는 슬롯 12개인가")
시스템 간 유기적 관계 ("스킬 쿨다운이 방어력에 영향을 준다")
비즈니스 공식 ("점수 = 기본점수 × 콤보 × 난이도계수")
데이터 흐름 / 이벤트 체인 순서
이 프로젝트 고유 용어

승격 대상이 있으면:

.claude/domain/ 아래 기존 파일이 있는지 확인한다 (예: inventory-system.md).
있으면 해당 파일에 섹션 추가, 없으면 domain/README.md 템플릿으로 새 파일 생성 제안.
파일을 수정했거나 추가했다면 .claude/INDEX.md의 Level 2 섹션에 keywords도 함께 업데이트 — 그래야 다음 세션의 /task-start가 선별 로드 가능.
diff 형식으로 제안하고 아키텍트 승인을 기다린다. 직접 커밋 금지.

승격 대상이 없으면:

이 STEP은 "승격 대상 없음"으로 명시하고 건너뛴다. 억지로 만들지 않는다.

주의: 도메인 지식은 CLAUDE.md에 누적하지 않는다. CLAUDE.md는 프로젝트 개요·구조·컨벤션을 담고, 시스템/기획 단위 지식은 .claude/domain/에 분리한다. 블로그 §3 "나쁜 패턴 2 — 전지전능형" 회피.

STEP 6 — 범용 지식 승격 판단 (/self-update)

다음 조건 중 하나라도 충족되면 /self-update를 호출한다:

어느 Unity/C# 프로젝트에도 적용되는 범용 패턴을 새로 발견했다 → .claude/knowledge/ 승격 후보
기존 지침이 부정확하거나 불완전함을 확인했다
반복될 가능성이 높은 실수를 했다 → RULES.md 또는 .claude/rules/ 후보

/self-update는 계층 판단까지 수행한다. 이 STEP에서는 호출 여부만 결정.

STEP 7 — 완료 보고

작업 결과를 간결하게 보고한다.

출력 형식

[STEP 1] 변경 사항
수정: {파일 → 심볼}, 라인: +N/-N
의도하지 않은 변경: {없음 | 설명}

[STEP 2] 자체 검증
[✓] 이벤트 구독/해제 쌍
[✓] CancellationToken 전달
[✓] static 초기화
[✓] 에디터 가드
[✓] RULES.md 위반 없음

[STEP 3] Lock: {해제 | 하네스 비활성}

[STEP 4] worktree: {상태}

[STEP 5] 도메인 지식 승격
대상: .claude/domain/{system}.md ({신규 | 기존 파일 §X 추가})
요약: {한 문단}
INDEX.md keywords 업데이트: {추가된 keywords}
→ 승인 대기

또는

[STEP 5] 도메인 지식 승격: 승격 대상 없음

[STEP 6] /self-update: {실행 | 불필요} (사유)

[STEP 7] 완료: {한 줄 요약}

금지 사항

도메인 지식을 CLAUDE.md에 섞어 넣지 않는다. .claude/domain/에 분리.
도메인 파일을 만들고 INDEX.md 업데이트를 빠뜨리지 않는다. 인덱스가 빠지면 다음 세션에서 발견되지 않는다.
아키텍트 승인 없이 도메인 파일을 직접 커밋하지 않는다.

Más de este repositorio

mismo repositorio

debug

zaffre001/unity-claude-template

버그 리포트·예외·오작동을 만났을 때 에이전트가 직접 소스코드를 읽고 추적·재현해 원인을 짚는 툴 사용 지침. 사용자에게 "브레이크포인트 걸어 주세요 / 플레이해 보세요"를 시키지 않는다.

2026-05-1317

design

zaffre001/unity-claude-template

기획 내용(자연어 또는 Notion 링크)을 받아 영역별 단계로 분해한 작업 계획 아티팩트를 design/{slug}/ 폴더에 생성합니다. 각 단계는 다음 에이전트가 그대로 실행할 수 있는 독립 프롬프트입니다.

2026-05-1317

lsp-setup

zaffre001/unity-claude-template

Claude Code 의 LSP 툴이 Unity 프로젝트의 `.cs` 를 인식하도록 OmniSharp 를 설치·연결하는 자동 설정 스킬. `No LSP server available for file type: .cs` 응답을 받았거나, 처음 세팅할 때 에이전트가 자동 호출한다.

2026-05-1317

make-asset

zaffre001/unity-claude-template

Unity 어셋(UGUI 프리팹 / 파티클 / 프리미티브 placeholder 모델 / SVG 작성 → Unity Vector Graphics 로 렌더·임포트한 아이콘 스프라이트)을 Claude Bridge 기반으로 제작. 외부 래스터라이저(ImageMagick/rsvg) 불필요. 사용자 요구가 모호하면 샘플 이미지·링크를 요구하고, 어떤 종류(UI/파티클/아이콘/모델)를 만들지 선택지로 제시. 에이전트가 게임 프로토타이핑 중 자산이 부족할 때 자동으로 호출해도 되는 스킬.

2026-05-1317

zaffre001/unity-claude-template

기획·스펙·규칙에 비추어 구현을 평가하는 툴 사용 지침. 사용자에게 "플레이해 보고 문제 있나 말해 달라"를 시키지 않고, 에이전트가 LSP 로 소스를 읽고 Bridge 로 실행해 스스로 합격·불합격을 판정한다.

2026-05-1317

run

zaffre001/unity-claude-template

Unity 플레이어를 빌드하고 실행하거나(`mac|win|linux|webgl|android|ios`), Editor GUI를 띄우거나(`editor`), 큐에 쌓인 ClaudeBridge 커맨드를 헤드리스로 일괄 실행(`bridge`)합니다. 빌드 산출물은 프로젝트 상위 `builds/{label}-{branch}-{shortsha}[-dirty]-{target}-{timestamp}/`에 저장. 인자 없으면 현재 OS로 빌드.

2026-05-1317

name	task-done
description	작업 완료 후 Lock 해제, 정리, 지식 갱신까지 수행하는 마무리 루틴. 세션 중 새로 알게 된 이 프로젝트만의 기획·시스템·유기적 관계를 도메인 지식으로 승격 제안합니다.

Skill: /task-done (Task Completion)

코드 수정이 끝나면 반드시 이 마무리를 수행한다. 코드를 수정하고 세션을 끝내는 것은 반쪽짜리 작업이다.

STEP 1 — 변경 사항 요약

수정한 파일, 변경한 심볼, 추가/삭제 라인 수를 나열한다.
의도한 변경과 실제 변경이 일치하는지 확인한다.
의도하지 않은 변경이 있으면 즉시 보고한다.

STEP 2 — 자체 검증

신규 이벤트 구독이 있다면 → OnDestroy() / OnDisable()에서 해제 쌍이 존재하는가
async 메서드가 있다면 → CancellationToken이 인자로 전달되는가 (RULE-05)
static 변수를 추가했다면 → [RuntimeInitializeOnLoadMethod]로 초기화하는가
에디터 전용 코드가 있다면 → #if UNITY_EDITOR 또는 Assets/Editor/ 아래에 있는가
물리 API 호출이 FixedUpdate에 있는가 (RULE-04)
RULES.md 전 규칙 위반이 없는가

STEP 3 — Lock 해제

/task-start STEP 4에서 Lock을 획득했다면 반드시 해제한다.
하네스가 없으면 건너뜀.

STEP 4 — worktree 정리

워크트리에서 작업했다면 머지 상태를 확인한다.
아키텍트 리뷰 대기 중이면 워크트리를 그대로 둔다.

STEP 5 — 도메인 지식 승격 (Level 2)

이번 세션에서 이 프로젝트만의 새로운 것을 알게 되었는가?

승격 대상 예시:

기획 의도 ("왜 인벤토리는 슬롯 12개인가")
시스템 간 유기적 관계 ("스킬 쿨다운이 방어력에 영향을 준다")
비즈니스 공식 ("점수 = 기본점수 × 콤보 × 난이도계수")
데이터 흐름 / 이벤트 체인 순서
이 프로젝트 고유 용어

승격 대상이 있으면:

.claude/domain/ 아래 기존 파일이 있는지 확인한다 (예: inventory-system.md).
있으면 해당 파일에 섹션 추가, 없으면 domain/README.md 템플릿으로 새 파일 생성 제안.
파일을 수정했거나 추가했다면 .claude/INDEX.md의 Level 2 섹션에 keywords도 함께 업데이트 — 그래야 다음 세션의 /task-start가 선별 로드 가능.
diff 형식으로 제안하고 아키텍트 승인을 기다린다. 직접 커밋 금지.

승격 대상이 없으면:

이 STEP은 "승격 대상 없음"으로 명시하고 건너뛴다. 억지로 만들지 않는다.

주의: 도메인 지식은 CLAUDE.md에 누적하지 않는다. CLAUDE.md는 프로젝트 개요·구조·컨벤션을 담고, 시스템/기획 단위 지식은 .claude/domain/에 분리한다. 블로그 §3 "나쁜 패턴 2 — 전지전능형" 회피.

STEP 6 — 범용 지식 승격 판단 (/self-update)

다음 조건 중 하나라도 충족되면 /self-update를 호출한다:

어느 Unity/C# 프로젝트에도 적용되는 범용 패턴을 새로 발견했다 → .claude/knowledge/ 승격 후보
기존 지침이 부정확하거나 불완전함을 확인했다
반복될 가능성이 높은 실수를 했다 → RULES.md 또는 .claude/rules/ 후보

/self-update는 계층 판단까지 수행한다. 이 STEP에서는 호출 여부만 결정.

STEP 7 — 완료 보고

작업 결과를 간결하게 보고한다.

출력 형식

[STEP 1] 변경 사항
수정: {파일 → 심볼}, 라인: +N/-N
의도하지 않은 변경: {없음 | 설명}

[STEP 2] 자체 검증
[✓] 이벤트 구독/해제 쌍
[✓] CancellationToken 전달
[✓] static 초기화
[✓] 에디터 가드
[✓] RULES.md 위반 없음

[STEP 3] Lock: {해제 | 하네스 비활성}

[STEP 4] worktree: {상태}

[STEP 5] 도메인 지식 승격
대상: .claude/domain/{system}.md ({신규 | 기존 파일 §X 추가})
요약: {한 문단}
INDEX.md keywords 업데이트: {추가된 keywords}
→ 승인 대기

또는

[STEP 5] 도메인 지식 승격: 승격 대상 없음

[STEP 6] /self-update: {실행 | 불필요} (사유)

[STEP 7] 완료: {한 줄 요약}

금지 사항

도메인 지식을 CLAUDE.md에 섞어 넣지 않는다. .claude/domain/에 분리.
도메인 파일을 만들고 INDEX.md 업데이트를 빠뜨리지 않는다. 인덱스가 빠지면 다음 세션에서 발견되지 않는다.
아키텍트 승인 없이 도메인 파일을 직접 커밋하지 않는다.