📌 AI 작업 운영 규칙 (Codex + 로컬 작업 기준)

🚨 현재 적용 모드 (최우선)

현재 이 저장소는 로컬 전용 + main 직접 작업 모드로 사용한다.

이 문서의 목적은 복잡한 브랜치 흐름보다 현재 체크아웃된 로컬 main에서 바로 수정하고 실행하는 기준을 우선 적용하는 것이다.

Codex / AI 기본 규칙

사용자가 구현, 수정, 실행, 설정 변경, 문서 수정, 채팅 응답 개선을 요청하면 현재 로컬 main에서 바로 작업한다
브라우저 확인, 화면 검증, 접속 테스트, 기본 작업 도메인은 https://test.sm-home.cloud/ 하나만 기준으로 사용한다
브라우저 스크린샷/캡처 검증은 기본적으로 루트 .env의 CAPTURE_BASE_URL=https://test.sm-home.cloud/와 등록 토큰(CAPTURE_REGISTERED_ACCESS_TOKEN, VITE_ALLOWED_REGISTRATION_TOKEN)을 사용해 토큰 등록 상태에서 진행한다
별도로 운영 중인 4173 포트의 ai-code-app-preview 컨테이너는 채팅 전용 테스트 서버가 아니라 현재 프로젝트 루트 기준 화면/기능 확인용 테스트 컨테이너로 해석한다
test.sm-home.cloud nginx 프록시는 화면 /만 5174 앱 테스트 서버로 보내고, /api/와 /ws/chat은 항상 127.0.0.1:3100 work-server로 유지한다
test.sm-home.cloud의 /api, /ws/chat, /.codex_chat, /public/.codex_chat 프록시 대상은 사용자가 명시적으로 요청하지 않는 한 임의로 변경하지 않는다
별도 지시가 없으면 sm-home.cloud, rel.sm-home.cloud 같은 다른 외부 도메인은 작업 기준으로 삼지 않는다
채팅, 메모 반영, 문서 반영 요청은 기본적으로 브랜치 생성 없이 main 직접 수정으로 해석한다
자동화 작업메모, 자동화 메모, 자동화 접수된 작업메모는 항상 신규 feature/* 브랜치를 생성해 작업하고, 이후 release 반영과 main 일괄반영까지 진행한다
자동화 메모 작업을 실제 진행할 때 현재 작업중인 자동화가 없다면, 자동화 작업공간의 release 브랜치를 먼저 main 기준 최신 상태로 맞춘 뒤 다음 자동화 작업을 시작한다
자동화 작업메모의 main 일괄반영이 끝나면 프로젝트 루트에서 최신 main을 pull --ff-only로 동기화한다
git remote, fetch, pull, push, branch, switch, checkout, merge, rebase, reset, stash, tag, commit 같은 Git 관리 작업은 기본적으로 수행하지 않는다
사용자가 Git 작업을 명시적으로 요청한 경우에만 필요한 명령을 최소 범위로 수행한다
원격 저장소 연결 복구, 브랜치 전략 복구, release/main 동기화, 자동 merge 같은 작업을 자동으로 시도하지 않는다
현재는 브랜치 전략보다 로컬 실행 가능 상태 유지, 코드 수정, 문서 갱신, 메모 반영 속도를 우선한다
.auto_codex 관련 Git 자동화, Plan 자동화, 브랜치 생성/병합 흐름은 사용자가 다시 요청하기 전까지 비활성 상태로 취급한다

요청 해석 규칙

사용자가 단순히 구현, 수정, 실행, 설정 변경을 요청하면 Git 작업 없이 로컬 파일 수정과 실행 작업만 진행한다
사용자가 git, 브랜치, 원격, push, pull, merge, commit를 명시적으로 언급할 때만 Git 작업으로 해석한다
사용자가 Plan 등록, Plan 게시판 등록, 게시판 등록, 계획 등록이라고 말하면 Plan 게시판 항목 생성 의미로 해석한다
사용자가 자동화 등록, 자동화 접수, 자동화 실행, 자동화 돌려줘라고 말하면 자동화 API 등록 또는 실제 자동화 수행 의미로 해석한다
사용자가 자동화 메모라고만 말하면 기본적으로 자동화 접수 작업메모로 해석하고, 신규 feature/* 브랜치 생성부터 release 반영, main 일괄반영, 프로젝트 루트 pull까지 포함한 흐름을 적용한다
사용자가 Plan 게시판에 등록만, 자동화 없이, 구현하지 말고 계획만 등록, 게시판만처럼 표현하면 자동화 실행 없이 Plan 항목만 등록한다
사용자가 자동화해줘, 구현해줘, 작업 진행해줘, 실행해줘처럼 실제 수행을 명시한 경우에만 자동화 또는 코드 작업으로 해석한다
요청이 모호하면 자동화 실행을 바로 진행하지 말고, 우선 Plan 등록으로 안전 해석하거나 짧게 재확인한다

Git 관련 안전 규칙

로컬 작업 중에도 사용자가 요청하지 않은 Git 정리 작업은 하지 않는다
reset, checkout, switch, clean, 강제 덮어쓰기처럼 되돌리기 어려운 작업은 자동으로 수행하지 않는다
사용자가 Git 작업을 요청해도 정말 필요한 범위만 실행한다
현재 모드에서는 main 직접 수정이 허용되지만, 자동 commit / push는 여전히 금지한다

Codex Live / 채팅 / 작업 메모 규칙

Codex Live, 일반 채팅 요청은 현재 프로젝트의 로컬 main을 기준으로 처리한다
자동화 작업메모 반영 요청은 예외적으로 신규 feature/* 브랜치 생성 -> release 반영 -> main 일괄반영 -> 프로젝트 루트 pull 순서를 기본으로 처리한다
자동화 작업메모를 시작하기 직전에 진행 중인 자동화가 없으면, 자동화 작업공간의 release를 main과 먼저 맞춘 뒤 feature/* 작업을 시작한다
외부 도메인 기준 동작 확인이 필요하면 기본 대상은 항상 https://test.sm-home.cloud/로 본다
https://test.sm-home.cloud/에서 채팅/API 문제가 보이면 먼저 프런트 코드보다 nginx의 /api와 /ws/chat 프록시가 3100을 가리키는지 확인한다
채팅에서 나온 수정 요청도 별도 브랜치 생성 없이 바로 파일 수정으로 이어질 수 있다
일반 작업 메모는 기록 목적이면 메모로 유지하고, 실제 수정 지시라도 별도 자동화 접수가 아니면 main 기준 로컬 작업으로 연결한다
자동화 작업메모는 Git flow를 기본으로 적용하며, 일반 채팅/수동 작업은 필요한 경우에만 사용자가 별도로 Git 단계를 요청한다
채팅에서 파일/문서/이미지/코드 리소스를 제공할 때는 반드시 public/.codex_chat/<chat-session-id>/resource/ 아래 세션 전용 경로를 기준으로 사용한다
채팅 첨부 파일은 public/.codex_chat/<chat-session-id>/resource/uploads/ 아래 경로를 기준으로 사용한다
원본 파일 경로만 응답해도 서버가 해당 리소스를 위 세션 경로로 복사해 공개 링크로 바꿔 줄 수 있지만, 문서와 안내 문구에는 위 공개 경로 기준을 우선 명시한다
토큰 등록이 필요한 화면 검증이나 모바일 스크린샷은 비로그인 기본 화면(Docs)으로 확인하지 말고, .env에 저장된 등록 토큰을 브라우저 localStorage에 주입한 상태로 캡처한다

Plan / 자동화 메모

일반 수동 작업에는 여전히 로컬 main 직접 수정 원칙을 유지한다
다만 자동화 작업메모와 Plan 자동화에는 기존 feature -> release -> main -> 프로젝트 루트 pull 흐름을 기본 규칙으로 다시 적용한다
추가로 자동화 큐가 비어 있는 시점에 새 자동화 메모 작업을 시작하면, 자동화 작업공간의 release를 main과 동기화한 뒤 같은 흐름을 이어간다
hotfix/* 흐름은 기존 예외 규칙을 유지하고, 자동화 대상이 아닌 일반 요청에는 자동 적용하지 않는다

한 줄 요약

👉 일반 채팅/수동 요청은 로컬 main에서 바로 수정한다
👉 외부 확인 기본 도메인은 https://test.sm-home.cloud/ 하나다
👉 자동화가 비어 있으면 다음 자동화 시작 전 작업공간 release를 main과 먼저 맞춘다
👉 자동화 작업메모는 feature -> release -> main -> 프로젝트 루트 pull 흐름을 탄다
👉 일반 Git 작업은 사용자가 명시적으로 요청할 때만 최소 범위로 한다

8.2 KiB Executable File Raw Blame History