Plan Restructure (S2 = CTF) + Gnosis CTF Research Note (2026-05-11)

오늘 작업 두 갈래의 스냅샷. 내일 S2.1 milestone (Foundry CTF cycle 테스트) 진입 시 reference로 둠. 이번 commit 이전 대비 변경: docs/plan/README.md 재구성 + docs/plan/gnosis-ctf-research.md 신규.

1. 결정 + 그 이유 — 한눈에

운영자 prior 경험 → CTF 첫 적용 학습비용이 예상보다 낮음 → v1 (parimutuel)을 한 주짜리 scaffold pass로 두고 그 이후 전부 v2로 가는 게 plan 원칙 ("단순하게 시작 / 작게 만들기 / 빠르게 검증") 과 호환되면서 일정도 가속.

2. docs/plan/README.md — 섹션별 변경

§11.4 (EIP-7702)는 변경 없음 — 여전히 S7 트리거.

3. docs/plan/gnosis-ctf-research.md — 신규

S2.1 reading note. ~280줄, 9 섹션:

소스 cross-reference:

• Gnosis ConditionalTokens.sol (287줄)
• Gnosis CTHelpers.sol — position ID 수학
• Polymarket의 IConditionalTokens.sol — 92줄로 압축된 인터페이스
• Polymarket의 AssetOperations.sol — 실제 사용 패턴

4. Q&A 세션 — 부수적으로 다룬 개념들

오늘 사용자가 reading note 읽으면서 던진 명확화 질문들. 일부는 research note에 보충 예정, 일부는 별도 문서로 갈 가능성:

위 Q&A 인사이트 중 일부 (특히 Q4 parentCollectionId, Q6 용어 정의, Q7 NegRisk mental process)는 다음 작업에서 research note에 반영하거나 별도 doc으로 분리 가능.

5. 브랜치 / 커밋 상태

• 현재 브랜치: ctf-exchange (오늘 main에서 분기 생성)
• 이번 commit: 위 변경 + 이 history 항목 + detail doc
• 이전 미커밋 항목: docs/plan/eip-7702-research.md (어제부터 미커밋이었음, 이번 commit에 포함)
• Push: 안 함 (사용자 미요청)

6. 내일 (2026-05-12) 진입 예정

S2.1 milestone artifact를 닫는 일 — Foundry 테스트:

// packages/contracts/test/CTFCycle.t.sol — 신규
contract CTFCycleTest is Test {
    function setUp() public {
        // deploy ConditionalTokens (vendor as submodule from gnosis repo)
        // deploy mock USDC
        // prepareCondition for "Will Brazil win?"
    }

    function test_FullCycle_YesWins() public {
        // 1. splitPosition(USDC, 100) → caller gets 100 YES + 100 NO
        // 2. (skip exchange — direct CTF only)
        // 3. reportPayouts([1, 0]) → YES wins
        // 4. redeemPositions([1])  → 100 USDC back
        // 5. redeemPositions([2])  → 0 USDC (loser, no revert)
        // 6. assert balances at each step
    }

    function test_MergeBeforeResolve() public {
        // verify merge gives back collateral 1:1
    }

    // ... open questions §7 verification
}

후속:

• S2.1 milestone 통과 → S2.2 (Polymarket CTF Exchange import) 진입
• 운영자 prior nostra-contracts 작업이 같은 패턴 한 번 한 경험이라 시간 단축 기대 — 단 nostra와의 차이 (수정점, 채택 안 한 컨벤션)는 별도로 정리 필요

7. 재현 / 검증 절차 (오늘 작업 한정)

# 브랜치 확인
git checkout ctf-exchange
git log --oneline -1   # → 이번 commit

# Plan 변경이 일관되는지 시각적 확인
grep -n 'W[0-9]' docs/plan/README.md   # → 결과 0건 (모두 S#로 변환됨)
grep -n '주차\|10주\|Week' docs/plan/README.md  # → 결과 0건

# Research note 확인
wc -l docs/plan/gnosis-ctf-research.md  # → ~280줄

코드 변경은 0줄 — 이번 commit은 plan + 문서만.