sim-scaffold

Generate simulation-testable module scaffolds with sans-IO patterns and proptest state machine tests.

1|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/ahrav/Gossip-rs --skill sim-scaffold
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sim-scaffold
Source: https://github.com/ahrav/Gossip-rs/tree/main/.claude/skills/sim-scaffold
Command: npx skills add https://github.com/ahrav/Gossip-rs --skill sim-scaffold

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the creation of new modules designed for deterministic simulation testing (DST) from the outset, preventing costly retrofitting and ensuring code is simulation-ready from day one.

Core Features & Use Cases

  • Scaffolds Simulation-Testable Modules: Generates boilerplate code for modules that are inherently testable in simulated environments.
  • Supports Multiple Module Types: Provides templates for coordination modules, gossip protocols, and pipeline components.
  • Integrates DST Patterns: Incorporates patterns like sans-IO, proptest state machine tests, and fault injection points.
  • Use Case: When starting a new coordination module in gossip-coordination/, use this Skill to generate the necessary file structure and initial code for state machines, logic, and simulation harnesses, ensuring it's built with testability in mind.

Quick Start

Use the sim-scaffold skill to generate a new coordination module named 'lease-manager'.

Frequently Asked Questions about sim-scaffold

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

FAQPage Schema
How do I scaffold a module for deterministic simulation testing from the start?

Scaffolding a module for deterministic simulation testing (DST) requires generating boilerplate with sans-IO patterns and proptest state machine tests. This Skill automates creating that initial file structure and template code, ensuring modules are simulation-ready from day one without costly retrofitting.

What is the best way to structure a gossip protocol module for fault injection testing?

Structuring a gossip protocol for fault injection testing requires a pure state machine core and effect-based design. This Skill provides tailored file structures and template code specifically for gossip protocols, integrating fault injection points directly into the generated scaffold.

Why does my coordination module need to be sans-IO for simulation testing?

A coordination module needs sans-IO design for simulation testing to ensure deterministic execution by separating logic from side effects. This Skill generates scaffolds using sans-IO patterns, creating a pure state machine core that a simulation harness can drive predictably.

Can I use proptest state machine tests for pipeline components?

Yes, you can use proptest state machine tests for pipeline components by generating a scaffold that integrates these tests natively. This Skill supports pipeline components alongside coordination modules, providing the necessary template code to enable DST-ready testing frameworks.

Does scaffolding DST-ready modules prevent costly retrofitting later?

Yes, scaffolding DST-ready modules prevents costly retrofitting by enforcing simulation-testable patterns during initial creation. This Skill ensures code incorporates sans-IO designs and fault injection points from the outset, avoiding the architectural refactoring needed when testing is added later.

How do I generate a simulation harness for a new state machine module?

Generating a simulation harness for a state machine module involves creating template code that drives a pure state machine core. This Skill automates building that harness alongside the module logic, providing the necessary scaffolding to execute deterministic simulation tests immediately.