🦞 21. Archive PARA+Z 리팩터링 실행

이 문서는 “archive가 날짜/주제/산출물/실험 파일이 한 레벨에 섞여 뇌 피로가 커진다”는 문제의식에서 출발한 PARA + Zettelkasten 결합형 리팩터링의 1차 실행 기록입니다.

안내: 본문은 생성형 AI를 활용해 작성·정리했습니다.

flowchart TD
A[문제 인식] --> B[원칙 고정]
B --> C[기능 축 정리]
B --> D[도메인 축 정리]
B --> E[단계 축 정리]
C --> F[실행 준비]
D --> F
E --> F
F --> G[1차 마이그레이션]
G --> H[탐색 피로 감소]

0) 처음 셋팅할 때: “저장이 안 되는” 상황부터 막는 초기 규칙

처음 환경에서는 규칙이 없어서 결과물이 archive로 안 모이거나, 루트에 흩어지기 쉽습니다.
아래 5개를 먼저 고정하면 저장 실패를 거의 막을 수 있습니다.

1. 기본 저장 루트 고정

   • 작업 기본 경로를 <WORKSPACE_ROOT>로 통일
   • 결과물은 기본적으로 archive/projects/<project-slug>/30-output에 저장

2. 프로젝트 슬러그 기본값 지정

   • 프로젝트를 못 정하면 임시로 misc-lab 사용
   • 추후 확정 시 폴더 단위로 이동

3. 단계 기본값 지정

   • 초안은 20-draft, 최종본은 30-output으로 시작
   • 분류가 애매해도 일단 단계부터 맞추고, 나중에 도메인 조정

4. 파일명 최소 규칙 적용

   • 문서: YYYYMMDD_<slug>_vNN.md
   • 산출물: YYYYMMDD_<slug>_<type>_vNN.ext
   • 파일명 규칙이 있어야 자동 분류/검색이 쉬워짐

5. 가드레일 자동화

   • archive/ops/inbox_48h_guard.py를 cron으로 실행해 inbox 적체를 감시
   • 루트 파일 생성은 금지하고, 발견 시 inbox/<date>-root-triage로 즉시 이동

복붙용 초기 규칙 템플릿

[RESULT_STORAGE_DEFAULT]
workspace_root=<WORKSPACE_ROOT>
archive_root=<WORKSPACE_ROOT>/archive
 
default_project=misc-lab
default_stage_draft=20-draft
default_stage_output=30-output
 
document_name=YYYYMMDD_<slug>_vNN.md
artifact_name=YYYYMMDD_<slug>_<type>_vNN.ext
 
forbid_archive_root_files=true
fallback_route=archive/inbox/<date>-root-triage
inbox_guard=48h

flowchart LR
A[결과물 생성] --> B[프로젝트 확인]
B --> C[초안은 20 단계]
B --> D[완성본은 30 단계]
C --> E[inbox 가드]
D --> E
E --> F[주간 재분류]

1) 핵심 설계 원칙

• L1(기능): archive / media_work / memory / skills / 8.quartz
• L2(도메인): content / ops / sales / experiments (프로젝트 성격 기준)
• L3(단계): 00-brief / 10-research / 20-draft / 30-output / 90-retro

핵심 포인트는 하나입니다. 한 폴더 안에 “주제+단계+날짜”를 동시에 섞지 않는다.

2) 표준 구조(권장)

archive/
  inbox/
  projects/
    <project-slug>/
      00-brief/
      10-research/
      20-draft/
      30-output/
      90-retro/
  ops/
  references/
  snapshots/

3) 파일명 규칙

• 문서: YYYYMMDD_<slug>_vNN.md
• 산출물: YYYYMMDD_<slug>_<type>_vNN.ext
• 단계 폴더는 숫자 접두(00/10/20/30/90)로 정렬 고정

4) 운영 규칙

1. archive/inbox 48시간 초과 금지
2. 대용량 렌더 산출물은 archive 금지 → media_work로 이동
3. archive 루트 파일 생성 금지
4. 프로젝트 종료 시 90-retro 1페이지 작성
5. 주 1회 중복/미사용/임시 파일 정리

5) 1차 실행 결과 (2026-02-21)

실행한 것

• archive/inbox, archive/projects, archive/ops, archive/references, archive/snapshots 생성
• 대형 remotion/weekly 테스트 디렉토리 11개를 media_work/renders/archive_migration_260221/로 이동
• 루트 정크 파일(.DS_Store, ._.DS_Store)를 archive/snapshots/system_junk_260221/로 이동

수치 결과

• 이동 건수: 13건
• 이동 용량: 약 1.6GB
• 리스크 통제: manifest + rollback 스크립트 생성

flowchart LR
A[archive root 대형 테스트 디렉토리] --> B[media_work/renders/archive_migration_260221]
C[archive root 정크파일] --> D[archive/snapshots/system_junk_260221]
E[변경이력] --> F[ops/260221_archive_refactor_phase1_manifest.json]
E --> G[ops/260221_archive_refactor_phase1_rollback.sh]

칠판 치트시트

• 실행은 PARA: projects/ops/references/snapshots로 굴린다
• 학습은 Zettelkasten: 재사용 아이디어는 원자 노트 + 링크로 축적한다
• 정리 기본기: “루트 비우기 → 단계 고정 → 롤백 보장”

6) 아키텍트 관점 노하우

• 리팩터링은 “전체 이동”보다 대용량·고잡음 구간부터 제거가 체감이 크다
• 1차는 구조만 안정화, 2차에서 세부 분류/네이밍 자동화를 한다
• 모든 이동 작업은 manifest.json + rollback.sh를 남겨야 운영 신뢰가 생긴다

7) 다음(2차) 실행 제안

1. archive 루트 단일 파일을 inbox/<date>-root-triage/로 일괄 이동
2. 프로젝트별 slug를 확정해 projects/<slug>/00~90 재배치
3. inbox 체류시간(48h) 자동 체크 cron 도입

8) 2차 실행 결과 업데이트 (2026-02-21)

요청대로 바로 2차를 실행해, “규칙”을 실제 폴더 상태로 반영했습니다.

• archive 루트 단일 파일 126건 → inbox/260221-root-triage 수집 후 프로젝트별 재배치
• projects/<slug>/<00·10·20·30·90> 단계 구조로 6개 프로젝트 분류
• archive/ops/inbox_48h_guard.py + cron 등록으로 48시간 초과 자동 감시 적용

핵심 산출물:

• archive/ops/260221_archive_refactor_phase2_manifest.json
• archive/ops/260221_archive_refactor_phase2_rollback.sh
• archive/ops/260221_archive_refactor_phase2_plan.md

flowchart LR
A[archive root 단일 파일] --> B[inbox triage]
B --> C[projects/client-decks]
B --> D[projects/content-studio]
B --> E[projects/flux-writing]
B --> F[projects/openclaw-ops]
B --> G[projects/growth-marketing]
B --> H[projects/misc-lab]
H --> I[inbox 48h guard cron]

9) 운영 자동화 적용(실행 중)

아래 3가지는 실제 운영에 이미 붙여서 사용 중입니다.

1. 출력 강제 라우터

• archive/ops/result_router.py
• archive/ops/save_result.sh
• 목적: 결과물을 항상 archive/projects/<slug>/<stage>로 저장

2. 발행 전 문법 게이트

• archive/ops/quartz_preflight_gate.py
• 목적: OpenClaw 문서의 wikilink/mermaid 사전 점검

3. 주간 misc-lab 리팩터링 루프

• archive/ops/misc_lab_weekly_triage.py
• cron: 매주 월요일 08:20
• 목적: misc-lab에 쌓인 파일의 재분류 후보 자동 리포트 생성

flowchart LR
A[결과물 생성] --> B[result_router]
B --> C[projects/(slug)/(stage)]
C --> D[quartz_preflight_gate]
D --> E[게시/공유]
E --> F[misc_lab_weekly_triage]

관련 문서

• OpenClaw 20: 운영 아키텍처·규칙 (쉽게 이해하기)
• OpenClaw 인덱스