| name | update-governance |
| description | CLAUDE.md 스킬 테이블, 클럽타임라인, 라우팅 목적지가 불명확한 경우의 거버넌스 파일 갱신 (특수). routine한 세션 결과 기록은 memory-update를 사용한다. "스킬 추가했어", "시스템 바꿨어", "이 결정 어디 써야 해" 등 라우팅 판단이 필요할 때 사용. |
Update Governance
워크스페이스 거버넌스 파일의 변경사항을 올바른 위치로 라우팅·기록하는 메타 스킬.
memory-update 스킬과의 분업:
memory-update — 세션 작업 결과를 메모리에 반영하는 일반 절차update-governance — "이 변경을 어디에 써야 하나"가 불명확할 때 라우팅 판단 + 최소 diff 기록
라우팅 매트릭스
| 변경 유형 | 목적지 | 방식 |
|---|
| 현재 클럽 상태 변화 (세션 완료, 프로젝트 착수 등) | _system/agents/memory/active-context.md | 덮어쓰기 |
| 파일·시스템·스킬 변경 이력 | _system/agents/memory/change-log.md | append |
| 대안 비교 후 구조적 결정 | _system/agents/memory/decisions/YYMMDD-결정제목.md | 신규 파일 |
| 클럽 역사에 남길 마일스톤 | 01_ops/strategy/클럽타임라인.md | append |
| 스킬·에이전트 추가/변경 | CLAUDE.md 스킬/에이전트 테이블 | 행 추가·수정 |
| 볼트 전체 규칙 변경 | CLAUDE.md 또는 _system/rules.md | 섹션 내 수정 |
Workflow
Step 1: 변경사항 분류
입력 또는 세션 맥락에서 변경의 종류와 영구성을 판단한다:
- 일회성 작업 완료? → change-log.md append만
- 클럽 운영 상태 바뀜? → active-context.md 덮어쓰기
- 되돌리기 어려운 구조 결정? → decisions/ 신규 파일
- 역사적 이벤트 (첫 세션, 시즌 전환 등)? → 클럽타임라인.md append
- 스킬/에이전트 추가·삭제? → CLAUDE.md 테이블 갱신
Step 2: 목적지 제시 (확인 요청)
사용자에게 라우팅 결과를 한 줄씩 제시:
이 변경을 다음 위치에 기록합니다:
1. _system/agents/memory/active-context.md — [내용 한 줄]
2. _system/agents/memory/decisions/YYMMDD-결정제목.md — [결정 요약]
진행? (y / 수정)
Step 3: 목적지 파일 업데이트
각 목적지에 Edit/Write 적용. 수정 전 해당 파일을 읽어 중복·충돌 확인.
active-context.md (덮어쓰기):
# 현재 상태 (YYYY-MM-DD 갱신)
## 클럽 현황
[한 줄]
## 진행 중인 작업
- [ ] 작업명 (담당, 마감)
## 우선순위
1.
## 블로커
(없으면 생략)
## 다음 세션
[1~2줄]
change-log.md (append):
## YYYY-MM-DD
- [변경 내용 — 파일 경로 포함]
- 이유: [한 줄]
decisions/YYMMDD-결정제목.md (신규):
---
title: 결정 제목
status: live
created: YYYY-MM-DD
---
## 결정
[한 문장]
## 맥락
[왜 이 결정을 했는가]
## 대안
[고려했지만 선택하지 않은 것과 이유]
## 후속 조치
[이 결정으로 해야 할 일]
클럽타임라인.md (append):
| YYYY-MM-DD | [이벤트] | [의미·맥락] |
CLAUDE.md 스킬 테이블 (행 추가):
| `스킬명` | 설명 |
Step 4: 완료 확인
갱신된 파일 목록과 변경 요약을 출력한다.
중복 방지 원칙
- 같은 사실을 여러 파일에 복제하지 않는다
- 결정 상세 → decisions/ 파일만. change-log는 파일명 참조만
- 클럽 현황 상세 → active-context.md만. change-log는 이벤트만
- 수정 전 반드시 해당 파일을 읽어 동일 내용이 이미 있는지 확인
- 사용자가 파일을 직접 지정했으면 그 판단 우선
주의사항
memory-update가 이미 처리한 내용은 중복 갱신하지 않는다- decisions/ 파일은 대안 비교가 있는 구조적 결정만. 일상적 변경은 change-log로 충분
- 클럽타임라인.md는 클럽 연혁에 남을 이벤트만 (세션 완료, 시즌 전환, 주요 결정 등)
