[P2] [리팩터링 3차] 8081 worktree 준비 스크립트·문서·운영 규칙 정리 #20

New Issue

2026-04-01T09:29:27+09:00

hyunho commented

2026-04-01 09:29:27 +09:00

상위 이슈

연결: #14

배경

현재 prepare_dev_worktree.sh는 worktree 준비뿐 아니라 로컬 디자인 자산 복제 정책까지 직접 알고 있다. 문서도 일부는 과거 브랜치 기준을 설명하고 있어, 운영 규칙과 실제 구조가 완전히 일치하지 않는 부분이 있다.

이번 차수 목표

8081 운영 구조를 문서/스크립트/준비 절차 차원에서 일관되게 정리한다.

작업 범위

prepare_dev_worktree.sh, start_8081.sh, start_local_dashboards.sh 책임 정리
로컬 전용 자산 복제 정책 분리 검토
work-8081, total, backup worktree의 역할 문서화
체크포인트/룰북/실행 흐름 문서와 실제 운영 절차 일치화
회귀 검증 체크리스트 업데이트

제외 범위

신규 기능 추가
디자인 직접 수정
DB 데이터 보정

완료 조건

8081 준비와 기동 절차가 스크립트와 문서에서 같은 기준을 설명할 것
로컬 자산 복제와 worktree 준비 책임이 분명할 것
다음 세션에서 운영 기준을 다시 추적하느라 시간을 쓰지 않아도 될 것

## 상위 이슈 - 연결: `#14` ## 배경 현재 `prepare_dev_worktree.sh`는 worktree 준비뿐 아니라 로컬 디자인 자산 복제 정책까지 직접 알고 있다. 문서도 일부는 과거 브랜치 기준을 설명하고 있어, 운영 규칙과 실제 구조가 완전히 일치하지 않는 부분이 있다. ## 이번 차수 목표 `8081` 운영 구조를 문서/스크립트/준비 절차 차원에서 일관되게 정리한다. ## 작업 범위 - `prepare_dev_worktree.sh`, `start_8081.sh`, `start_local_dashboards.sh` 책임 정리 - 로컬 전용 자산 복제 정책 분리 검토 - `work-8081`, `total`, backup worktree의 역할 문서화 - 체크포인트/룰북/실행 흐름 문서와 실제 운영 절차 일치화 - 회귀 검증 체크리스트 업데이트 ## 제외 범위 - 신규 기능 추가 - 디자인 직접 수정 - DB 데이터 보정 ## 완료 조건 - `8081` 준비와 기동 절차가 스크립트와 문서에서 같은 기준을 설명할 것 - 로컬 자산 복제와 worktree 준비 책임이 분명할 것 - 다음 세션에서 운영 기준을 다시 추적하느라 시간을 쓰지 않아도 될 것

hyunho commented

2026-04-01 14:38:03 +09:00

현재 기준으로 완료 처리 가능.

반영 완료:

prepare_dev_worktree.sh 최신 구조 반영
DEV_PROD_DB_PROTOCOL.md, WORK_RULEBOOK.md, WORK_EXECUTION_FLOW.md, NEXT_SESSION_CHECKPOINT.md 등 운영 문서 정렬
reference / served / app source 기준과 worktree 운영 규칙이 현재 구조와 일치

남은 deeper 구조 개편은 #21 또는 후속 이슈 범위로 보는 것이 맞고, 이 이슈의 목표였던 스크립트/문서/운영 규칙 정리는 달성됨.

현재 기준으로 완료 처리 가능. 반영 완료: - `prepare_dev_worktree.sh` 최신 구조 반영 - `DEV_PROD_DB_PROTOCOL.md`, `WORK_RULEBOOK.md`, `WORK_EXECUTION_FLOW.md`, `NEXT_SESSION_CHECKPOINT.md` 등 운영 문서 정렬 - `reference / served / app source` 기준과 worktree 운영 규칙이 현재 구조와 일치 남은 deeper 구조 개편은 `#21` 또는 후속 이슈 범위로 보는 것이 맞고, 이 이슈의 목표였던 스크립트/문서/운영 규칙 정리는 달성됨.

hyunho closed this issue

2026-04-01 14:38:12 +09:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: hyunho/MH-DashBoard-organization#20