겪어본 문제를,
다음 작업의 양식으로.

# 콘텐츠 제작·게시 체크리스트
회몬 · JH Soft Labs | 공개용 v1.0 | 2026-09-13
관련 기록: https://jhsoftlabs.com/stories/salon-publishing

내부 운영 문서가 아니라 작업 기록의 시행착오를 바탕으로 새로 만든 빈 양식입니다.
개인·팀 작업에 맞게 복사해 채워 쓰세요. 예시는 가상의 상황이며 고객 자료가 아닙니다.
이 양식은 게시·매출 성과나 자료 사용 권한을 보장하지 않습니다.

## 사용 순서
1. 알릴 내용 한 가지와 원하는 행동 한 가지를 정합니다.
2. 제작 완료와 게시 완료를 각각 확인합니다.
3. 확인된 반응만 기록하고, 모르는 결과는 '미확인'으로 남깁니다.

## 1. 한 장의 제작 요청서
- 프로젝트 / 작업명:
- 작성일 / 담당자:
- 누구에게 보여줄 콘텐츠인가:
- 알릴 소식 한 가지:
- 본 사람이 다음에 할 행동:
- 채널 / 필요한 비율 / 파일 형식:
- 함께 전달할 게시글 / 링크:
- 이번 작업에 포함하지 않는 것:
- 합의한 수정 범위 / 최종 확인자:
- 확인할 비용 / 일정 / 이용 조건:

## 2. 자료와 표현
- [ ] 원본 이미지와 글의 사용 권한을 확인했다.
- [ ] 인물이나 고객 자료가 포함된다면 필요한 동의를 확인했다.
- [ ] AI 생성 예시와 실제 고객 작업·시술 결과를 구분했다.
- [ ] 실제 후기나 성과로 오해할 문구를 제거했다.
- [ ] 연락처 등 민감 정보가 공개 이미지에 남지 않았다.
- [ ] 모바일에서도 핵심 문구와 연결 방법이 읽힌다.

## 3. 공개 전후 확인
- [ ] 최종 파일과 수정 중 파일을 구분했다.
- [ ] 게시글과 이미지의 내용이 일치한다.
- [ ] 연결 페이지가 실제 공개 주소에서 열린다.
- [ ] 문의 링크가 올바른 곳으로 이동한다.
- [ ] 내부 문서나 미공개 파일은 공개되지 않는다.
- [ ] 게시 후 이미지·본문·링크 미리보기를 확인했다.
- [ ] 유료 서비스·호스팅 등의 이용 조건을 별도로 확인했다.
- 실제 공개 URL / 공개일:
- 게시하지 않은 작업:
- 실패하거나 다시 확인할 항목:

## 4. 소개와 반응 기록
- 대상의 실명 대신 사용할 내부 식별명:
- 콘텐츠와 상대의 관련성:
- 기존 연락 / 거절 여부 확인:
- 소개 여부 / 날짜:
- 확인된 반응: [미확인 / 답변 / 문의 / 주문 / 거절]
- 반응을 확인한 근거:
- 다음 확인일:
- 하지 않을 행동: 무응답을 동의로 간주하거나 거절 후 반복 연락하기
- 공유본에서 삭제할 연락처·계정·대화 원문:

## 5. 이번 실험 한 줄
- 만든 것:
- 실제로 공개한 것:
- 확인한 반응:
- 아직 모르는 것:
- 다음에는 바꿀 한 가지:

## 가상 작성 예시
- 작업명: 가상 미용실 '봄결' 오픈 안내
- 원하는 행동: 예약 방법 확인
- 제작 상태: 이미지·게시글 준비
- 게시 상태: 미게시
- 문의 상태: 미확인
- 다음 행동: 실제 공개 전 AI 예시 표시와 예약 링크 점검

작성한 양식을 외부에 공유하기 전 고객 정보와 미공개 조건을 다시 확인하세요.
양식만 채웠다고 자료 사용 권한이나 운영 조건이 충족되는 것은 아닙니다.

# 따라 할 수 있는 가이드 검수표
회몬 · JH Soft Labs | 공개용 v1.0 | 2026-09-13
관련 기록: https://jhsoftlabs.com/stories/guides-that-work

작업 기록을 바탕으로 새로 만든 공개용 검수 양식입니다.
개인·팀 작업에 맞게 복사해 채워 쓰세요. 검색 노출이나 순위를 보장하지 않습니다.

## 사용 순서
1. 독자의 증상과 원하는 결과를 한 문장으로 적습니다.
2. 같은 입력으로 문제와 해결 결과가 재현되는지 확인합니다.
3. 원고·예제·공개·검색 확인 상태를 따로 기록합니다.

## 1. 독자가 하려는 일
- 글 제목 / 대상 독자:
- 독자가 겪는 증상:
- 원하는 결과:
- 이 글에서 다루지 않는 경우:
- 비슷한 제목의 다른 글과 다른 행동:
- 사용하는 프로그램 / 버전 / 언어·지역 설정:
- 실제 확인일:
- 확인한 공식 문서 URL:

## 2. 먼저 적는 예상 결과
- 합성 입력 데이터 / 파일:
- 입력에 이 문제를 보여주는 요소가 있는가:
- 실행할 정확한 단계 또는 명령:
- 실행 전 예상 결과:
- 실행 후 실제 결과:
- 예상과 다른 부분 / 수정 사항:
- 빈 값, 0, 식별자, 날짜 등 의미가 달라질 수 있는 값:
- 저장한 결과를 다시 읽어 확인할 방법:
- 검증하지 못한 환경과 이유:

## 3. 샘플과 설명 점검
- [ ] 입력만 보고도 어떤 문제가 있는지 확인할 수 있다.
- [ ] 입력 파일과 절차와 결과가 서로 일치한다.
- [ ] 실행 가능한 코드는 실제로 실행했다.
- [ ] 저장·변환 예제는 출력 파일을 다시 확인했다.
- [ ] 원본을 복사하고 복사본으로 시도하도록 안내했다.
- [ ] 빈 값과 0, 숫자와 식별자를 같은 것으로 설명하지 않았다.
- [ ] 모호한 날짜나 지역 설정의 전제를 명시했다.
- [ ] 합성 데이터만 쓰고 고객 원본을 샘플에 넣지 않았다.
- [ ] 도해가 실제 프로그램 화면인지 설명용 그림인지 구분했다.
- [ ] 맞지 않는 경우와 다음 확인 방법도 적었다.

## 4. 공개 점검
- [ ] 모바일에서 비교표·도해·코드가 잘리지 않는다.
- [ ] 샘플은 실제로 내려받을 수 있다.
- [ ] 여러 파일이 필요하면 파일별로 구분해 제공한다.
- [ ] 관련 글과 공식 문서 링크가 올바르게 열린다.
- [ ] 제목·설명·대표 주소가 실제 글의 내용과 일치한다.
- [ ] 공개된 페이지에서 마지막으로 절차를 확인했다.
- 공개 URL / 공개일:
- 마지막 내용 수정일 / 변경 이유:
- 아직 실패하는 항목:

## 5. 공개 이후의 관찰
모르는 값은 0이 아니라 '미확인'으로 적습니다.
- 관찰 기간 / 데이터 출처:
- 색인 상태 / 확인일:
- 노출 / 클릭: [미확인 또는 확인된 수치]
- 독자 피드백: [없음이라고 확인 / 미확인 / 확인된 내용]
- 공개 완료와 별개로 남은 작업:
- 다음에 고칠 한 가지:
- 다음 확인일:

## 가상 작성 예시
- 증상: 상품 코드 앞자리 0이 사라짐
- 합성 입력: 00123
- 원하는 결과: 식별자 문자열 00123 유지
- 핵심 확인: 숫자 계산을 위한 변환과 구분하기
- 공개 상태: 미게시
- 검색 상태: 미확인

샘플 검사 통과는 모든 환경의 정답을 뜻하지 않습니다.
확인한 환경과 한계를 글에도 함께 남기세요.

# AI 서비스 실패·재시도 점검표
회몬 · JH Soft Labs | 공개용 v1.0 | 2026-09-13
관련 기록: https://jhsoftlabs.com/stories/ai-retry-safety

진단 안정화 작업을 바탕으로 새로 정리한 공개용 점검 양식입니다.
개인·팀 작업에 맞게 복사해 채워 쓰세요.
특정 서비스의 운영 코드·SQL이 아니며 보안 감사나 무장애 보증을 대신하지 않습니다.

## 사용 순서
1. 성공할 때 함께 보존돼야 할 상태를 적습니다.
2. 격리된 테스트 환경에서 실패 상황을 하나씩 만듭니다.
3. 테스트 결과와 실제 운영 적용 여부를 별도로 기록합니다.

## 1. 이번 변경의 경계
- 기능 / 담당자 / 확인일:
- 사용자에게 성공이란:
- 함께 확정해야 하는 데이터:
- 같은 요청을 다시 구분하는 기준:
- 새로운 작업으로 처리할 조건:
- 데이터 보관·삭제 범위:
- 외부 AI 호출 / 비용이 발생하는 지점:
- 이번에 바꾸지 않을 기능:
- 테스트 환경과 합성 데이터:
- 운영 반영 승인 / 별도 확인이 필요한 사항:

## 2. 시나리오별 검증표
각 항목에 예상 결과, 실제 결과, 근거, [통과 / 실패 / 미확인 / 해당 없음]을 적습니다.
'해당 없음'에는 이유를 남깁니다.

### 같은 요청을 두 번 제출
- 예상: 같은 작업의 중복 실행과 중복 사용량 반영을 막음
- 실제 결과:
- 확인 근거 / 상태:

### 마지막 남은 사용 횟수에 동시 요청
- 예상: 허용량을 초과해 승인하지 않음
- 실제 결과:
- 확인 근거 / 상태:

### 결과 저장 도중 오류
- 예상: 결과와 사용량 중 일부만 확정되지 않음
- 실제 결과:
- 확인 근거 / 상태:

### 저장은 완료됐지만 응답 유실
- 예상: 다시 확인할 때 기존 완료 결과를 유지
- 실제 결과:
- 확인 근거 / 상태:

### 완료 뒤 늦게 도착한 실패 처리
- 예상: 이미 완료된 결과를 실패로 덮어쓰지 않음
- 실제 결과:
- 확인 근거 / 상태:

### 작업 중단과 시간 만료
- 예상: 끝없는 로딩 대신 상태 안내와 안전한 재시도 경로 제공
- 실제 결과:
- 확인 근거 / 상태:

### 비로그인 결과를 계정으로 이전
- 예상: 중복 이전으로 결과나 사용량이 반복 반영되지 않음
- 실제 결과:
- 확인 근거 / 상태:

## 3. 운영 반영 전후
- [ ] 합성 데이터로 검증했고 사용자 원문은 사용하지 않았다.
- [ ] 테스트 실패가 기존 데이터를 변경하지 않는다.
- [ ] 테스트 통과와 운영 반영 완료를 구분했다.
- [ ] 사용자 권한으로 허용되지 않은 변경을 할 수 없는지 검증했다.
- [ ] 복구·재시도 화면을 실제 사용자 경로에서 확인했다.
- [ ] 기존 데이터 보존 조건을 확인했다.
- [ ] 안전한 되돌리기 조건과 담당자를 적었다.
- [ ] 비밀키·접속 정보·사용자 답변이 보고서에 없다.
- [ ] 비용 상한과 보관·삭제 정책은 별도 검토 여부를 기록했다.

## 4. 인수인계 한 장
- 준비한 코드 / 검증한 버전:
- 확인한 테스트와 한계:
- 운영 적용 상태: [미적용 / 적용 중 / 적용 확인]
- 운영 적용일 / 확인 근거:
- 남은 실패 / 미확인 항목:
- 문제가 생기면 먼저 볼 상태:
- 안전한 복구 조건:
- 다음 담당자가 할 한 가지:
- 변경하면 안 되는 항목:

운영 환경에 장애를 직접 주입하지 마세요.
권한과 복구 계획을 확인한 격리 환경에서 검증하고, 실제 적용은 별도 절차로 다루세요.