Skip to content

PLAN.md

Latest commit

 

History

History
55 lines (43 loc) · 2.78 KB

PLAN.md

File metadata and controls

55 lines (43 loc) · 2.78 KB
Raw

vbuilder Plan

AI-maintained MEV block builder, forked from flashbots/rbuilder.

Status

Phase Title Status Plan
1 Foundation completed 000 - Origin Plan
2 CI/CD Upgrade completed 000 - Origin Plan
3 Bot Deployment completed 000 - Origin Plan
4 Testing Harness completed 000 - Origin Plan
5 Self-Improvement completed 000 - Origin Plan

Quick Links

Current Priorities

  1. 001 - Integration Test Scenarios — bundle inclusion, cancellation, bid value tests
  2. Upstream sync — first sync with flashbots/rbuilder (see .ai/upstream-sync.md)
  3. Agent-driven issues — label issues with claude or agent-safe to start autonomous development

Decision Framework

When making implementation decisions, prefer:

  • Safety first - Never compromise relay submission guards, blocklist checks, or key management
  • Upstream compatibility - Minimize divergence from flashbots/rbuilder
  • AI-friendly - Optimize for agent comprehension (explicit over implicit, tables over prose)
  • Incremental - Each PR should be independently reviewable and revertable

Repository Structure

vbuilder/
├── PLAN.md                  # This file - project dashboard
├── CLAUDE.md                # Agent instructions
├── docs/
│   ├── plans/               # Implementation plans
│   └── sessions/            # Agent session logs
├── .ai/                     # Agent context docs
│   ├── architecture.md      # LiveBuilder pipeline and crate map
│   ├── testing.md           # 3-tier testing strategy
│   ├── safety.md            # Safety-critical paths and rules
│   └── upstream-sync.md     # Upstream sync strategy and divergence tracking
├── .claude/commands/        # Custom slash commands (test, lint, new-plan, session-log)
├── crates/                  # Rust workspace crates
├── scripts/                 # Build and test scripts
└── .github/workflows/       # CI/CD workflows