Imported from nomura-kanziro/human-bug-tier (
AGENTS.md). Install upstream withnpx skills add nomura-kanziro/human-bug-tier. Copyright stays with the author.
AGENTS.md — Codex / 멀티 에이전트 진입점
이 파일은 OpenAI Codex(CLI · IDE)와 기타 에이전트가 프로젝트를 열 때 참고하는 진입 지침입니다.
⚠️ 모든 AI — 공통 정본 먼저
.agents/common-rules.md.agents/hierarchy.md— Grok = Admin AI.agents/<기능>/skill.md— 기능 표준 스킬 (번외 AI도 동일)- Codex면 이어서
codex/<기능>/skill.md(주 골격 보강)
정본: .agents/README.md
(주 골격 Grok/Claude/Codex 전용 팩 = 도구 최적화 복제본. 충돌 시 .agents 우선)
사람(창시자·팀원) 규칙: team/README.md
프로젝트
휴버대 티어표 — 바닐라 HTML/CSS/JS + Express/MongoDB.
공식 19티어(이미지 폴더 일치) · 커스텀 제작/게시판/본인 글 수정 · 회원 · 공지(관리자 수정) · 문의 · 관리자 · PWA.3단계 이식 완료, 다음 단계는 지시 전 구현 금지.
현재 바닐라 0.5.0. 실무는 Render.com만 (root-render/ + backend/). Cloudflare 작업 중지. React 정식(root-cloudflare/)은 2026-09-05 지시로 1
Codex가 할 일 (순서)
.agents공통 룰 준수- 요청 기능 판별 →
codex/<기능>/skill.md - 범위가 넓으면
codex/project-wide/skill.md - 상세 배경은
RDMD/(필요 구간만) - 공통 룰 충돌 시 Grok/사람 기준으로 맞춤 (룰 약화 금지)
인덱스: codex/README.md
로컬 실행
cd backend
npm install
# .env.example → .env (MONGO_URI, ADMIN_INPUT_ID, ADMIN_INPUT_PW …)
npm start→ http://localhost:5000/ (프론트 정적 + API 통합)
불변 규칙
| 항목 | 규칙 |
|---|---|
| 실행 | 풀스택 = backend 포트 5000 |
| 경로 | getBasePath() / fixRootLinksInElement — /... 하드코딩 금지 |
| API Base | getApiBase() — 개발 포트→localhost:5000, 동일 오리진→'', GH Pages→GITHUB_STATIC |
| 유저 | authToken + getAuthHeaders() |
| 관리자 | adminAuthToken + getAdminAuthHeaders() + requireAdmin |
| 비번 재설정 | 랜덤 토큰 + SHA-256 해시만 DB |
| 비밀 | .env 커밋·출력 금지 |
| 주석 | 기존 주석 삭제 금지. 코드가 바뀌면 주석 문구만 수정. 사람이 “지워”라고 하기 전엔 유지 |
| 문서 | 큰 변경 → `RDMD/frontend |
에이전트별 스킬 위치
| 계층 | 위치 |
|---|---|
| 공통 AI 룰 | .agents/ (Grok이 Admin으로 수호) |
| 사람 룰 | team/ |
| Codex 기능 스킬 | codex/<기능>/skill.md |
| Claude | CLAUDE.md + .claude/skills/*/SKILL.md |
| Grok | groks/AGENTS.md + groks/<기능>/grok_skill.md |
규칙 변경: .agents/sync-skills.md
작업 종료 시
- 변경 요약 (무엇을/왜)
- 수동 테스트 (
:5000) - 커밋·푸시 전
RDMD/commit_history/{작성자}.md작성 필수 (팀 규칙) — 안내/준수 - 기능 record (
frontend/backend) 권장 - 시크릿 미포함 확인