Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion backend/src/main/java/com/restless/drop/AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,9 +27,11 @@ Codex๋Š” ๋ ˆํฌ ๋ฃจํŠธ์—์„œ ์‹คํ–‰ํ•˜๋ฉด ์ด ํŒŒ์ผ์„ ์ž๋™์œผ๋กœ ์ฝ์ง€ ์•Š
- TX1์˜ ํƒ€์ด๋จธ `drop.inventory.hold.update`, `drop.inventory.lock.held`, `drop.reservation.duration`์€ ์„ฑ๋Šฅ ์‹คํ—˜์˜ ์ธก์ • ๊ธฐ์ค€์ด๋‹ค. ์ด๋ฆ„, ํƒœ๊ทธ ๊ฐ’, ์žฌ๋Š” ๊ตฌ๊ฐ„์„ ๋ฐ”๊พธ๋ฉด `docs/domains/drop/transactions.md`์˜ ๊ณ„์ธก ํ‘œ์™€ `backend/src/main/resources/application-perf.yml`์˜ ํžˆ์Šคํ† ๊ทธ๋žจ ์„ค์ •์„ ๊ฐ™์ด ๊ณ ์นœ๋‹ค.
- ๊ฒฐ๊ณผ์™€ ๋ณด๊ณ ์„œ๋Š” ๋ ˆํฌ์— ์˜ฌ๋ฆฌ์ง€ ์•Š๋Š”๋‹ค. ์„ฑ๋Šฅ ์ธก์ • ๊ฒฐ๊ณผ๋Š” `.ai-output/perf/<๋‚ ์งœ>-<์‹คํ—˜>/`์— ๋‘”๋‹ค.
- ๊ธฐ๋ณธ๊ฐ’์ด ์žˆ๋Š” ์„ค์ •(์˜ˆ: `restless.drop.queue.required=true`)์„ ๋ฐ”๊พธ๋ฉด, ๊ทธ ๊ธฐ๋ณธ๊ฐ’์— ๊ธฐ๋Œ€๋Š” ๊ธฐ์กด ํ…Œ์ŠคํŠธ๋ฅผ ์ฐพ์•„ ๊ฐ’์„ ๋ช…์‹œํ•œ๋‹ค.
- ๋ฌธ์„œ์— ์—†๋Š” ์ •์ฑ…์€ ๋ฉˆ์ถ”์ง€ ๋ง๊ณ  ๋ฌธ์„œ์— ๊ฐ€์žฅ ๊ฐ€๊นŒ์šด ์ชฝ์œผ๋กœ ์ •ํ•œ๋‹ค. ์ •ํ•œ ๋‚ด์šฉ์€ ๊ฐ™์€ PR์—์„œ `policy.md`์˜ ํ•ด๋‹น ์ ˆ์— `PROPOSED`๋กœ ๋‚จ๊ธด๋‹ค. ํ•˜๋„ค์Šค ๋‹จ๊ณ„์—์„œ๋Š” Codex๊ฐ€ ๋ณด๊ณ ์„œ์˜ "๋Œ€์‹  ์ •ํ•œ ๊ฒƒ"์— ์ ๊ณ  Claude๊ฐ€ ์˜ฎ๊ธด๋‹ค.
- ๋ฌธ์„œ์— ์—†๋Š” ์‚ฌํ•ญ์˜ ๊ฒฐ์ • ๋ฒ”์œ„๋Š” `docs/testing/independent-verification.md`์˜ ์ •์ฑ… ๊ฒฐ์ • ํ‘œ๋ฅผ ๋”ฐ๋ฅธ๋‹ค. ๋‚ด๋ถ€ ๊ตฌํ˜„ ์„ ํƒ์€ ์ง„ํ–‰ํ•˜๊ณ  ๊ธฐ๋กํ•œ๋‹ค. ๊ณต๊ฐœ ๊ณ„์•ฝยทํ•ต์‹ฌ ๋ถˆ๋ณ€์‹ยท์‚ฌ์—… ์ •์ฑ…๊ณผ ์—ด๋ฆฐ ์งˆ๋ฌธ์€ ์‚ฌ๋žŒ์˜ ๊ฒฐ์ • ์ „ ํ™•์ •ํ•˜์ง€ ์•Š๋Š”๋‹ค. `PROPOSED`๋Š” ์Šน์ธ์ด ์•„๋‹ˆ๋‹ค.

## ๊ฒ€์ฆ (`backend/`์—์„œ)

๊ตฌํ˜„ ๊ฒ€์ฆยทPR ์Šน์ธ ์ค€๋น„ ์ „์— ์ €์žฅ์†Œ ๋ฃจํŠธ์˜ `tools/verification/skills/independent-verification/SKILL.md`๋ฅผ ์ฝ๊ณ  ๋”ฐ๋ฅธ๋‹ค. Codex์™€ Claude ๋ชจ๋‘ commitยทpushยทPR์„ ์ˆ˜ํ–‰ํ•  ์ˆ˜ ์žˆ๋‹ค. ๊ตฌํ˜„๊ณผ ๋…๋ฆฝ ๊ฒ€์ฆ์˜ ๋ถ„๋ฆฌ๋Š” ์œ ์ง€ํ•œ๋‹ค.

- ๋“œ๋กญ ํ…Œ์ŠคํŠธ: `./gradlew test --tests 'com.restless.drop.*'`
- ๋ชจ๋“ˆ ๊ฒฝ๊ณ„: `./gradlew test --tests 'com.restless.architecture.*'`
1 change: 1 addition & 0 deletions docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,7 @@
| ๊ฒฝ๋งค ๋“ฑ๋ก, ์ž…์ฐฐ, ์ข…๋ฃŒ, ํฌ๋ ˆ๋”ง | domains/auction/ ์ „์ฒด (design.md๋Š” ์›๋ณธ), contracts/api/auction.md |
| ํŒฌ๋ฏธํŒ… ์‘๋ชจ, ์ถ”์ฒจ, ๊ฒฐ์ œ, ์Šน๊ฒฉ | domains/fanmeeting/ ์ „์ฒด, contracts/api/fanmeeting.md, contracts/events/fanmeeting.md |
| ํ…Œ์ŠคํŠธ ์ž‘์„ฑ | testing/strategy.md, ํ•ด๋‹น ๋„๋ฉ”์ธ invariants.md (ํŒฌ๋ฏธํŒ…์€ test-scenarios.md๋„) |
| AI ๊ตฌํ˜„ ๊ฒ€์ฆยทPR ์Šน์ธ ์ค€๋น„ | [๋…๋ฆฝ ๊ฒ€์ฆ ์ ˆ์ฐจ์™€ ํ•„์ˆ˜ ์Šคํ‚ฌ](testing/independent-verification.md) |
| ์„ฑ๋Šฅ ์‹คํ—˜ | testing/performance.md, [๋“œ๋กญ ๋ชฉํ‘œ](testing/drop-performance-plan.md)ยท[์‹คํ–‰](testing/drop-performance-procedure.md)ยท[์ธก์ • ๊ทœ์•ฝ](testing/drop-performance-measurement.md), ๊ด€๋ จ ADR |
| ์„œ๋น„์Šค ์˜๋„, ์‚ฌ์šฉ์ž ์‹œ๋‚˜๋ฆฌ์˜ค, ๋ฒ”์œ„, ์—ญํ• , ์™„๋ฃŒ๊ธฐ์ค€ | [product/proposal.md](product/proposal.md) |
| ์ •์ฑ…์ด ์• ๋งคํ•  ๋•Œ | product/open-questions.md (๋ชฉ๋ก์— ์žˆ์œผ๋ฉด ์ž„์˜๋กœ ์ •ํ•˜์ง€ ์•Š๋Š”๋‹ค) |
Expand Down
44 changes: 44 additions & 0 deletions docs/testing/independent-verification.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
# AI ๋…๋ฆฝ ๊ฒ€์ฆ ์ ˆ์ฐจ

๊ตฌํ˜„ ์™„๋ฃŒ ๊ฒ€ํ† ์™€ PR ์Šน์ธ ์ค€๋น„ ์‹œ [์ „์šฉ ์Šคํ‚ฌ](../../tools/verification/skills/independent-verification/SKILL.md)์„ **์ง์ ‘ ์ฝ๊ณ  ์‹คํ–‰ํ•œ๋‹ค**. ๊ฐœ์ธ ์ „์—ญ ์Šคํ‚ฌ ์„ค์น˜๋Š” ํ•„์š” ์—†๋‹ค. ๊ธฐ์กด `code-review`๋ฅผ ์‚ฌ์šฉํ•ด๋„ ์ด ์Šคํ‚ฌ์˜ ์‚ฌ์ „ ๋ฐ˜๋ก€์™€ Assumptions ๊ฒ€ํ† ๋ฅผ ๋จผ์ €/ํ•จ๊ป˜ ์ˆ˜ํ–‰ํ•œ๋‹ค. ํ…Œ์ŠคํŠธ ์‹คํ–‰ยทํ•˜๋„ค์Šค ํŒ์ •์€ ๊ธฐ์กด ์ ˆ์ฐจ๋ฅผ ๋Œ€์ฒดํ•˜์ง€ ์•Š๋Š”๋‹ค.

## ์‚ฌ์šฉํ•˜๊ธฐ

์ƒˆ ์„ธ์…˜์— ๋‹ค์Œ์ฒ˜๋Ÿผ ์š”๊ตฌ์‚ฌํ•ญ๊ณผ ์ •ํ™•ํ•œ ref/SHA๋ฅผ ์ „๋‹ฌํ•œ๋‹ค. ๊ตฌํ˜„ ๋ณด๊ณ ์„œ๋Š” ์‚ฌ์ „ ๋ฐ˜๋ก€ ๊ธฐ๋ก ๋’ค ์ „๋‹ฌํ•œ๋‹ค.

```text
์ด์Šˆ #N์˜ ์š”๊ตฌ์‚ฌํ•ญ๊ณผ ์ €์žฅ์†Œ ์ง€์นจ์œผ๋กœ ๊ฒ€์ฆํ•˜๋ผ.
๊ธฐ์ค€: <base SHA>, ๋Œ€์ƒ: <head SHA>.
tools/verification/skills/independent-verification/SKILL.md๋ฅผ ์ฝ๊ณ  ๋”ฐ๋ฅธ๋‹ค.
๋จผ์ € precheck.md๋ฅผ ์ž‘์„ฑํ•˜๋ผ. ์ดํ›„ diff์™€ ๊ตฌํ˜„ ๋ณด๊ณ ์„œ๋ฅผ ๋Œ€์กฐํ•˜๊ณ  ์ง์ ‘ ๊ฒ€์ฆํ•˜๋ผ.
```

์ด ํŒŒ์ผ๊ณผ ์Šคํ‚ฌ์ด ์ €์žฅ์†Œ์˜ ๋ฐฐํฌ๋ณธ์ด๋‹ค. ์ƒˆ checkout์—์„œ๋„ ์œ„ ์ƒ๋Œ€ ๊ฒฝ๋กœ๋ฅผ ์ฝ๋Š”๋‹ค. ๋“œ๋กญ AGENTS.md์™€ ๋ฌธ์„œ ์ƒ‰์ธ์—์„œ ์—ฐ๊ฒฐํ•œ๋‹ค. ๋ฃจํŠธ AGENTS.md/CLAUDE.md์™€ ํ•˜๋„ค์Šค๋Š” ๊ฐœ์ธ ํŒŒ์ผ์ด๋ฏ€๋กœ ๋‹ค๋ฅธ PC์—์„œ๋Š” ์•„๋ž˜ ๊ฐœ์ธ ์„ค์ •์„ ๋ณ„๋„๋กœ ์ ์šฉํ•œ๋‹ค.

## ์ •์ฑ… ๊ฒฐ์ • ๋ฒ”์œ„ (์ด๋ฒˆ PR์˜ ์ ˆ์ฐจ ์ œ์•ˆ)

๊ธฐ์กด ๋ฃจํŠธ ์ง€์นจ์˜ ๊ณต๊ฐœ ๊ณ„์•ฝยทํ•ต์‹ฌ ๋ถˆ๋ณ€์‹ ๋ณดํ˜ธ์™€ ์—ด๋ฆฐ ์งˆ๋ฌธ์˜ ์‚ฌ๋žŒ ๊ฒฐ์ • ์›์น™์„ ์œ ์ง€ํ•œ๋‹ค. ๋“œ๋กญ ์ง€์นจ์˜ โ€œ๋ฌธ์„œ์— ์—†๋Š” ์ •์ฑ…์€ ์ •ํ•ด ์ง„ํ–‰โ€์€ ์•„๋ž˜ ๊ตฌํ˜„ ์„ธ๋ถ€์‚ฌํ•ญ์œผ๋กœ ํ•œ์ •ํ•˜๋„๋ก ์ œ์•ˆํ•œ๋‹ค. ์‚ฌ์—… ์ •์ฑ…์„ ์ด ๋ฌธ์„œ์—์„œ ํ™•์ •ํ•˜์ง€ ์•Š๋Š”๋‹ค.

| ๊ตฌ๋ถ„ | ์ฒ˜๋ฆฌ |
|---|---|
| ๊ด€์ฐฐ ๊ฐ€๋Šฅํ•œ ๋™์ž‘ยท๊ณ„์•ฝยท๋ถˆ๋ณ€์‹์„ ๋ฐ”๊พธ์ง€ ์•Š๋Š” ๋‚ด๋ถ€ ๊ตฌํ˜„ ์„ ํƒ | ์ง„ํ–‰ํ•˜๊ณ  ๊ทผ๊ฑฐ๋ฅผ ๊ธฐ๋ก |
| ๊ธฐ์กด ํ•ฉ์˜ ๋ฌธ์„œ๋ผ๋ฆฌ ์ถฉ๋Œํ•˜๊ฑฐ๋‚˜ ์š”๊ตฌ์‚ฌํ•ญ ๋ˆ„๋ฝ์ด ์™ธ๋ถ€ ๋™์ž‘์„ ๋ฐ”๊ฟˆ | ์Ÿ์ ๊ณผ ๋Œ€์•ˆ์„ ๊ธฐ๋กํ•˜๊ณ  ์˜ํ–ฅ ์—†๋Š” ์ž‘์—…๋งŒ ์ง„ํ–‰; ์˜ํ–ฅ๋ฐ›๋Š” ๋™์ž‘์€ ๊ฒฐ์ • ์ „ ํ™•์ •ํ•˜์ง€ ์•Š์Œ |
| ๊ธˆ์•กยท๊ตฌ๋งค ์ž๊ฒฉยท์žฌ๊ณ  ์†Œ์œ ยท๊ฒฐ์ œ UNKNOWNยทํ™˜๋ถˆยท๊ณต๊ฐœ ๊ณ„์•ฝยทํ•ต์‹ฌ ๋ถˆ๋ณ€์‹ยทopen-questions | ์‚ฌ๋žŒ์˜ ๊ฒฐ์ • ํ•„์š”. ๊ธฐ์กด ํ•ฉ์˜๋œ ์•ˆ์ „ ๊ทœ์น™ ์œ ์ง€. PROPOSED ํ‘œ๊ธฐ๋Š” ์Šน์ธ ์•„๋‹˜ |

## ๊ฐœ์ธ ํ•˜๋„ค์Šค์™€ ๊ถŒํ•œ ์„ค์ •

์‚ฌ์šฉ์ž ์Šน์ธ์œผ๋กœ Codex์™€ Claude ๋ชจ๋‘ ์ผ๋ฐ˜ commitยทpushยทPR์„ ์ˆ˜ํ–‰ํ•  ์ˆ˜ ์žˆ๋‹ค. ํ•˜๋„ค์Šคยท๊ฒ€์ฆ ๋„๊ตฌ์™€ ์—์ด์ „ํŠธ ์ง€์นจ์˜ ํŒจ์น˜ ํŽธ์ง‘์€ `chore/drop-<issue>-harness` ๋ธŒ๋žœ์น˜์—์„œ ํ—ˆ์šฉํ•œ๋‹ค. ๋‹ค๋ฅธ ๋ธŒ๋žœ์น˜์˜ ์ˆ˜์šฉ ํ…Œ์ŠคํŠธยท๊ฒ€์ฆ ์Šคํ‚ฌ ๋ณดํ˜ธ, ๋จธ์ง€๋œ ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜ ๋ณดํ˜ธ, hook ์šฐํšŒ ๊ธˆ์ง€๋Š” ์œ ์ง€ํ•œ๋‹ค. `HARNESS_EDIT`๋„ ํ•˜๋„ค์Šค ๋ธŒ๋žœ์น˜์—์„œ๋งŒ ํ—ˆ์šฉํ•œ๋‹ค. PR ์ƒ์„ฑ ๊ถŒํ•œ์€ ๋…๋ฆฝ ๊ฒ€์ฆ ์™„๋ฃŒ๋ฅผ ๋œปํ•˜์ง€ ์•Š๋Š”๋‹ค.

ํ˜„์žฌ PC์˜ ๊ฐœ์ธ ํ•˜๋„ค์Šคยท๋ฃจํŠธ ์ง€์นจ์—๋Š” ๋ฐ˜์˜ํ–ˆ๋‹ค. [integration.patch](../../tools/verification/integration.patch)๋Š” Git ์ œ์™ธ๋œ ๊ฐœ์ธ ํ•˜๋„ค์Šค ๋ณ€๊ฒฝ์˜ ๋ฐฐํฌ๋ณธ์ด๋‹ค. ๊ฐ™์€ ์ด์ „ ๋ฒ„์ „์˜ ์‚ฌ๋ณธ์„ ๊ฐ€์ง„ ๋‹ค๋ฅธ PC์—์„œ `git apply --check tools/verification/integration.patch`๋กœ ํ™•์ธ ํ›„ ์ ์šฉํ•œ๋‹ค. ์ด๋ฏธ ์ ์šฉ๋œ PC์—์„œ๋Š” `git apply --reverse --check tools/verification/integration.patch`๋กœ ๋Œ€์กฐํ•œ๋‹ค. ํ•˜๋„ค์Šค๊ฐ€ ์—†๋Š” ์ƒˆ checkout์—๋Š” ์ด ํŒจ์น˜๋ฅผ ์ ์šฉํ•  ์ˆ˜ ์—†๋‹ค. Git์— ํฌํ•จ๋œ ๋“œ๋กญ ์ง€์นจ์€ ํŒจ์น˜ ๋Œ€์ƒ์—์„œ ์ œ์™ธํ•ด ์ด์ค‘ ์ ์šฉ์„ ํ”ผํ•œ๋‹ค. ๊ฐœ์ธ ๋ฃจํŠธ AGENTS.md์—๋Š” ๋‹ค์Œ ํฌ์ธํ„ฐ๋ฅผ ์ถ”๊ฐ€ํ•œ๋‹ค.

> ๊ตฌํ˜„ ๊ฒ€์ฆยทPR ์Šน์ธ ์ค€๋น„ ์ „์— `tools/verification/skills/independent-verification/SKILL.md`๋ฅผ ์ฝ๊ณ  ๋”ฐ๋ฅธ๋‹ค. ๋ฌธ์„œ์— ์—†๋Š” ์ •์ฑ…์˜ ๊ฒฐ์ • ๋ฒ”์œ„๋Š” `docs/testing/independent-verification.md`๋ฅผ ๋”ฐ๋ฅธ๋‹ค. Codex์™€ Claude ๋ชจ๋‘ commitยทpushยทPR์„ ์ˆ˜ํ–‰ํ•  ์ˆ˜ ์žˆ๋‹ค. ํ•˜๋„ค์Šคยท๊ฒ€์ฆ ๋„๊ตฌ์™€ ์ง€์นจ ํŽธ์ง‘์€ ํ•˜๋„ค์Šค ๋ธŒ๋žœ์น˜์—์„œ ํ•œ๋‹ค.

๊ฒ€์ฆ ๊ฒฝ๋กœ๋Š” ๊ฐ€๋“œ์˜ ํŒจ์น˜ยท์…ธ ๊ฒ€์‚ฌ์™€ ์ตœ์ข… ํ•˜๋„ค์Šค diff ๊ฒ€์‚ฌ์— ์ถ”๊ฐ€ํ–ˆ๋‹ค. ๊ฐ€๋“œ๋Š” ๋ธŒ๋žœ์น˜ ์ด๋ฆ„์œผ๋กœ ํŽธ์ง‘ ๋ฒ”์œ„๋ฅผ ๊ตฌ๋ถ„ํ•œ๋‹ค. ๋ณ„๋„์˜ OS ๊ถŒํ•œ ๋ถ„๋ฆฌ๋‚˜ ์‚ฌ๋žŒ์ด ์Šน์ธํ•œ ๋ณดํ˜ธ ๋ธŒ๋žœ์น˜๋ฅผ ๋Œ€์ฒดํ•˜์ง€ ์•Š์œผ๋ฉฐ, ์‚ฌ์šฉ์ž๊ฐ€ ์ฝ์œผ๋ผ๊ณ  ์ง€์‹œํ•˜์ง€ ์•Š์€ ์ƒˆ ํ™˜๊ฒฝ์—์„œ ์Šคํ‚ฌ ์ž๋™ ํ˜ธ์ถœ์„ ๋ณด์žฅํ•˜์ง€ ์•Š๋Š”๋‹ค.

## ์‚ฌ๋žŒ์ด PR์—์„œ ๊ฒฐ์ •ํ•  ๊ฒƒ

1. ์œ„ ๊ตฌํ˜„ ์„ ํƒ/์‚ฌ์—… ์ •์ฑ… ๊ฒฝ๊ณ„๋ฅผ ์ฑ„ํƒํ• ์ง€.
2. ๋™์ผ ๊ตฌํ˜„์ž์˜ ์˜ˆ์™ธ๋Š” ์ƒˆ ์ปจํ…์ŠคํŠธ ๊ฒ€์ฆ์ž ๋˜๋Š” ์‚ฌ๋žŒ ๊ฒ€ํ† ๋ฅผ ์ถ”๊ฐ€ํ•ด์•ผ ์™„๋ฃŒ๋กœ ๋ณผ์ง€.
3. ๊ฐœ์ธ ํ•˜๋„ค์Šค ๋ฐฐํฌ๋ณธ์„ ๋‹ค๋ฅธ PC์—๋„ ์ ์šฉํ• ์ง€, ํŒ€ ๊ณต์šฉ ๋„๊ตฌ๋กœ ์ „ํ™˜ํ• ์ง€.

๊ฒ€์ฆ ์˜ˆ์‹œยท์‹คํ–‰ ๊ฒฐ๊ณผ๋Š” `.ai-output/verification-251/`์— ๋ณด๊ด€ํ•˜๊ณ  PR์— ์š”์•ฝํ•œ๋‹ค. ์‹œ๋ฎฌ๋ ˆ์ด์…˜์€ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ํ…Œ์ŠคํŠธ ํ†ต๊ณผ์˜ ์ฆ๊ฑฐ๊ฐ€ ์•„๋‹ˆ๋‹ค.
Loading
Loading