{
  "version": 1,
  "sharedInterfaces": "Sequential handoff: contract_project supplies pinned Foundry source/tests, docs/abi/<Contract>.json and architecture, threat-model and integration docs with exact pool key, units, rounding, decoded errors and quote/swap/liquidity recipes. The control plane inserts its generated launch manifest before contract_review, then handles verified factory deployment and publication; no worker receives keys, broadcasts, commissions factories/policies or deploys helpers. Frontend additionally waits for actual .imd/reads/deployment.json with verified addresses and ABI hashes, never mocks for production. Sepolia only (11155111), univ4_hook policy v2. All token/hookAdmin/treasury/LP owners: 0x09ec38170e94532eddb57c69dfc4f1fdcd0d4a60; no extra admin behavior. Supply: 80% LP, 10% treasury, 10% contributors, 1h contributor lock and 30% per-wallet cap. Factory seeds up to 8e26 VGL, ZERO ETH; deployer derives widest aligned token-only range from opening price/spacing and rounds liquidity down. Existing configured deployer gas ceiling: 0.3 Sepolia ETH, no extra spending/funding. Authorized destinations: signed publisher's configured GitHub org and configured Pinata/IPFS, automatic repository/site naming; no caller repo/CID required. Services publish real source, receipts, evidence and reachable functional site after submissions; these are service completion gates, not worker prerequisites. No parallel writers or separate research assignments.",
  "steps": [
    {
      "key": "contract_project",
      "skill": "build-contract-project",
      "dependsOn": [],
      "objective": "Build the complete standalone VolatilityGuard Lab Foundry project from the empty source, including initial setup, pinned/vendored ordinary-file dependencies (no submodules), VolatilityGuardHook, VolatilityGuardToken, tests, ABI JSON, documentation and actual validation evidence. This complete-project writer owns project setup and contract deliverables; subsequent writers wait. Set bytecode_hash=none; preserve any protected existing configuration/dependencies if encountered. Implement arbitrary-currency Uniswap v4 hook behavior and the exact VGL/native-ETH launch specification. Verify canonical Sepolia PoolManager 0xe03a1074c86cfedd5c142c4f04f1a1536e203543 and compatible existing verified periphery; no new deployed helper, discretionary admin powers or total-MEV-protection claims. Supply integration inputs for control-plane policy-v2 factory launch without broadcasting. Address blocking review findings within this assignment's source ownership and resubmit for independent review before deployment.",
      "references": ["uniswap-v4-hooks", "uniswap-v4-security", "defi-native", "public-rpcs"],
      "acceptanceCriteria": [
        "VolatilityGuardToken is Volatility Guard Lab (VGL), 18 decimals, no constructor args; fixed 10^27 units minted to deployer, no mint backdoor. Exact pool uses native ETH zero address, VGL, fee 3000, tickSpacing 60 and initial sqrtPriceX96 792281625142643375935439503360000 (0.00000001 ETH/VGL).",
        "Hook isolates every PoolId; bounded observation ring/TWAP and EWMA volatility drive adaptive price-deviation limits and rolling volume budgets resistant to split swaps. NORMAL/WARMUP/GUARDED/RECOVERY, stale and low-liquidity handling and deterministic recovery are specified and tested.",
        "Authenticate canonical PoolManager callbacks and accounting without trusting sender/hookData identity. Define both swap directions, exact-input/output, currency units, conservative rounding, bounded execution and caps. Initialization/warmup cannot brick the pool; LP exits remain possible; reverted swaps cannot be relied on to persist breaker transitions.",
        "Offline build, test and fmt checks pass with all dependencies pinned/vendored. Fuzz/invariant/stress tests exercise accounting, pool isolation, manipulation and split volume, unauthorized callbacks, reentrancy, stale history, edge values, recovery and LP exits; report actual test counts, gas, contract sizes, failures and limitations.",
        "docs/abi/VolatilityGuardHook.json and docs/abi/VolatilityGuardToken.json match source. Architecture/threat-model/integration docs specify exact pool key, hooks/address requirements, supported periphery, real quote/swap/liquidity and supported-position exit recipes, decoded errors and all dashboard read/event units.",
        "Launch inputs preserve policy v2, specified owners, 80/10/10 allocations, contributor lock/cap, token-only seed/range/rounding, canonical PoolManager and existing gas budget. Explain ETH-first bootstrap and that reverse swaps require accrued ETH liquidity; no extra authority, helpers, keys or broadcasts.",
        "Evidence and ABI/integration artifacts are sufficient for generated manifest and independent review. Blocking findings are repaired and re-reviewed before control-plane deployment; no fabricated receipts, results or claims."
      ]
    },
    {
      "key": "contract_review",
      "skill": "adversarial-review",
      "dependsOn": ["contract_project"],
      "objective": "Independently inspect the complete contract source, tests, evidence, ABI/integration docs AND the control-plane-generated launch manifest, read-only. Attack the guard's accounting, economic assumptions, lifecycle and deployment compatibility. Return actionable blocking findings to contract_project for repair and repeat independent review on the repaired source/manifest before authorizing progression. The control plane generates the manifest before this review and performs verified deployment only after all blockers are resolved.",
      "references": ["uniswap-v4-hooks", "uniswap-v4-security"],
      "acceptanceCriteria": [
        "Review covers arbitrary currencies, both directions and exact-input/output, rounding/caps, callback authentication, reentrancy, per-pool isolation, TWAP/EWMA manipulation, split-volume resistance, stale/low-liquidity states, deterministic recovery, revert rollback, warmup and LP exits; examine adversarial test coverage and reported limitations.",
        "Inspect source and generated manifest together for chain 11155111, canonical PoolManager, ABI/bytecode identity, hook permission/address compatibility, exact pool parameters, fixed supply, ownership/allocation/lock/cap, zero-ETH seed range and liquidity rounding, verified existing periphery and 0.3 ETH gas ceiling.",
        "Verify offline checks/evidence, no privileged mint or discretionary admin behavior, no extra helper deployment or spending authorization, and usable integration recipes. Explicitly resolve every blocking finding after producer repair; deployment cannot proceed on unresolved blockers."
      ]
    },
    {
      "key": "frontend",
      "skill": "frontend-for-contract",
      "paths": ["web/**", "dist/**", "docs/**", "package.json", "pnpm-lock.yaml", "package-lock.json", "yarn.lock"],
      "dependsOn": ["contract_review"],
      "objective": "After approved contract review AND actual verified control-plane deployment handoff at .imd/reads/deployment.json, deliver the complete React/Vite/TypeScript dapp using RainbowKit/wagmi/viem in web/, committed relative-base static export in dist/, tests and evidence. Use pinned deployed source, addresses and matching docs/abi/<Contract>.json hashes. Stay within the explicit frontend destination paths; preserve contract ABIs and integration facts when extending docs. Use injected wallets without extra credentials and only existing verified periphery. Finish with source/export/tests; control-plane services handle GitHub/IPFS publication, naming and reachability checks. Repair frontend blockers within this scope for final re-review.",
      "acceptanceCriteria": [
        "Public ETH/VGL swap flow supports amounts, direction, balances/max, real quotes, slippage/minimum received, required approvals and wallet-signed swaps; show transaction progress, decoded errors and explorer links. No fabricated production quotes, addresses or receipts; no private keys or worker broadcasts.",
        "Live dashboard displays tick/TWAP, volatility, deviation, rolling volume, guard state and events from verified deployed contracts. Explain hook behavior, risks and limitations without total-MEV-protection claims; simulation demos are clearly labeled and separate from real transactions.",
        "Explain token-sided bootstrap: buy with ETH first and gate reverse trades on actual accrued ETH liquidity. Provide supported-position exits through verified periphery with no new helper deployments or unrequested admin features.",
        "Meaningful tests cover both directions, bootstrap/reverse-liquidity constraints, wallet and wrong-chain states, rejected signing, guard reverts, funds/RPC errors and responsive UI. Report actual results and limitations; production chain is Sepolia only.",
        "Deliver complete source and tested relative-base dist/ export usable on IPFS, reproducible dependency declarations/lockfile and available offline dependencies needed by verification. Verify ABI hashes against deployment handoff and document integration/test evidence; no service receipts or hosted URL are required to submit worker artifacts."
      ]
    },
    {
      "key": "final_review",
      "skill": "adversarial-review",
      "dependsOn": ["contract_project", "contract_review", "frontend"],
      "objective": "Join the entire workflow with read-only independent review of final source, generated launch manifest, verified deployment handoff, contract/frontend evidence and static export. Check the connected frontend against actual contract interfaces and the approved request. Return blockers to the relevant producer within its existing scope and re-review repairs; contract changes invalidate prior deployment/ABI handoff and require control-plane re-verification before frontend acceptance. Do not publish, deploy, rename sites or require future service receipts. Leave final publication/reachability validation to the control plane.",
      "acceptanceCriteria": [
        "All writers are directly reviewed: deployed contracts/ABI hashes, manifest pool parameters and frontend reads/writes agree; guard errors, quoting, approvals, accounting and supported exits use documented verified periphery. Contract safety findings and frontend blockers are resolved with actual evidence.",
        "Review source and dist/ for complete wallet-connected functionality, real onchain data, ETH-first bootstrap, explicit simulation labeling, risk information and responsive/error-state coverage. Validate that worker outputs enable the authorized GitHub and Pinata/IPFS publication without additional credentials or destination decisions.",
        "Preserve all ownership, allocation, chain, gas budget and destination permissions; exclude mainnet, extra admin behavior, new deployed helpers and fabricated evidence. Overall launch is complete only after control-plane services confirm live verified contracts, published real source/receipts/test evidence and a reachable functional public IPFS dapp."
      ]
    }
  ],
  "questions": []
}
