vx/AGENTS.md

AGENTS.md

Purpose

This document defines mandatory development rules for contributors and automated agents working on the VX Multicall Utility.

All code changes must comply with the policies below.

---

1. No Stubs

Stubs are not allowed.

Do not:

• Add placeholder functions
• Leave partially implemented logic
• Add empty modules “for later”
• Return dummy values to satisfy the compiler

All submitted code must:

• Be fully implemented
• Compile cleanly
• Function as described
• Pass relevant tests

If a feature is not ready, do not merge it.

2. No Dead Code

Do not introduce:

• Unused structs
• Unused enums
• Unused functions
• Unused modules
• Commented-out code
• Remove makefiles etc in freshly copied BSD sources

Remove obsolete code instead of commenting it out.

3. Deterministic Behavior

VX Multicall Utility requires reproducibility.

All logic must:

• Avoid non-deterministic behavior
• Avoid reliance on environment state unless explicitly defined
• Avoid hidden global state

4. Testing

New features must include:

• add tests for new functionality
• ensure existing tests pass

---

Summary

VX Multicall Utility is infrastructure.

Code must be:

• Complete
• Deterministic
• Secure
• Minimal
• Explicit

No shortcuts.