deepseek.md - DeepSeek 최적화 개발 워크플로우
목적
이 문서는 DeepSeek이 서버 CLI 환경에서 개발 작업을 할 때 컨텍스트 붕괴를 최소화하고, 안정적이고 복구 가능한 개발을 하기 위한 최적화된 워크플로우를 정의합니다.
핵심 철학
"기억하지 말고, 기록하라. 추측하지 말고, 확인하라. 한 번에 많이 하지 말고, 작게 반복하라."
작업 전 필수 준비물
매 작업 세션 시작 전, 아래 3가지를 반드시 확인합니다.
# 1. 현재 작업 디렉토리 확인
pwd
# /home/cafe/web/blog.maocafe.com/public_html
# 2. 관련 문서 최신 상태 확인
ls -la codex/
# 3. 현재 활성 테마 확인 (필요시)
# themes/ 폴더에서 어떤 테마가 활성화되어 있는지 config.php나 DB에서 확인
7단계 최적화 워크플로우
단계 0: 세션 시작 (2분)
목표: "지금부터 무엇을 할 것인가"를 명확히 정의
markdown
## [세션 시작] YYYY-MM-DD HH:MM
### 오늘의 목표:
[한 문장으로 압축]
### 작업 유형:
[ ] 신규 개발
[ ] 버그 수정
[ ] 기능 개선
[ ] 보안 패치
[ ] 문서화
### 예상 영향 범위:
[파일 또는 폴더 목록]
### 성공 기준:
[테스트로 확인할 수 있는 구체적 조건]
단계 1: 구조 스냅샷 (3-5분)
목표: 관련된 모든 파일과 의존성을 파악
bash
# 관련 파일 찾기 - 3가지 방법 중 선택
# 1. 파일명으로 검색
find . -name "*keyword*" -type f
# 2. 내용으로 검색
grep -r "function_name" --include="*.php" .
# 3. API 엔드포인트 추적
grep -r "api/endpoint" --include="*.php" .
기록할 내용:
markdown
## 구조 스냅샷
### 진입점:
- `파일명.php` - [역할]
### 데이터 흐름:
1. `파일A` → `파일B` 호출
2. `파일B` → `DB` 쿼리
3. 결과 → `파일C`에서 출력
### 의존성:
- DB 테이블: [테이블명]
- 설정 파일: `config.php`의 [설정명]
- 외부 API: [있으면 적기]
### 위험 지점:
- [ ] 세션/권한 확인 필요
- [ ] 캐시 영향 가능
- [ ] 다른 테마와 공유 코드
단계 2: 계획 수립 (2분)
목표: 구체적인 수정 대상과 방법을 결정
markdown
## 작업 계획
### 수정할 파일: (최대 3개로 제한)
1. `path/to/file1.php` - [수정 내용]
2. `path/to/file2.php` - [수정 내용]
3. `path/to/file3.php` - [수정 내용]
### 백업 계획:
- [ ] 파일별 백업: `filename.ext.1`
- [ ] 폴더 백업: `folder_backup_YYYYMMDD/`
### 테스트 계획:
1. [ ] [테스트 항목 1]
2. [ ] [테스트 항목 2]
3. [ ] [테스트 항목 3]
### 롤백 조건:
- [ ] 홈페이지 로딩 실패
- [ ] 관리자 접근 불가
- [ ] 핵심 기능 중단
단계 3: 백업 실행 (1분)
목표: 언제든 원상복구 가능한 상태 보장
bash
# 단일 파일 백업
cp path/to/file.php path/to/file.php.1
# 여러 파일 백업
for f in file1.php file2.php file3.php; do
cp $f $f.1
done
# 폴더 전체 백업
tar -czf backup_$(date +%Y%m%d_%H%M).tar.gz themes/current_theme/
백업 확인:
bash
ls -la path/to/*.1 # 백업 파일 존재 확인
단계 4: 집중 실행 (최대 15분)
목표: 최소 변경으로 목표 달성
실행 규칙:
한 번에 한 파일만 수정
수정 후 즉시 저장
저장 후 즉시 테스트 (단계 5)
문제 없으면 다음 파일로 이동
수정 중 기록:
markdown
## 실행 로그
### 파일1 수정: `file1.php` - HH:MM
- 변경 내용: [구체적으로]
- 변경 이유: [왜 이렇게 했는지]
### 파일2 수정: `file2.php` - HH:MM
- 변경 내용: [구체적으로]
- 변경 이유: [왜 이렇게 했는지]
단계 5: 즉시 테스트 (2분)
목표: 변경이 의도대로 동작하는지 확인
테스트 체크리스트:
bash
# 1. 기본 로딩 테스트
curl -s -o /dev/null -w "%{http_code}\n" https://your-site.com/
# 200이 아니면 즉시 롤백
# 2. 관련 페이지 테스트
curl -s -o /dev/null -w "%{http_code}\n" https://your-site.com/related-page/
# 3. API 테스트 (해당 시)
curl -X GET "https://your-site.com/api/endpoint" -H "Authorization: Bearer TOKEN"
# 4. PHP 오류 확인
tail -20 /path/to/php-error.log
브라우저 테스트 (수동):
페이지 정상 로딩
관련 버튼/링크 동작
콘솔 에러 없음
모바일 레이아웃 정상
단계 6: 문제 발생 시 롤백 (즉시)
목표: 손상된 상태를 빠르게 복구
bash
# 단일 파일 롤백
cp path/to/file.php.1 path/to/file.php
# 전체 롤백
tar -xzf backup_YYYYMMDD_HHMM.tar.gz -C ./
롤백 후 할 일:
복구 확인 (테스트 재실행)
문제 원인 분석 기록
더 작은 단위로 계획 수정
단계 2부터 다시 시작
단계 7: 세션 종료 (3분)
목표: 모든 상태를 기록하고 다음 작업자가 이어갈 수 있게 함
markdown
## [세션 종료] YYYY-MM-DD HH:MM
### 수행한 작업:
1. `file1.php` - [변경 내용]
2. `file2.php` - [변경 내용]
### 백업 파일:
- `file1.php.1`
- `file2.php.1`
- `backup_YYYYMMDD_HHMM.tar.gz`
### 테스트 결과:
- [ ] 홈페이지 로딩: 정상
- [ ] 관련 기능: 정상
- [ ] 에러 로그: 이상 없음
- [ ] 모바일: 정상
### 남은 위험:
- [위험 항목이 있으면 명시]
### 다음 작업자 확인 사항:
1. [확인 필요한 항목]
2. [추가 검토 필요 항목]
### 최종 상태:
- [ ] 작업 완료
- [ ] 추가 작업 필요
- [ ] 보류/재검토 필요
긴급 상황 대응 프로토콜
상황 1: "아까 무슨 파일을 수정했더라?"
bash
# 최근 수정 파일 확인
find . -name "*.php" -mmin -30 -type f
# 또는
ls -lt *.php | head -5
상황 2: "왜 이렇게 수정했더라?"
bash
# 수정 파일의 변경 이력 확인
diff file.php file.php.1
# 또는 git 로그 (사용 중인 경우)
git log -p -- file.php
상황 3: "이게 원래 동작이 맞나?"
bash
# 원본 파일과 비교
diff file.php file.php.1
# 이전 버전으로 임시 교체 후 테스트
cp file.php.1 file.php.test
# 테스트 후 복원
DeepSeek 전용 명령어 치트시트
목적 명령어
관련 파일 빠르게 찾기 find . -name "*keyword*" -type f | grep -v backup
함수 호출 추적 grep -r "functionName" --include="*.php" .
최근 수정 파일 find . -name "*.php" -mmin -60 -type f
백업 생성 cp file.php file.php.$(date +%Y%m%d_%H%M)
롤백 cp file.php.1 file.php
PHP 오류 확인 tail -f /var/log/php_errors.log
API 응답 확인 curl -s https://site.com/api/endpoint | jq .
매일 아침 체크리스트
markdown
## [일일 시작] YYYY-MM-DD
### 어제까지의 상태:
- [ ] `handoff.md` 확인
- [ ] `todolist.md` 확인
- [ ] 관련 브랜치/버전 확인
### 오늘의 계획:
1. [오늘 할 작업 1]
2. [오늘 할 작업 2]
### 주의사항:
- [ ] 특이사항 1
- [ ] 특이사항 2
핵심 규칙 요약
규칙 이유
한 번에 3개 파일 이하 수정 영향 범위 통제
수정 전 항상 백업 즉시 롤백 가능
테스트 없이 완료 금지 확인되지 않은 변경은 위험
문제 발생 시 즉시 롤백 수정보다 복구가 빠름
모든 상태 기록 컨텍스트 유지
작업 세션 시작/종료 기록 다음 작업자 배려
이 문서의 사용법
처음 작업할 때: 이 문서를 codex/deepseek.md로 저장
매 작업 세션 시작: 단계 0부터 시작
혼란스러울 때: 이 문서로 돌아와서 현재 단계 확인
문제 발생 시: 단계 6 (롤백) 즉시 실행
작업 종료: 단계 7 (세션 종료) 반드시 실행
"이 문서가 당신의 두뇌를 대신하지 않습니다. 하지만 당신의 두뇌가 기억해야 할 것을 줄여줍니다."
text
---
이제 이 내용을 `codex/deepseek.md` 파일로 저장하시면 됩니다.
서버에서 아래 명령어로 직접 생성할 수도 있습니다:
```bash
cat > codex/deepseek.md << 'EOF'
[위 내용 전체를 여기에 붙여넣기]
EOF
댓글 0