simulation-invariant-auditor

Audit deterministic invariants in tick-based, event-sourced simulation systems.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Hawi254/transport_tycoon_sim --skill simulation-invariant-auditor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: simulation-invariant-auditor
Source: https://github.com/Hawi254/transport_tycoon_sim/tree/main/.agent/skills/simulation-invariant-auditor
Command: npx skills add https://github.com/Hawi254/transport_tycoon_sim --skill simulation-invariant-auditor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Proactively audits simulation logic while coding by collecting real artifacts via terminal access, generating helper scripts for repetitive workflows, and validating deterministic invariants across ticks, events, phases, markets, and resources. Use automatically whenever simulation semantics, ordering, lifecycle, persistence, or replay code is written or modified.

Core Features & Use Cases

  • Discovers real artifacts using terminal commands to support evidence-backed analysis.
  • Writes focused helper scripts for repetitive investigation tasks (artifact discovery, log slicing, event filtering, timelines, replay diffs).
  • Checks deterministic invariants against events and state, identifies earliest root violation, and produces a concise invariant audit report.

Quick Start

Invoke the invariant auditor automatically after modifying simulation logic to verify that invariants still hold before proceeding.

Frequently Asked Questions about simulation-invariant-auditor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify deterministic correctness in event-sourced simulation systems?

You can audit simulation invariants to validate deterministic correctness by checking lawful state transitions and reproducible replay across ticks. The auditor collects real artifacts via terminal commands, generates helper scripts for log slicing and event filtering, and identifies the earliest root invariant violation.

What is an invariant audit for tick-based event sourcing?

An invariant audit for tick-based event sourcing validates that state transitions remain lawful and deterministic during replay. It proactively checks invariants across events, phases, markets, and resources while you are coding or refactoring core simulation logic.

How do I find the root cause of a simulation invariant violation during replay?

Finding the root cause of a simulation invariant violation involves checking deterministic invariants against events and state to identify the earliest root violation. The auditor produces a concise report and provides helper scripts for timeline analysis and replay diffs to isolate the issue.

Can I use this invariant auditor for log analysis and event filtering during refactoring?

Yes, you can use the invariant auditor for log analysis and event filtering during refactoring. It writes focused helper scripts for repetitive investigation tasks, including artifact discovery, log slicing, event filtering, timelines, and replay diffs to support evidence-backed analysis.

When do I need to audit simulation invariants for reproducibility?

You need to audit simulation invariants for reproducibility whenever you modify simulation semantics, ordering, lifecycle, persistence, or replay code. Auditing should be invoked automatically after changing core simulation logic to verify that deterministic invariants still hold before proceeding.

Do I need external dependencies to run deterministic replay checks on event-sourced systems?

No external dependencies are required to run deterministic replay checks on event-sourced systems. The auditor operates without dependencies by using terminal commands to discover real artifacts and generating ready-made scripts for artifact discovery, log slicing, and event filtering.