# Task-1058.1: Before Starting 명칭 통일 완료 보고서

**작업일:** 2026-03-26
**팀:** dev8-team (라/Ra)
**GLM 재시도:** 1회 (1차 aborted → 2차 성공)

---

## S - Situation

task-1054.1에서 8개 마케팅 스킬에 "Before Starting" 컨텍스트 참조 섹션을 추가 완료. `/home/jay/.claude/skills/` 디렉토리에 총 84개 SKILL.md 파일이 존재한다.

## C - Complication

기존 스킬 23개의 섹션 헤더 명칭이 비일관적. "## 시작 전 확인"(20개) 또는 "## 시작 전 확인사항"(3개)을 사용 중이었고, 이미 영문 "## Before Starting"을 쓰는 파일 7개와 혼재. 에이전트 파싱 일관성과 유지보수성 저하 문제.

## Q - Question

23개 비일관 헤더를 YAML frontmatter 및 본문 내용 변경 없이 "Before Starting"으로 통일할 수 있는가?

## A - Answer

23개 파일 전수 변환 완료. grep 검증으로 "## 시작 전 확인" 잔존 0건 확인. pytest 7건 전체 통과, pyright 에러 0건, black/isort 준수. 라 팀장이 테스트 파일의 경로 오류 1건 직접 수정.

---

## 변경 파일 목록 (23개)

1. onboarding-cro — `## 시작 전 확인사항` → `## Before Starting`
2. paid-ads — `## 시작 전 확인` → `## Before Starting`
3. analytics-tracking — `## 시작 전 확인` → `## Before Starting`
4. paywall-upgrade-cro — `## 시작 전 확인` → `## Before Starting`
5. cold-email — `## 시작 전 확인` → `## Before Starting`
6. competitor-alternatives — `## 시작 전 확인` → `## Before Starting`
7. copy-editing — `## 시작 전 확인` → `## Before Starting`
8. launch-strategy — `## 시작 전 확인` → `## Before Starting`
9. social-content — `## 시작 전 확인` → `## Before Starting`
10. free-tool-strategy — `## 시작 전 확인` → `## Before Starting`
11. lead-magnets — `## 시작 전 확인사항` → `## Before Starting`
12. popup-cro — `## 시작 전 확인` → `## Before Starting`
13. ad-creative — `## 시작 전 확인` → `## Before Starting`
14. site-architecture — `## 시작 전 확인` → `## Before Starting`
15. form-cro — `## 시작 전 확인사항` → `## Before Starting`
16. churn-prevention — `## 시작 전 확인` → `## Before Starting`
17. referral-program — `## 시작 전 확인` → `## Before Starting`
18. schema-markup — `## 시작 전 확인` → `## Before Starting`
19. ab-test-setup — `## 시작 전 확인` → `## Before Starting`
20. sales-enablement — `## 시작 전 확인` → `## Before Starting`
21. revops — `## 시작 전 확인` → `## Before Starting`
22. ai-seo — `## 시작 전 확인` → `## Before Starting`
23. email-sequence — `## 시작 전 확인` → `## Before Starting`

---

## 발견 이슈 및 해결

### 자체 해결 (3건)

1. **테스트 파일 SKILLS_DIR 경로 오류** — `Path("/home/jay/workspace/skills")` → `Path("/home/jay/.claude/skills")` 수정
   - GLM이 잘못된 경로 지정. 수정 파일: `tests/test_task_1058_1_before_starting.py:11`

2. **GLM 1차 시도 aborted** — 세션 ID 오류(`task-690.1`)로 10분 타임아웃 발생. 2차 시도에서 정상 완료.

3. **기존 테스트 42건 실패 확인** — 본 작업 범위 외 기존 회귀 (dashboard_todo_tabs, done_watcher, group_chat, hermes_audit, integration_modules 등). task-1058.1 변경과 무관.

### 범위 외 미해결 (1건)

1. **churn-prevention, launch-strategy 중복 "## Before Starting" 헤더** — 범위 외 사유: task-1054.1에서 추가한 섹션(line 5)과 기존 "시작 전 확인" 변환 섹션(line 13)이 공존. 본 작업은 "헤더 이름만 통일"이므로 내용 병합은 범위 밖.

---

## 검증 증거

**pytest 결과:**
```
tests/test_task_1058_1_before_starting.py — 7 passed in 0.10s
```

**grep 검증:**
```
"## 시작 전 확인" 잔존: 0건
"## Before Starting" 적용 파일: 30개 (기존 7개 + 변환 23개)
```

**QC 자동 검증 (qc_verify.py):**
```json
{
  "task_id": "task-1058.1",
  "summary": "6 PASS, 1 FAIL(file_check: .done 미생성 시점), 5 SKIP",
  "pyright_check": "PASS (0 errors, 0 warnings)",
  "style_check": "PASS (black: OK, isort: OK)",
  "duplicate_check": "PASS (최대 유사도 6.2%)"
}
```

---

## 산출물

- 변경된 SKILL.md 23개 파일 (`/home/jay/.claude/skills/*/SKILL.md`)
- 스크립트: `/home/jay/workspace/scripts/unify_before_starting.py`
- 테스트: `/home/jay/workspace/tests/test_task_1058_1_before_starting.py`
- 보고서: `/home/jay/workspace/memory/reports/task-1058.1.md`