5.5 KiB
Executable File
5.5 KiB
Executable File
📌 AI 작업 운영 규칙 (Codex + 로컬 작업 기준)
🚨 현재 적용 모드 (최우선)
현재 이 저장소는 로컬 전용 + main 직접 작업 모드로 사용한다.
이 문서의 목적은 복잡한 브랜치 흐름보다 현재 체크아웃된 로컬 main에서 바로 수정하고 실행하는 기준을 우선 적용하는 것이다.
Codex / AI 기본 규칙
- 사용자가 구현, 수정, 실행, 설정 변경, 문서 수정, 채팅 응답 개선, 작업 메모 반영을 요청하면 현재 로컬
main에서 바로 작업한다 - 브라우저 확인, 화면 검증, 접속 테스트, 기본 작업 도메인은
https://test.sm-home.cloud/하나만 기준으로 사용한다 - 별도 지시가 없으면
sm-home.cloud,rel.sm-home.cloud같은 다른 외부 도메인은 작업 기준으로 삼지 않는다 채팅,작업 메모,작업메모,메모 반영,문서 반영요청은 기본적으로 브랜치 생성 없이 main 직접 수정으로 해석한다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 등록 또는 실제 자동화 수행 의미로 해석한다 - 사용자가
자동화 메모라고만 말하면 게시판 메모인지 자동화 접수 메모인지 문맥을 먼저 확인한다 - 사용자가
Plan 게시판에 등록만,자동화 없이,구현하지 말고 계획만 등록,게시판만처럼 표현하면 자동화 실행 없이 Plan 항목만 등록한다 - 사용자가
자동화해줘,구현해줘,작업 진행해줘,실행해줘처럼 실제 수행을 명시한 경우에만 자동화 또는 코드 작업으로 해석한다 - 요청이 모호하면 자동화 실행을 바로 진행하지 말고, 우선 Plan 등록으로 안전 해석하거나 짧게 재확인한다
Git 관련 안전 규칙
- 로컬 작업 중에도 사용자가 요청하지 않은 Git 정리 작업은 하지 않는다
reset,checkout,switch,clean, 강제 덮어쓰기처럼 되돌리기 어려운 작업은 자동으로 수행하지 않는다- 사용자가 Git 작업을 요청해도 정말 필요한 범위만 실행한다
- 현재 모드에서는
main직접 수정이 허용되지만, 자동 commit / push는 여전히 금지한다
Codex Live / 채팅 / 작업 메모 규칙
Codex Live, 일반 채팅, 작업 메모 반영 요청은 모두 현재 프로젝트의 로컬main을 기준으로 처리한다- 외부 도메인 기준 동작 확인이 필요하면 기본 대상은 항상
https://test.sm-home.cloud/로 본다 - 채팅에서 나온 수정 요청도 별도 브랜치 생성 없이 바로 파일 수정으로 이어질 수 있다
- 작업 메모는 기록 목적이든 실제 수정 지시든 우선
main기준의 로컬 작업으로 연결한다 - 채팅과 작업 메모는 Git flow를 강제하지 않고, 필요한 경우에만 사용자가 별도로 Git 단계를 요청한다
- 채팅에서 파일/문서/이미지/코드 리소스를 제공할 때는 반드시
public/.codex_chat/<chat-session-id>/resource/아래 세션 전용 경로를 기준으로 사용한다 - 채팅 첨부 파일은
public/.codex_chat/<chat-session-id>/resource/uploads/아래 경로를 기준으로 사용한다 - 원본 파일 경로만 응답해도 서버가 해당 리소스를 위 세션 경로로 복사해 공개 링크로 바꿔 줄 수 있지만, 문서와 안내 문구에는 위 공개 경로 기준을 우선 명시한다
Plan / 자동화 메모
- 기존 문서에 남아 있는
feature,hotfix,release흐름은 현재 로컬 모드에서는 기본 규칙으로 사용하지 않는다 - Plan 게시판과 자동화 관련 기능 설명은 UI/상태 설명으로만 참고하고, 실제 Git 브랜치 운영 규칙으로 자동 적용하지 않는다
- 사용자가 나중에 브랜치 전략 복구를 명시적으로 요청하면 그때 별도 문서 갱신 후 다시 적용한다
한 줄 요약
👉 지금은 로컬 main에서 바로 수정한다
👉 외부 확인 기본 도메인은 https://test.sm-home.cloud/ 하나다
👉 채팅이든 작업 메모든 기본 해석은 main 직접 작업이다
👉 Git 작업은 사용자가 명시적으로 요청할 때만 최소 범위로 한다