Docs: AI 활용 흐름과 Codex 작업 지침 정리

[lunarbae628]

🛰️ Issue Number

• 없음: AI 활용 문서와 Codex 작업 지침을 정리하는 문서 변경입니다.

🪐 작업 내용

• AGENTS.md에 Codex 작업 시 따를 실행 지침을 정리했습니다.
  • Superpowers 적용 기준
  • Issue/PR 작성 기준
  • 기존 라벨 사용 기준
  • assignee 지정 기준
  • 브랜치 이름 기준
  • PR 리뷰 기준의 적용 범위
• ai/ai-assisted-development-workflow.md를 체크리스트가 아니라 AI 활용 워크플로우 정리 문서로 재구성했습니다.
• ai/README.md에 ai/ 디렉터리 문서의 역할을 정리했습니다.
• 사람용 HTML 설명서 ai/ai-usage-guide.html을 추가했습니다.
  • HTML에는 이슈 템플릿, PR 템플릿, 브랜치 이름 기준 같은 실행 규칙을 제외하고 AI 활용 개발 흐름만 보여주도록 구성했습니다.

📚 Reference

• AGENTS.md
• ai/ai-assisted-development-workflow.md
• ai/ai-usage-guide.html

🤖 AI 보조 작업 기록

• 사용 범위:
  • AI 활용 문서 역할 분리
  • Codex 작업 지침 문장 정리
  • 사람용 HTML 설명서 구조 작성
  • PR 기준과 라벨/브랜치 기준 문서화
• 채택한 제안과 이유:
  • AI 실행 규칙은 AGENTS.md로 단일화했습니다. Codex가 읽는 기준을 분산시키지 않기 위함입니다.
  • ai/ai-assisted-development-workflow.md는 AI 활용 흐름을 기록하고 개선하는 워크플로우 정리 문서로 유지했습니다.
  • 사람용 설명은 HTML로 분리했습니다. 프로젝트 문서와 실행 지침을 읽는 목적이 다르기 때문입니다.
  • HTML에서는 이슈/PR/브랜치 세부 규칙을 제거했습니다. 사람용 설명서는 AI 활용 개발 흐름만 명확하게 보여주는 것이 목적이기 때문입니다.
• 기각한 제안과 이유:
  • HTML에 이슈 템플릿, PR 템플릿, 브랜치 이름 기준을 함께 넣는 방식은 제외했습니다. 실행 규칙과 사람용 흐름 설명이 섞이면 문서 목적이 흐려지기 때문입니다.
  • codex/ 브랜치 접두사를 기본으로 강제하는 방식은 제외했습니다. 저장소의 기존 브랜치 관례와 작업 유형 prefix를 우선하기 위함입니다.
• 실행한 검증:
  • git diff --check -- origin/staging..HEAD
  • HTML 내 이슈/PR/브랜치 기준 문구 잔존 여부 검색
  • origin/staging..HEAD 변경 파일 확인
• 남은 리스크:
  • 문서 변경만 포함하므로 런타임 영향은 없습니다.
  • 실제 Codex GitHub Code Review가 AGENTS.md 지침을 어느 정도까지 반영하는지는 이후 PR 리뷰 동작을 보며 조정이 필요합니다.

✅ Check List

• 코드가 정상적으로 컴파일되나요? (해당 없음: 문서 변경만 포함)
• 테스트 코드를 통과했나요? (해당 없음: 문서 변경만 포함, git diff --check 수행)
• merge할 브랜치의 위치를 확인했나요? (staging)
• Label을 지정했나요?