Files
ai-code-app/AGENTS.md
2026-04-21 03:33:23 +09:00

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 작업은 사용자가 명시적으로 요청할 때만 최소 범위로 한다