type, tags, last_updated
| type |
tags |
last_updated |
| workflow |
| infra |
| workflow |
| shared-editing |
| nas |
| drafts |
| collaboration |
|
2026-03-23 |
공유편집 드래프트 협업 워크플로우
상위 원칙
정의
/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. 기존 파일 수정
- 기존 파일을 수정할 때만 아래 순서를 지킵니다.
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회 다시 읽어 오탈자와 경로 오류를 점검합니다.
- "완료" 보고는 실제 파일 생성 또는 수정 결과를 확인한 뒤에만 합니다.
