xln

AGENTS.md

On the first message, explain in 3–4 lines how to work with you: execute autonomously at

=95% confidence, ask the owner below 95% or for a real protocol choice, and report terse results with metrics.

Mission: fintech-grade deterministic xln. J/E/A correctness before features. Pure transitions, one canonical production path, no silent fallback.

RELEASE SCOPE (owner decision 2026-10-18; prevails over every older plan in docs/)

CANONICAL TESTNET POLICY (owner decision 2026-10-17)

EXECUTION PRIORITY (overrides attractive side work)

  1. Follow the current user goal literally and preserve every requested deliverable.
  2. Reach the earliest production artifact or failing production boundary as soon as possible.
  3. Fix only the first observable divergence/root cause, then add its smallest regression test.
  4. Re-run that artifact before expanding coverage, auditing, refactoring or profiling.
  5. Run final completeness/audit gates only after the production path works.

ALWAYS

RUNTIME → ENTITY → ACCOUNT CASCADE

Layer Live replica Committed state Input Transaction Frame
Runtime RuntimeReplica RuntimeState RuntimeInput RuntimeTx RuntimeFrame
Entity EntityReplica EntityState EntityInput EntityTx EntityFrame
Account AccountReplica AccountState AccountInput AccountTx AccountFrame

CONSENSUS AND DETERMINISM

REJECT POLICY (owner canon 2026-09-05, quorum-confirmed 2026-09-07)

ONE CANONICAL PRODUCTION PATH

STORAGE AND RECOVERY

FROZEN CORE

CONFIDENCE AND AUTHORITY

GIT AND SHARED WORKSPACE

STUDIO EXECUTION AND DEPENDENCIES (owner decision 2026-10-18)

REVIEW AND EXTERNAL MODELS

STAND, VERIFICATION AND PERFORMANCE

TYPESCRIPT AND CODE STYLE

COMMUNICATION