event-flow-tracer

Reconstruct causal command-to-projection sequences from terminal artifacts.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Traces causal execution flow while coding by reconstructing Command → Validation → Events → State → Projections from real artifacts using terminal access. Automatically used after changes to event emission, ordering, lifecycle logic, or when diagnosing stalls, missing transitions, or unexpected state outcomes.

Core Features & Use Cases

  • discovers artifacts via terminal commands
  • reconstructs ordered flows across ticks and subsystems
  • highlights gaps, stalls, and illegal branches
  • produces a minimal, navigable trace with evidence
  • writes helper scripts when repetition would slow progress

Quick Start

Run the tracer after changes to event emission or lifecycle logic to verify the correctness of the causal flow.

Frequently Asked Questions about event-flow-tracer

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

FAQPage Schema
How do I trace causal flows in an event-sourced system to pinpoint missing events?

To trace causal flows in an event-sourced system, you reconstruct the exact sequence of commands, validations, events, and state mutations from real artifacts. This pinpoints missing events by enforcing deterministic artifact discovery and explicit ordering evidence across ticks.

What is the best way to debug unexpected state outcomes in tick-driven projections?

Debugging unexpected state outcomes in tick-driven projections requires reconstructing ordered flows across subsystems and ticks. Highlighting gaps, stalls, and illegal branches produces a minimal, navigable trace with evidence to isolate the causality issue.

How do I diagnose stalls after changing event emission or lifecycle logic?

Diagnosing stalls after changing event emission or lifecycle logic involves tracing the causal execution flow from commands to projections. Discovering artifacts via terminal commands and writing helper scripts verifies the correctness of the causal flow.

Can I use scripts to automate trace reconstruction for debugging event sourcing?

Yes, you can use scripts to automate trace reconstruction for debugging event sourcing. The tracer writes helper scripts when repetition would slow progress, enforcing scriptable trace reconstruction with output suitable for a structured report.

Does event flow tracing work without external dependencies?

Yes, event flow tracing works without external dependencies. It relies on deterministic artifact discovery via terminal commands and scriptable trace reconstruction to analyze event-sourced, tick-driven systems directly from your existing codebase.