docs: 보스 설계 문서와 Codex YAML 도구 추가
- 프로젝트 AGENTS 지침에 커밋 후 푸시 확인 규칙과 런타임 콘텐츠 에이전트 규칙을 보강 - 보스 설계 플레이북과 멀티플레이 보스 설계 철학 문서를 추가해 사람용 설계 기준을 정리 - Codex-Tools 디렉터리에 Markdown→YAML→검증 파이프라인 스크립트와 프롬프트, 스키마, 설정 파일을 추가
This commit is contained in:
19
AGENTS.md
19
AGENTS.md
@@ -14,7 +14,7 @@ Multiplayer arena game built with **Unity 6000.3.10f1** and **Unity Netcode for
|
||||
Design docs are maintained in Obsidian Vault: `/mnt/smb/Obsidian Vault/Colosseum`
|
||||
|
||||
- Always use the shared Obsidian Vault at `/mnt/smb/Obsidian Vault/Colosseum` for project documentation updates.
|
||||
- **Obsidian Vault 파일은 반드시 파일 도구(read/write/edit)로만 접근한다.** cmd, powershell, bash 등은 UNC 경로를 정상적으로 처리하지 못하므로 사용하지 않는다.
|
||||
- 현재 환경에서 접근 가능한 셸(`bash`, `zsh` 등) 기준으로 Obsidian Vault 파일을 열고 수정해도 된다.
|
||||
- Unless the user explicitly names another file, `체크리스트` means `/mnt/smb/Obsidian Vault/Colosseum/개발/프로토타입 체크리스트.md`.
|
||||
- After completing work, always check whether the prototype checklist should be updated and reflect the new status when needed.
|
||||
- If the work also changes a domain-specific checklist such as boss/player/combat, sync that checklist too.
|
||||
@@ -337,6 +337,7 @@ public class NetworkedComponent : NetworkBehaviour
|
||||
- After Unity-related edits, check the Unity console for errors before proceeding.
|
||||
- For networked play tests, prefer a temporary non-conflicting test port when needed and restore the default port after validation.
|
||||
- The user has a strong project preference that play mode must be stopped before edits because network ports can remain occupied otherwise.
|
||||
- When the user requests a commit, create the commit and show the message, then **ask before pushing**. Only push after explicit confirmation.
|
||||
- Commit messages should follow the recent project history style: use a type prefix such as `feat:`, `fix:`, or `chore:` and write the subject in Korean so the gameplay/UI/system change is clear from the log alone.
|
||||
- When the change is substantial, include a blank line after the subject and add Korean bullet points that summarize the work by feature/purpose, similar to commit `0889bb0` (`feat: 드로그 집행 개시 패턴 및 낙인 디버프 추가`).
|
||||
- Prefer the format `type: 한글 요약` for the subject, then `- 변경 사항` bullet lines for the body. Use `feat:` for feature work, `fix:` for bug fixes, and `chore:` for non-feature maintenance such as scene/prefab cleanup, asset reorganization, or other miscellaneous upkeep. The body should mention key implementation scope, affected systems/assets, and validation or rollback notes when relevant.
|
||||
@@ -348,3 +349,19 @@ public class NetworkedComponent : NetworkBehaviour
|
||||
- 프로젝트 용어로는 `필살기`보다 `고위력 기술`을 우선 사용한다.
|
||||
- 보호막은 단일 값이 아니라 `타입별 독립 인스턴스`로 취급한다. 같은 타입은 자기 자신만 갱신되고, 서로 다른 타입은 공존하며, 흡수 순서는 적용 순서를 따른다.
|
||||
- 보스 시그니처 전조는 가능한 한 정확한 진행 수치 UI보다 명확한 모션/VFX로 읽히게 한다. 차단 진행도나 정확한 누적 수치 노출은 명시 요청이 없으면 피한다.
|
||||
|
||||
# Runtime Content Agent Rules
|
||||
|
||||
Purpose:
|
||||
Keep boss YAML compatible with game runtime expectations.
|
||||
|
||||
Always:
|
||||
- validate boss YAML shape before commit
|
||||
- preserve `boss_id` stability
|
||||
- keep runtime field names machine-readable and snake_case
|
||||
- prefer additive changes over destructive changes
|
||||
|
||||
Never:
|
||||
- change mechanic intent to satisfy schema formatting
|
||||
- silently rename IDs
|
||||
- auto-fill required combat values without a design source
|
||||
|
||||
Reference in New Issue
Block a user