State Contract

Read, validate, and update the AoT Loop state file with deterministic scripts.

1|1|Updated Dec 31, 2025
One-click install
npx skills add https://github.com/yodakeisuke/ralph-wiggum-aot --skill state-contract
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: State Contract
Source: https://github.com/yodakeisuke/ralph-wiggum-aot/tree/main/skills/state-contract
Command: npx skills add https://github.com/yodakeisuke/ralph-wiggum-aot --skill state-contract

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill provides a robust set of utilities and scripts to read, validate, and update the AoT Loop's state file, ensuring integrity.

Core Features & Use Cases

  • Deterministic scripts: read_state, update_atom, add_binding, set_status, verify, etc.
  • Validation: validate_state, verify_checklist to ensure state structure integrity.
  • Guided automation: supports commands like /align-goal, /enter-recursion with safe state updates.

Quick Start

Start by inspecting .claude/aot-loop-state.md with read_state.py, then update Atoms and add Bindings with the respective scripts.