밴딧 공용 효과와 문서 정리

docs/bandit-card-audit.md

@@ -0,0 +1,106 @@
+# Bandit Card Audit
+
+`bandit` 카드의 구현 상태를 카드별로 정리한 문서입니다.
+
+상태 기준:
+
+- `구현됨`: 공용 필드와 공용 로직으로 처리됨
+- `부분구현`: 카드 설명의 일부만 맞음
+- `미구현`: 아직 전용 메커니즘이 없음
+
+## 구현됨
+
+`Neutralize`, `SilentStrike`, `Survivor`, `SilentDefend`, `Slice`, `DaggerSpray`, `DaggerThrow`, `PoisonedStab`, `SuckerPunch`, `LeadingStrike`, `FollowThrough`, `FlickFlack`, `Prepared`, `Deflect`, `BladeDance`, `Backflip`, `DodgeAndRoll`, `CloakAndDagger`, `DeadlyPoison`, `Snakebite`, `Untouchable`, `Backstab`, `PreciseCut`, `Finisher`, `MementoMori`, `Flechettes`, `Dash`, `Predator`, `CalculatedGamble`, `HiddenDaggers`, `Acrobatics`, `Blur`, `LegSweep`, `Reflex`, `Haze`, `Tactician`, `WellLaidPlans`, `InfiniteBlades`, `Footwork`, `GrandFinale`, `Adrenaline`, `ShadowStep`, `Assassinate`, `Nightmare`, `ToolsOfTheTrade`, `Afterimage`, `StormOfSteel`, `Abrasive`, `Suppress`, `Expertise`
+
+공용 메모:
+
+- `poison`, `innate`, `playableWhenDrawPileEmpty` 구현됨
+- `retain`, `sly`, `discard`, `discardAll`, `addShiv`, `addShivPerDiscard`, `turnStartShiv`, `retainOne` 구현됨
+- `turnStartDraw`, `turnStartDiscard` 구현됨
+- `nextTurnBlock`, `nextTurnDraw`, `nextTurnKeepBlock`, `nextTurnAttackMultiplier`, `nextTurnCopies`, `nextTurnSelectHandCard` 구현됨
+- `damagePerOtherHandCard`, `damagePerAttackPlayedThisTurn`, `damagePerDiscardedThisTurn`, `damagePerSkillInHand`, `otherHandAtLeast`, `bonusHitsWhenOtherHandAtLeast` 구현됨
+- `gainEnergy`, `drawUntilHandSize`, `drawPerDiscarded`, `cardPlayedBlock` 구현됨
+
+## 부분구현
+
+`Ricochet`: 무작위 적 4회 타격이 아니라 일반 분산 공격으로만 처리됨
+
+`Anticipate`: 이번 턴 동안 민첩 2가 아니라 전투 전체 민첩 증가
+
+`PiercingWail`: 이번 턴 적 공격 감소가 아니라 공용 약화/취약 계열만 적용
+
+`Expose`: 방어도/인공물 제거는 없고 취약만 적용됨
+
+`BubbleBubble`: 적이 독을 보유한 경우라는 조건이 아직 없음
+
+`BouncingFlask`: 무작위 적 3번 분산 대신 단일 독 9 처리
+
+## 미구현
+
+`Skewer`: X코스트 연타 공격
+
+`Outbreak`: 독 3번 부여 시 전체 피해 트리거
+
+`Strangle`: 이번 턴 카드 사용마다 추가 피해
+
+`Pounce`: 다음 스킬 카드 비용 0
+
+`Pinpoint`: 이번 턴 스킬 사용 시 비용 감소
+
+`EscapePlan`: 드로우한 카드가 스킬이면 방어도 3
+
+`HandTrick`: 손패의 스킬 카드 하나에 교활 부여
+
+`Mirage`: 모든 적의 독 총합만큼 방어 획득
+
+`UpMySleeve`: 표창 생성 + 비용 감소
+
+`NoxiousFumes`: 턴 시작 전체 적 독 부여 파워
+
+`Accuracy`: 표창 피해 증가 파워
+
+`PhantomBlades`: 표창 보존 + 첫 표창 강화
+
+`Speedster`: 드로우할 때마다 전체 피해
+
+`EchoingSlash`: 처치 시 반복
+
+`TheHunt`: 처치 조건 보상
+
+`Murder`: 이번 전투 동안 뽑은 카드 수 비례 피해
+
+`Malaise`: X코스트 약화/피해 감소
+
+`Shadowmeld`: 이번 턴 얻는 방어도 2배
+
+`CorrosiveWave`: 드로우할 때마다 독
+
+`BladeOfInk`: 전용 표창 생성
+
+`Burst`: 다음 스킬 1회 추가 사용
+
+`KnifeTrap`: 소멸된 표창 전부 사용
+
+`BulletTime`: 드로우 금지 + 손패 무료 사용
+
+`Accelerant`: 추가 독 발동
+
+`Envenom`: 공격 적중 시 독 부여
+
+`MasterPlanner`: 스킬 사용 시 교활 부여
+
+`Tracking`: 약화된 적이 공격 피해를 2배로 받음
+
+`FanOfKnives`: 표창이 모든 적 대상
+
+`SerpentForm`: 카드 사용할 때마다 무작위 적에게 피해
+
+`WraithForm`: 불가침 2 + 턴 종료 시 민첩 감소
+
+## 다음 축
+
+- 조건부 피해
+- 카드 사용 트리거
+- 비용/X코스트
+- 드로우 연동 파워
+

docs/card-effect-fields.md

@@ -0,0 +1,84 @@
+# Card Effect Fields
+
+`data/cards.json`의 카드 효과를 공용 데이터 필드로 표현하는 기준 문서입니다.
+
+## 피해 수치
+
+- `damage`: 기본 피해
+- `damagePerOtherHandCard`: 손패의 다른 카드 수만큼 피해 증감
+- `damagePerAttackPlayedThisTurn`: 이번 턴에 사용한 공격 카드 수만큼 피해 증감
+- `damagePerDiscardedThisTurn`: 이번 턴에 버린 카드 수만큼 피해 증감
+- `damagePerSkillInHand`: 손패의 스킬 카드 수만큼 피해 증감
+- `otherHandAtLeast`: 손패의 다른 카드가 이 수 이상일 때 조건 충족
+- `bonusHitsWhenOtherHandAtLeast`: 조건 충족 시 추가 적중 수
+
+## 방어/상태
+
+- `block`: 방어도 획득
+- `cardPlayedBlock`: 카드를 사용할 때마다 방어도 획득
+- `hits`: 다단히트 횟수
+- `aoe`: 모든 적 대상
+- `pierce`: 방어도 무시
+- `draw`: 즉시 드로우
+- `drawUntilHandSize`: 손패가 지정 장수에 도달할 때까지 드로우
+- `heal`: 즉시 회복
+- `gainEnergy`: 즉시 에너지 획득
+- `strength`: 힘 획득
+- `dex`: 민첩 획득
+- `thorns`: 가시 획득
+- `selfVuln`: 자신에게 취약 부여
+
+## 상태이상
+
+- `weak`: 약화 부여
+- `vuln`: 취약 부여
+- `poison`: 중독 부여
+
+`poison`은 적 턴 시작 시 피해를 주고 1 감소합니다.
+
+## 드로우/버리기
+
+- `discard`: 손패에서 지정 장수 버리기
+- `discardAll`: 손패 전부 버리기
+- `drawPerDiscarded`: 버린 카드 1장당 추가 드로우
+- `addShiv`: 표창 생성
+- `addShivPerDiscard`: 버린 장수만큼 표창 생성
+- `sly`: 버려질 때 교활 발동
+- `retain`: 턴 종료 시 해당 카드 보존
+
+## 파워/턴 효과
+
+- `powerEffect: "strengthPerTurn"`
+- `powerEffect: "energyPerTurn"`
+- `powerEffect: "blockPerTurn"`
+- `powerEffect: "retainOne"`
+- `turnStartShiv`: 턴 시작 시 표창 생성
+- `turnStartDraw`: 턴 시작 시 추가 드로우
+- `turnStartDiscard`: 턴 시작 시 카드 버리기
+
+## 다음 턴 예약
+
+- `nextTurnBlock`: 다음 턴 시작 시 방어도 획득
+- `nextTurnDraw`: 다음 턴 시작 시 추가 드로우
+- `nextTurnKeepBlock`: 다음 턴 시작 시 기존 방어도 유지
+- `nextTurnAttackMultiplier`: 다음 턴 공격 피해 배수
+- `nextTurnCopies`: 다음 턴에 손패에서 가져올 복사본 수
+- `nextTurnSelectHandCard`: 현재 손패에서 카드 1장 선택
+- `nextTurnSelectPrompt`: 선택 UI 문구
+
+## 기타
+
+- `innate`: 전투 시작 시 첫 손패에 우선 진입
+- `playableWhenDrawPileEmpty`: 뽑을 카드 더미가 비었을 때만 사용 가능
+- `exhaust`: 사용 후 소멸
+- `unplayable`: 사용 불가
+- `curse`: 저주 카드
+- `token`: 토큰 카드
+- `endTurnDamage`: 턴 종료 시 손패에 있으면 피해
+
+## 사용 원칙
+
+- 카드 전용 분기보다 공용 필드를 먼저 쓴다.
+- 같은 효과는 같은 필드로 재사용한다.
+- 새 카드가 같은 패턴이면 먼저 공용 필드를 추가한다.
+

docs/codex-workflow.md

@@ -0,0 +1,31 @@
+# Codex Workflow
+
+이 저장소에서 작업할 때는 토큰과 변경량을 아끼는 쪽을 기본으로 둔다.
+
+## 작업 원칙
+
+- 이미 확인한 사실은 다시 읽지 않는다.
+- 같은 내용을 통째로 지우고 새로 쓰지 않는다.
+- 수정은 가능한 한 `apply_patch`로 섹션 단위만 한다.
+- 문서는 전체 재작성보다 부분 수정으로 유지한다.
+- 카드 구현은 한 번에 하나씩, 공용 필드 우선으로 넣는다.
+- 새 기능은 `데이터 1곳 + 런타임 1곳 + 테스트 1곳` 순서로 맞춘다.
+
+## 읽기 원칙
+
+- 파일은 필요한 것만 읽는다.
+- 비슷한 파일은 병렬로 한 번에 확인한다.
+- 같은 정보를 여러 번 요약하지 않는다.
+
+## 쓰기 원칙
+
+- 공용으로 표현 가능한 효과는 카드 전용 분기로 만들지 않는다.
+- 같은 의미의 효과는 같은 필드 이름을 쓴다.
+- 문서는 카드별 상태표와 공용 필드 사전을 분리해서 유지한다.
+
+## 응답 원칙
+
+- 중간 보고는 짧게 한다.
+- 바뀐 점과 남은 점만 말한다.
+- 불필요한 재설명은 줄인다.
+