| name | project-close |
| description | 프로젝트(PRJ-*) 종료 후 PROGRESS 최종화 + 허브 frontmatter 정합 + CLAUDE.md 참조 갱신 + 에이전트 메모리 갱신을 한 번에 완료한다 |
| argument-hint | [프로젝트ID] |
| created | "2026-06-11T00:00:00.000Z" |
| status | live |
project-close
프로젝트를 닫을 때의 6단계 마무리를 한 번에 완료한다. 닫기 = 프로젝트를 done/archived로 확정하고 볼트 전체 참조를 정합화.
- 프로젝트 폴더 감사 — 완료 조건 충족 여부 확인 (미완이면 중단)
- PROGRESS.md 최종화 — 완료 마일스톤 확정 + 종료 로그
- 허브 frontmatter 정합 —
project_status + status 동시 갱신
- MOC-프로젝트 반영 — frontmatter 갱신으로 자동 처리 (수동 편집 불필요)
- CLAUDE.md 점검 — Active Project 참조 갱신/제거
- 에이전트 메모리 갱신 — active-context, change-log
전제 조건: 프로젝트 폴더가 03_projects/PRJ-{이름}/ 구조이고, 허브 파일(PRJ-{이름}.md)이 존재할 것.
입력
- 프로젝트 ID:
PRJ-이름 형식 (예: PRJ-볼트v3, PRJ-메모리OS)
- 종료 유형 (선택):
done(완수) 또는 archived(중단·대체). 기본값 done.
절차
1. 프로젝트 폴더 감사
03_projects/PRJ-{이름}/ 전체 스캔:
find "03_projects/PRJ-{이름}" -name "*.md" | head -30
완료 조건 확인 — 아래 중 하나라도 미충족이면 닫기를 중단하고 사용자에게 알린다:
| 항목 | 기준 |
|---|
| PROGRESS.md 전체 완료 | 모든 작업 항목이 done 상태 (미완 todo/in-progress 없음) |
| PLAN.md 미결 사항 | ## 미결 사항 섹션이 비어 있거나 존재하지 않음 |
| 허브 파일 존재 | PRJ-{이름}.md 파일 확인 |
미완 작업이 남아 있다면:
⛔ 닫기 중단 — 미완 작업 {N}개 발견
- {작업 목록}
미완 작업을 먼저 완료하거나, 의도적 중단이면 종료 유형 'archived'를 명시하세요.
단, 종료 유형이 archived(중단·대체)인 경우는 미완 작업이 있어도 진행한다.
2. PROGRESS.md 최종화
03_projects/PRJ-{이름}/PROGRESS.md 갱신:
확인·추가 항목:
## 완료 마일스톤 섹션: 주요 달성 사항 목록이 완성되어 있는지 확인. 누락된 항목이 있으면 추가.## 작업 로그 마지막 항목에 종료 기록 append:
### {YYYY-MM-DD} — 프로젝트 종료
- 종료 유형: {done | archived}
- 종료 사유: {간략한 사유 — 완수 / 대체 프로젝트 출범 / 방향 전환 등}
- 최종 상태: 전체 Phase {N}개 완료 / 미완 {N}개 (archived 시)
3. 허브 frontmatter 정합
03_projects/PRJ-{이름}/PRJ-{이름}.md의 frontmatter 갱신:
두 필드의 의미 차이:
project_status: 프로젝트 생애주기 상태 — active / done / paused / archived. MOC-프로젝트와 projects.base 상태별 뷰가 이 필드로 분류한다.status: 문서 상태 — draft / live / archived. 닫기 시 archived로 변경해 문서를 동결한다.
project_status: done
status: archived
updated: {오늘 날짜}
status: archived는 세션 허브와 다른 점이다. 세션 허브(session_status: done)는 status: live를 유지하지만, 프로젝트 허브는 종료 후 문서를 동결하는 것이 원칙이다.
4. MOC-프로젝트 반영
_system/obsidian/mocs/MOC-프로젝트.md를 수동으로 편집하지 않아도 된다.
projects.base는 project_status 필드로 groupBy하는 상태별 뷰(![[projects.base#상태별]])를 갖고 있다. Step 3에서 frontmatter를 정확히 갱신하면 Obsidian이 자동으로 해당 프로젝트를 done 또는 archived 그룹에 배치한다.
확인만 권장: MOC-프로젝트.md에 해당 프로젝트가 섹션별로 수동 목록화된 경우, 섹션 이동이 필요할 수 있다. 확인 후 필요하면 갱신.
5. CLAUDE.md 점검 ← 핵심 정합 단계
닫는 프로젝트가 CLAUDE.md에서 활성 참조되고 있으면 반드시 갱신한다. 참조를 남겨두면 에이전트가 종료된 프로젝트를 계속 활성으로 인식한다.
체크 항목:
예시 (PRJ-볼트v3): CLAUDE.md의 ## Active Project: PRJ-볼트v3 전체 섹션과 에이전트 시작 프로토콜의 두 파일 읽기 지시를 제거한다.
6. 에이전트 메모리 갱신
active-context.md 갱신 (덮어쓰기):
현재 활성 프로젝트 목록에서 해당 프로젝트 제거- 관련 진행 중 작업 항목 정리
change-log.md append:
### {YYYY-MM-DD}
- PRJ-{이름} 프로젝트 종료 ({done | archived}) — "{프로젝트 제목}"
- 종료 사유: {간략 사유}
- PROGRESS.md 최종화 완료
- 허브 project_status: {done|archived}, status: archived
- CLAUDE.md Active Project 참조 제거
클럽 타임라인 갱신 (선택):
프로젝트가 클럽 역사에 기록할 만한 마일스톤이면 01_ops/strategy/260314-클럽타임라인.md에 추가:
- {YYYY-MM-DD}: PRJ-{이름} "{제목}" 완료 — {1줄 성과 요약}
완료 보고
✅ project-close 완료 — PRJ-{이름}
📋 폴더 감사
완료 작업: {N}개 / 전체 {N}개
✓ PLAN.md 미결 사항: 없음
📄 갱신된 파일
✓ PROGRESS.md: 종료 로그 추가
✓ 허브 frontmatter: project_status={done|archived}, status=archived
✓ CLAUDE.md: Active Project 섹션 제거/갱신
✓ active-context.md
✓ change-log.md
💡 선택 후속 작업:
- 클럽 타임라인 기록 (마일스톤인 경우)
- 관련 에이전트 메모리 심화 갱신 (/memory-update)
주의사항
- 미완 작업이 있고 종료 유형이
done이면 실행을 중단한다. archived로 명시하거나 작업을 먼저 완료할 것.
status: archived는 문서 동결을 의미한다 — 이후 해당 허브 파일을 편집하지 않는 것을 원칙으로 한다.- CLAUDE.md 참조 제거는 반드시 수행한다. 누락 시 에이전트가 종료 프로젝트를 계속 활성으로 읽는다.
- active-context.md는 덮어쓰기 — 기존 내용을 읽고 업데이트하여 최신 상태로 유지.
연관 스킬
| 스킬 | 관계 |
|---|
/progress-update | 전제 권장 — 닫기 전 PROGRESS.md 최신화 |
/vault-health | 병행 선택 — 닫기 후 전체 볼트 정합성 점검 |
/memory-update | 이후 선택 — 심화 메모리 갱신 |
/session-close {세션ID} | 유사 구조 — 세션 닫기 참조 |
프로젝트 종료 권장 순서
/progress-update {프로젝트ID} → PROGRESS.md 최신화 확인
/project-close {프로젝트ID} → 폴더 감사 + 허브 정합 + CLAUDE.md 갱신 ← 이 스킬
/memory-update → 심화 메모리 갱신 (선택)
