Clinic-OS 운용 핵심 개념
비기술자를 위한 워크샵 자료 모든 기술적 작업은 AI 코딩 에이전트에게 요청합니다
🎯 핵심 원칙
┌─────────────────────────────────────────────────────┐
│ 당신은 "무엇을 원하는지"만 말합니다 │
│ AI 코딩 에이전트가 "어떻게 하는지"를 처리합니다 │
└─────────────────────────────────────────────────────┘🌍 개념 1: 두 개의 세계
로컬 (내 컴퓨터)
- 나만 볼 수 있는 연습장 같은 곳
- 잘못해도 아무 영향 없음
- 새 기능 테스트하는 곳
프로덕션 (인터넷)
- 실제 환자들이 보는 공식 웹사이트
- 변경하면 바로 모두에게 적용
- 항상 로컬에서 먼저 테스트 후 배포
💡 AI 에이전트에게 이렇게 요청:
| 원하는 것 | 요청 예시 |
|---|---|
| 로컬에서 테스트 | "로컬에서 사이트 실행해줘" |
| 프로덕션에 배포 | "지금 변경사항 배포해줘" |
🗄️ 개념 2: 두 개의 데이터베이스
로컬 DB
- 내 컴퓨터에만 있는 테스트용 데이터
- 마음대로 수정/삭제 가능
- 프로덕션에 영향 없음
프로덕션 DB
- 실제 환자 데이터가 저장된 곳
- 신중하게 다뤄야 함
- 삭제하면 복구 어려움
💡 AI 에이전트에게 이렇게 요청:
| 원하는 것 | 요청 예시 |
|---|---|
| 로컬 DB 초기화 | "로컬 데이터베이스 초기화해줘" |
| 프로덕션 DB 수정 | "환자 테이블에 필드 추가해줘 (프로덕션)" |
📦 개념 3: 업데이트 종류
코어 업데이트
- 기본 시스템이 새 버전으로 변경
- 사용자가 바로 업데이트 명령을 찍기보다, 에이전트가 현재 설치 상태와 버전을 진단한 뒤 적절한 경로를 선택
- 내 커스터마이징(
local/폴더)은 보호됨
💡 AI 에이전트에게 이렇게 요청:
| 상황 | 요청 예시 |
|---|---|
| 최신 버전 확인 | "새 업데이트 있는지 확인하고 지금 설치본에 바로 적용해도 안전한지 봐줘" |
| 업데이트 적용 | "상태를 먼저 진단하고 안전하면 업데이트까지 진행해줘" |
⏰ 개념 4: Git = 타임머신
Git이란?
- 코드의 변경 이력을 기록하는 시스템
- 언제든 과거로 돌아갈 수 있음
- 안전하게 변경을 관리
왜 중요한가?
오늘 수정 → 문제 발생 → 어제로 되돌리기 ✅💡 AI 에이전트에게 이렇게 요청:
| 원하는 것 | 요청 예시 |
|---|---|
| 현재 상태 저장 | "지금 상태로 저장해줘" |
| 이전으로 되돌리기 | "어제 상태로 되돌려줘" |
| 변경사항 확인 | "뭐가 바뀌었는지 보여줘" |
🔄 개념 5: 시스템 업그레이드 흐름
[현재 내 시스템 v1.0]
│
▼
[에이전트가 상태 진단]
- 구형 설치본 여부 판단
- 인플레이스 업데이트 가능 여부 확인
- 백업/복원 후보 점검
│
▼
[안전한 경로 선택]
- core 업데이트
- 또는 신규 설치 후 이관
│
▼
[검증 후 배포]⚠️ 반드시 기억할 것
✅ 해도 되는 것
- 로컬에서 마음껏 테스트
- AI 에이전트에게 모르는 것 물어보기
- 업데이트 적용 전 내용 확인 요청
❌ 하면 안 되는 것
- 테스트 없이 바로 프로덕션 배포
- 프로덕션 DB에서 삭제 명령
- Git 저장 없이 큰 변경
🆘 문제 상황별 요청
| 상황 | AI 에이전트에게 요청 |
|---|---|
| 처음 설치 | "이 프로젝트 먼저 읽고 설치 상태를 진단한 다음 필요한 명령을 직접 실행해줘" |
| 사이트가 안 열려요 | "로컬 서버 상태 확인해줘" |
| 오류 메시지 나왔어요 | "[오류 메시지] 이런 오류 났어" |
| 수정한 게 안 보여요 | "캐시 문제인지 확인해줘" |
| 이전 상태로 돌아가고 싶어요 | "git으로 이전 상태 복구해줘" |
| 업데이트 적용하고 싶어요 | "업데이트 가능한 상태인지 먼저 보고, 안전하면 적용해줘" |
| 검색·AEO 상태를 전체 점검하고 싶어요 | "AEO SEO 통합 점검으로 사이트맵 전체 개선점을 찾아줘" |
🔎 AEO·SEO 정기 운영
월 1회 또는 콘텐츠·라우팅·구조화 데이터 변경을 배포한 뒤에는 에이전트에게 통합 점검을 요청하세요. 에이전트는 search-intelligence 스킬을 사용해 두 사이트맵 루트를 합친 전체 URL census와 유형·언어별 HTML 표본을 같은 기준으로 비교합니다. 감사 결과는 개선 목록이며 자동 수정이나 프로덕션 변경 승인을 뜻하지 않습니다.
📋 워크샵 체크리스트
이해했는지 확인:
- [ ] 로컬과 프로덕션의 차이를 설명할 수 있다
- [ ] 왜 로컬에서 먼저 테스트해야 하는지 안다
- [ ] 두 개의 DB가 따로 있다는 것을 안다
- [ ] Git이 "되돌리기" 기능이라는 것을 안다
- [ ] 모든 기술적 요청은 AI 에이전트에게 한다
🚀 AI 코딩 에이전트 시작하기
스타터킷을 bash로 설치해 프로젝트 폴더를 준비한 뒤, 권장 에이전트로 프로젝트를 엽니다.
- 메인 운영 에이전트: Claude Code 또는 Codex 중 하나 (동등 지원)
- 코딩·운영: 현재 작업공간을 연 메인 에이전트가 직접 수행
- 이미지 제작: 클리닉 소유 ChatGPT/Codex 이미지 기능 연결
이미지 기능 연결 후 실제 이미지 한 장을 생성해 저장되는지 확인해야 브랜드·이미지 온보딩이 완료됩니다. HQ 무료 횟수나 제작팀 API 키에 의존하지 않습니다.
첫 요청은 이렇게 시작하는 것이 좋습니다:
이 프로젝트 먼저 읽고 현재 상태를 진단한 다음,
안전한 명령은 직접 실행하고 위험한 작업은 이유를 설명하고 제안해줘.