uniswap-ai: Instructions file for Claude Code

CLAUDE.md - Uniswap AI Project Guidelines

Overview

This is the uniswap-ai monorepo providing Uniswap-specific AI tools (skills, plugins, agents) for developers and AI agents integrating the Uniswap ecosystem.

Core Requirements

Nx Usage

• REQUIREMENT: Use Nx for ALL packages and tooling in this monorepo
• Every package must be an Nx project with proper configuration
• Use Nx generators, executors, and workspace features wherever possible
• Leverage Nx's dependency graph and caching capabilities

Package Structure

• All packages must be properly configured Nx libraries or applications
• Use Nx's project.json for configuration
• Follow Nx best practices for monorepo organization

Development Workflow

• Use Nx commands for all operations (build, test, lint, etc.)
• Maintain proper inter-package dependencies through Nx
• Ensure all packages are part of the Nx workspace graph

Code Quality Enforcement

Before committing or declaring a change complete, Claude Code MUST:

1. Format the code: Run bunx nx format:write --uncommitted to format all uncommitted files
2. Lint the code: Run bunx nx affected --target=lint --base=HEAD~1 to check for linting errors
3. Typecheck the code: Run bunx nx affected --target=typecheck --base=HEAD~1 to typecheck affected projects
4. Lint markdown files: Run bunx markdownlint-cli2 --fix "**/*.md"
5. Lint documentation prose: Run bun run docs:lint to check documentation quality with Vale. This check blocks CI. Vale flags unknown words, repeated words, and the terms listed in reject.txt; to accept a term it does not know, add it to .github/vale/styles/config/vocabularies/Uniswap/accept.txt

Package Scopes

Type	Scope	npm	Marketplace
Plugins	@uniswap	No	Yes (Claude Code Marketplace)

Repository Structure

uniswap-ai/
├── .github/
│   ├── workflows/           # CI/CD workflows
│   ├── actions/             # Reusable composite actions
│   └── scripts/             # CI scripts
├── .claude-plugin/
│   └── marketplace.json     # Claude Code marketplace config
├── .claude/
│   └── rules/               # Agent rules (agnostic design)
├── docs/                    # VitePress documentation
├── evals/                   # AI tool evaluations (Promptfoo)
│   ├── rubrics/             # Shared evaluation rubrics
│   ├── scripts/             # Custom providers and utilities
│   ├── suites/              # Per-skill eval suites
│   └── templates/           # Templates for new suites
├── packages/
│   └── plugins/             # Claude Code plugins
│       ├── uniswap-cca/                 # Continuous Clearing Auction (CCA) plugin
│       ├── uniswap-driver/              # Swap & liquidity deep link planning
│       ├── uniswap-hooks/               # Uniswap v4 hooks plugin
│       ├── uniswap-permissioned-pools/  # Uniswap v4 Permissioned Pools issuer + configurator + deployer
│       ├── uniswap-trading/             # Uniswap swap integration
│       ├── uniswap-trading-tools/       # Automated trading tools (DCA, index, copy-trade)
│       └── uniswap-viem/                # EVM blockchain integration (viem/wagmi)
├── scripts/                 # Build/validation scripts
├── nx.json
├── package.json
├── tsconfig.base.json
├── CLAUDE.md                # This file
├── AGENTS.md -> CLAUDE.md   # Symlink for agent-agnostic access
├── LICENSE                  # MIT
└── README.md