From 1100cbeb0819f600f388e81c565e928a7baa0d98 Mon Sep 17 00:00:00 2001 From: gahusb Date: Tue, 30 Jun 2026 23:47:17 +0900 Subject: [PATCH] =?UTF-8?q?docs(codex):=20codex-workflow.md=EC=97=90=20?= =?UTF-8?q?=ED=95=98=EB=84=A4=EC=8A=A4=20=EA=B7=9C=EC=B9=99=20=EB=8F=99?= =?UTF-8?q?=EA=B8=B0=ED=99=94=20(kind=C2=B7=EA=B2=80=EC=A6=9D=C2=B7revert)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit codex-working-rules.md에 넣은 규칙을 codex-workflow.md에도 동일 반영: - 쓰기 원칙: 카드 kind↔효과 일치(데미지=Attack/유틸=Skill/지속=Power) + 새 효과필드 Lua·JS 미러 양쪽 구현. - 신규 "검증·통합 원칙" 섹션: 변경 후 검증 스위트(cardkinds·cbprops· cbgap·미러테스트) · main 머지 전체 revert 금지(#98/#99 사고) · RULES.md/codex-working-rules.md 권위. Co-Authored-By: Claude Opus 4.8 (1M context) Claude-Session: https://claude.ai/code/session_01UUvHKjrt8jqLzDeCsRRGmj --- docs/codex-workflow.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/codex-workflow.md b/docs/codex-workflow.md index fa4ba4b..aa6b89c 100644 --- a/docs/codex-workflow.md +++ b/docs/codex-workflow.md @@ -22,6 +22,8 @@ - 공용으로 표현 가능한 효과는 카드 전용 분기로 만들지 않는다. - 같은 의미의 효과는 같은 필드 이름을 쓴다. - 문서는 카드별 상태표와 공용 필드 사전을 분리해서 유지한다. +- 카드 `kind`는 효과와 맞춘다 — 데미지 카드=`Attack`, block·유틸만 있으면=`Skill`, 지속효과=`Power`(`powerEffect` 또는 power 필드 필수). 안 맞으면 사용 불가/死카드가 된다(Power 분기는 damage/aoe 무시, Attack은 몬스터 드롭 라우팅). +- 새 효과 필드는 Lua(`cb/*.mjs`)와 JS 미러(`tools/balance/sim-balance.mjs`) 양쪽에 구현한다(한쪽만 = 게임↔시뮬 드리프트). ## 응답 원칙 @@ -29,3 +31,9 @@ - 바뀐 점과 남은 점만 말한다. - 불필요한 재설명은 줄인다. +## 검증·통합 원칙 + +- 카드/cb 변경 후 검증 스위트를 돌린다: `node tools/verify/cardkinds.mjs`(kind↔효과)·`cbprops.mjs`(미선언 `self.X` 필드)·`cbgap.mjs`(UI 경로) + `node --test tools/balance/sim-balance.test.mjs`(이중구현 미러). 이상 0을 확인한 뒤 산출물을 갱신한다. +- 작업 브랜치에 `main`을 머지했다가 충돌·문제가 나도 그 머지 커밋을 통째로 `git revert`하지 않는다 — main에 먼저 들어간 타인 작업이 collateral로 사라진다(2026-06-30 `#98/#99`가 `#96` 11개 수정을 이렇게 날린 사고). 소스 충돌만 해소하고 산출물(codeblock 등)은 재생성한다. +- 하네스 규칙의 최종 권위는 `RULES.md`(§1 산출물 읽기/수정 금지·§4 git/PR·§6 이중구현 동기화·§9 카드 kind)이고, codex 전용 하드룰은 `docs/codex-working-rules.md`다. 작업 전 둘 다 따른다. + -- 2.49.1