# Skill 문서 확장 구현 계획
> **에이전트 작업자용:** REQUIRED SUB-SKILL: 현재 세션에서는 인라인으로 실행한다. Steps use checkbox (`- [ ]`) syntax for tracking.
**Goal:** 10개 스킬 문서를 원문에 더 가깝게 확장하고, README와 TRAE 테스트 시나리오 문서를 추가한다.
**Architecture:** 기존 `.trae/skills/*/SKILL.md`를 스킬 성격별로 확장하고, 저장소 루트에는 탐색용 README를, `docs/`에는 실행 가능한 테스트 시나리오 문서를 둔다. 검증은 Markdown 진단과 문서 간 링크/명칭 일관성 확인으로 마무리한다.
**Tech Stack:** Markdown, Trae skill frontmatter, VS Code diagnostics
---

### Task 1: 프로세스 스킬 문서 확장
**Files:**
- Modify: `.trae/skills/brainstorming/SKILL.md`
- Modify: `.trae/skills/systematic-debugging/SKILL.md`
- Modify: `.trae/skills/writing-plans/SKILL.md`
- Modify: `.trae/skills/using-superpowers/SKILL.md`
- Modify: `.trae/skills/karpathy-guidelines/SKILL.md`
- Test: 문서 진단 확인

- [ ] **Step 1: 현재 프로세스 스킬 문서를 다시 읽어 섹션 공통 틀을 고정**
Read:
```text
.trae/skills/brainstorming/SKILL.md
.trae/skills/systematic-debugging/SKILL.md
.trae/skills/writing-plans/SKILL.md
.trae/skills/using-superpowers/SKILL.md
.trae/skills/karpathy-guidelines/SKILL.md
```
Expected: 각 문서에 공통으로 들어갈 섹션(개요, 적용 시점, 워크플로, 금지 사항, 기대 결과)을 정할 수 있다.

- [ ] **Step 2: brainstorming 문서를 원문 흐름에 가깝게 확장**
Include:
```markdown
## 체크리스트
## 프로세스 흐름
## 설계 제시 규칙
## 문서화와 사용자 검토 게이트
## 시각 보조 도구 사용 기준
```
Expected: 설계 전 구현 금지, 한 번에 한 질문, 2~3개 접근법 제안, writing-plans로 전환 규칙이 모두 드러난다.

- [ ] **Step 3: systematic-debugging 문서를 4단계 절차 중심으로 확장**
Include:
```markdown
## 철칙
## 1단계: 근본 원인 조사
## 2단계: 패턴 분석
## 3단계: 가설과 검증
## 4단계: 구현
## 중단 신호
```
Expected: 수정 전에 조사, 증거 기반 추적, 최소 변경 검증, 3회 이상 실패 시 구조 재검토가 명확해진다.

- [ ] **Step 4: writing-plans 문서를 계획 품질 기준 중심으로 확장**
Include:
```markdown
## 파일 구조 먼저 정의
## 작업 단위 규칙
## 계획 문서 헤더
## 금지 사항
## 자체 검토
## 완료 후 인계
```
Expected: placeholder 금지, 작은 단계, 명확한 파일 경로, 검증 가능한 명령이 강조된다.

- [ ] **Step 5: using-superpowers와 karpathy-guidelines를 운영 규칙 중심으로 확장**
Include:
```markdown
## 최우선 규칙
## 스킬 우선 적용 순서
## 흔한 자기합리화 경고
## 코딩 전에 먼저 생각하기
## 단순함 우선
## 수술하듯 수정하기
## 목표 기반 실행
```
Expected: 스킬 선적용 원칙과 과설계 방지 원칙이 각각 독립적으로 읽혀야 한다.

- [ ] **Step 6: 진단 확인**
Run: Markdown diagnostics for the five edited files
Expected: 진단 오류 없음

### Task 2: UI/구현/탐색 스킬 문서 확장
**Files:**
- Modify: `.trae/skills/frontend-design/SKILL.md`
- Modify: `.trae/skills/ui-ux-pro-max/SKILL.md`
- Modify: `.trae/skills/find-skills/SKILL.md`
- Modify: `.trae/skills/webapp-testing/SKILL.md`
- Modify: `.trae/skills/agent-browser/SKILL.md`
- Test: 문서 진단 확인

- [ ] **Step 1: 현재 다섯 문서를 다시 읽고 성격별 확장 포인트 정리**
Read:
```text
.trae/skills/frontend-design/SKILL.md
.trae/skills/ui-ux-pro-max/SKILL.md
.trae/skills/find-skills/SKILL.md
.trae/skills/webapp-testing/SKILL.md
.trae/skills/agent-browser/SKILL.md
```
Expected: 디자인형, 탐색형, 테스트형, 자동화형 문서에 필요한 추가 섹션이 정리된다.

- [ ] **Step 2: frontend-design 문서를 미학 방향성과 금지 패턴 중심으로 확장**
Include:
```markdown
## 디자인 사고
## 미학 가이드라인
## 반드시 피할 것
## 구현 복잡도와 미학의 일치
## 산출물 기대치
```
Expected: 흔한 AI 스타일 회피, 타이포그래피/색상/모션/공간 구성 원칙이 상세해진다.

- [ ] **Step 3: ui-ux-pro-max 문서를 적용 조건과 우선순위 점검 기준 중심으로 확장**
Include:
```markdown
## 언제 적용할지
## 반드시 사용할 상황
## 권장 상황
## 불필요한 상황
## 우선순위별 검토 항목
## 산출물 기준
```
Expected: 웹/모바일 UI 품질 관리용 종합 규칙처럼 읽힌다.

- [ ] **Step 4: find-skills, webapp-testing, agent-browser 문서를 실행 절차 중심으로 확장**
Include:
```markdown
## 검색 절차
## 품질 검증
## 정찰 후 행동 패턴
## with_server.py 사용 원칙
## agent-browser skills get core
## 특수 가이드
```
Expected: 사용자가 바로 명령과 판단 기준을 가져다 쓸 수 있다.

- [ ] **Step 5: 진단 확인**
Run: Markdown diagnostics for the five edited files
Expected: 진단 오류 없음

### Task 3: README와 테스트 시나리오 문서 작성
**Files:**
- Create: `README.md`
- Create: `docs/test-scenarios.md`
- Test: 문서 진단 확인

- [ ] **Step 1: README 초안 작성**
Include:
```markdown
# skillDesk
## 프로젝트 소개
## 포함된 스킬
## 디렉터리 구조
## TRAE에서 사용하는 방법
## 추천 사용 흐름
## 테스트 시나리오
```
Expected: 저장소 목적, 10개 스킬, 사용 흐름을 처음 보는 사람도 이해할 수 있다.

- [ ] **Step 2: 테스트 시나리오 문서 작성**
Include:
```markdown
# TRAE 테스트 시나리오
## 공통 사용법
## brainstorming 시나리오
## frontend-design 시나리오
## ...
## agent-browser 시나리오
```
Expected: 각 스킬당 최소 1개 프롬프트, 기대 동작, 확인 포인트가 담긴다.

- [ ] **Step 3: README와 테스트 문서 간 링크 연결**
Add:
```markdown
[테스트 시나리오](./docs/test-scenarios.md)
[brainstorming](./.trae/skills/brainstorming/SKILL.md)
```
Expected: README에서 주요 문서로 빠르게 이동할 수 있다.

- [ ] **Step 4: 진단 확인**
Run: Markdown diagnostics for `README.md` and `docs/test-scenarios.md`
Expected: 진단 오류 없음

### Task 4: 최종 검증과 정리
**Files:**
- Modify: 전체 문서 일관성 점검 결과에 따라 필요한 파일
- Test: 전체 신규/수정 Markdown 파일 진단 확인

- [ ] **Step 1: 문서 명칭과 링크 일관성 점검**
Check:
```text
README.md
docs/test-scenarios.md
.trae/skills/*/SKILL.md
```
Expected: 스킬 이름, 링크 경로, 설명 용어가 서로 충돌하지 않는다.

- [ ] **Step 2: Markdown 진단 일괄 확인**
Run: diagnostics for all touched markdown files
Expected: 진단 오류 없음

- [ ] **Step 3: 결과 요약 작성**
Include:
```text
확장한 스킬 목록
추가한 문서 목록
검증 결과
```
Expected: 사용자가 바로 산출물을 훑어볼 수 있다.