Skip to content

ECO-144: Create AI-augmented v4 hook guide - #1146

Draft
wkoutre wants to merge 2 commits into
Uniswap:mainfrom
wkoutre:nickkoutrelakos/eco-144-create-ai-augmented-v4-hook-guide-v4-template-uniswap-ai
Draft

ECO-144: Create AI-augmented v4 hook guide#1146
wkoutre wants to merge 2 commits into
Uniswap:mainfrom
wkoutre:nickkoutrelakos/eco-144-create-ai-augmented-v4-hook-guide-v4-template-uniswap-ai

Conversation

@wkoutre

@wkoutre wkoutre commented Aug 9, 2026

Copy link
Copy Markdown

Summary

Adds a new guide, content/protocols/v4/guides/hooks/ai-augmented-hook-development.mdx, that walks a developer through the full v4 hook lifecycle — scaffold, implement, test, audit, deploy — using an AI coding agent alongside the official v4-template.

  • Backed entirely by two existing Uniswap AI skills (no new skills introduced): v4-security-foundations for the scaffold/audit steps, viem-integration for the deploy step.
  • Prompts are agent-agnostic plain text — not Claude-specific — per the ticket's acceptance criteria.
  • Cross-linked from the existing Hooks Overview guide and registered in the Hooks section's meta.json nav.
  • The deploy-step prompt mines a CREATE2 salt through the deployer proxy (rather than a plain CREATE), matching the convention already documented in the sibling hook-deployment.mdx guide — required because v4 hook addresses must encode their permission flags.

Linear: https://linear.app/uniswap/issue/ECO-144/create-ai-augmented-v4-hook-guide-v4-template-uniswap-ai

Autonomously generated by the Linear Task Worker. Reviewed by an independent code-reviewer pass before this PR was opened (findings addressed in the second commit).

Test plan

  • Content-only change — no build in this repo (README/CONTRIBUTING note this repo mirrors content into a separate publishing pipeline).
  • Verified internal links (/docs/...) resolve to existing pages in content/.
  • Verified frontmatter (title/description) and meta.json conventions match sibling pages.
  • Nick: confirm placement/scope is right given the parent epic ECO-152 (Use Case Guides) targets this same "Hooks / Guides" section with a more granular 4-page breakdown — this PR ships ECO-144's own single comprehensive-guide scope instead, since ECO-144 only lists ECO-152 as relatedTo, not a blocker.

wkoutre added 2 commits August 8, 2026 18:09
Adds a guide that walks through the full v4 hook lifecycle (scaffold,
implement, test, audit, deploy) using an AI coding agent alongside the
v4-template, backed by the existing v4-security-foundations and
viem-integration skills. Prompts are agent-agnostic plain text, not
Claude-specific.

Closes ECO-144.
- Deploy prompt now mines a CREATE2 salt through the deployer proxy
  instead of a plain CREATE deploy, which would produce a hook address
  that doesn't encode the enabled permission flags.
- Clarify that neither sender nor hookData is trustworthy for user
  identity without router allowlisting, and link the existing
  accessing-msg.sender guide.
- Move the OpenZeppelin base-contract customization tip to Step 1
  (scaffold), where base-contract choice actually happens.
@github-actions

github-actions Bot commented Aug 9, 2026

Copy link
Copy Markdown

Thanks for contributing to Uniswap Docs! 🦄

Quick heads up on how this repo works: the docs you see on developers.uniswap.org are built from a separate source repo. When we accept a change here, we port it over there, so your fix might show up on the live site before it lands in this repo.

Updates to this repo come in batches on a regular cadence. When yours is included, you'll be credited as a co-author on the commit, so the contribution counts on your GitHub profile and in Uniswap/docs.

We review every PR but can't merge everything. Either way, someone from the docs team will follow up here once we've taken a look.

One legal bit: by submitting a PR you agree your contribution is licensed under the repo's MIT license.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant