---
type: workflow
tags: [infra, workflow, shared-editing, nas, drafts, collaboration]
last_updated: 2026-03-23
---

# 공유편집 드래프트 협업 워크플로우

## 상위 원칙
- [../../../0_VALUE/README.md](../../../0_VALUE/README.md)
- [../../../0_VALUE/20_Governance/project-artifacts-ssot.md](../../../0_VALUE/20_Governance/project-artifacts-ssot.md)
- [../../../0_VALUE/20_Governance/infrastructure-ssot-principle.md](../../../0_VALUE/20_Governance/infrastructure-ssot-principle.md)
- `/mnt/nas/workspace/shared-editing/README.md`

## 정의

- `/mnt/nas/workspace/shared-editing/`는 23·24 서버 에이전트가 git push/pull 없이 초안, 질의, 리뷰를 교환하는 NAS 협업 공간입니다.
- `drafts/`는 자유 작성·토의·임시 메모의 단일 위치입니다.
- 확정본은 각 git 레포로 이관한 뒤 `archive/`로 옮깁니다.

## 적용 기준

- 파일명은 서버 접두를 붙여 작성합니다. 예: `[23]_주제.md`, `[24]_주제.md`.
- 상대 서버 초안은 같은 `drafts/`에서 직접 읽고, 내 답글은 새 파일로 작성합니다.
- 같은 파일을 수정할 때만 `scripts/lock.sh`로 잠금합니다. 새 파일 작성은 잠금 없이 시작할 수 있지만, 기존 파일 수정이면 잠금이 필수입니다.
- `/mnt/nas/workspace/shared-editing/`에는 일반 셸 리다이렉션(`>`) 쓰기 실패 가능성이 있으므로 `lock.sh`, `sudo tee`, 또는 그와 동등한 안전한 쓰기 절차를 사용합니다.
- watch/감시 루프는 `감지`로 끝내지 않습니다. `watch 실행 -> 감지 -> drafts 결과 보고 작성`까지 한 작업 단위로 완료합니다.
- 24 서버 Codex는 대기 감시가 필요할 때 `/home/admin/scripts/watch_and_report.sh`를 우선 사용합니다.

## 표준 흐름

### 1. 드래프트 식별

- 먼저 `drafts/`에서 주제 파일을 찾고, 작성자·날짜·요청 대상을 읽습니다.
- "드래프트가 무엇인가"라는 질문에는 `shared-editing/README.md` 기준으로 "`drafts/`는 자유 작성·토의·임시 메모 공간"이라고 답합니다.

### 2. 서버 식별

- 현재 셸이 어느 서버인지 추정하지 않습니다.
- 답글에 서버 정체성을 적기 전 `hostname`으로 확인합니다.
- 24 서버라고 말할 때는 `hostname` 또는 infra SSOT로 교차 확인된 근거가 있어야 합니다.

### 3. 초안 작성

- 기존 파일에 덧붙이지 말고 새 답글 파일을 만듭니다.
- 권장 파일명: `[24]_YYMMDD_주제_24codex.md`, `[23]_YYMMDD_주제_23claude.md`
- 본문에는 최소한 다음을 분리해 씁니다.
  - 확인한 사실
  - 의견 또는 판단
  - 필요한 후속 액션

### 4. 기존 파일 수정

- 기존 파일을 수정할 때만 아래 순서를 지킵니다.

```bash
cd /mnt/nas/workspace/shared-editing
./scripts/lock.sh drafts/topic.md 24
# 안전한 편집 수행
./scripts/lock.sh drafts/topic.md 24 unlock
```

- 잠금이 실패하면 상대 서버가 편집 중인 것이므로 새 답글 파일로 회신하고, 원본 덮어쓰기를 시도하지 않습니다.

### 5. 결과 보고

- 답글을 쓴 뒤 파일 경로와 핵심 결론을 상대가 바로 읽을 수 있게 남깁니다.
- 합의가 끝난 문서만 각 git 레포로 이관합니다.
- 이관 후 원본 초안은 `archive/`로 옮깁니다.

## 검증 기준

- `drafts/`에 새 파일이 실제로 생성되었는지 확인합니다.
- 파일명 접두가 서버 기준과 맞는지 확인합니다.
- 링크, 경로, 명령 예시는 최소 1회 다시 읽어 오탈자와 경로 오류를 점검합니다.
- "완료" 보고는 실제 파일 생성 또는 수정 결과를 확인한 뒤에만 합니다.