Draft
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Introduces a comprehensive AI skill (
run-jovian-upgrade) that interactively guides engineers through the complete Jovian upgrade pipeline (v4.1.0 → v5.0.0 → Succinct v2) on a local Anvil fork. The skill orchestrates work across 6 repositories (Celo, Optimism, Optimism2, SuperchainOps, CeloSuperchainOps, Succinct) with checkpoint-based state verification between each upgrade phase.Previously, running the Jovian upgrade locally required deep tribal knowledge of the correct script order, env vars, Safe nonce expectations, branch requirements, and cross-repo dependencies. This skill captures that knowledge in a structured, repeatable workflow that any engineer can follow — even without prior upgrade experience.
The skill covers: fork setup with port conflict handling, Safe multisig mocking, op-deployer bootstrap (v4/v5), Succinct FDG deployment with config-driven vkey population, SuperchainOps simulation, CeloSuperchainOps EIP-712 signing, sequential upgrade execution with 4 on-chain checkpoints, and domain-specific validations (new CeloSuperchainConfig, new ASR, game→ASR pointers, SystemConfig ownership transfer).
Additionally migrates the project knowledge base from the Claude Code-specific
CLAUDE.mdto a provider-agnostic.agent/AGENT.mdstructure, and consolidates all skills under.agent/skills/.Other changes
celo-release,node-cache-update) from.cursor/skills/to.agent/skills/(content unchanged).agent/skillssymlink, replaced with real directory.cursor/skills/directory (content migrated)CLAUDE.mdreplaced with a thin pointer to.agent/AGENT.md— keeps Claude Code compatibility while being LLM-agnostic.agent/AGENT.mdincludes new sections: Repository Dependency Map, Network Configuration Reference (Safe addresses, proxy addresses, fork block numbers), Default Mocked Accounts, X-Ray Health Rules reference, and Upgrade Pipeline TimelineTested
Manually tested the full skill flow end-to-end on a local Anvil fork:
Related issues
Backwards compatibility
No backwards compatibility concerns. This PR only adds new files under
.agent/and modifiesCLAUDE.mdto point to the new location. No existing scripts, contracts, or CI workflows are affected. The migrated skills retain identical content.Documentation
.agent/AGENT.md— Unified project knowledge base (replacesCLAUDE.mdcontent + Jovian ecosystem documentation).agent/skills/run-jovian-upgrade/SKILL.md— Interactive upgrade skill (1045 lines, 6 phases, 4 checkpoints)