The Demo Is a Reducer: A Weekend Fixture Kit for Agent Side Projects

说明与用途

使用冻结时间和工具固定件的简洁可重复演示命令，用于测试代理原型。

问题

Weekend agent prototypes often produce non‑deterministic demos that cannot be reliably reproduced, making review and validation difficult.

结果

The spike produces a deterministic, reproducible demo that can be verified by running demo.sh. It demonstrates how to isolate time, tool responses, and policy logic in code for reliable agent testing.

工作流

• 1. Commit a frozen clock file files/CLOCK.txt with an ISO timestamp.
• 2. Create a fixture file fixtures/tools.json containing all tool responses the reducer may need.
• 3. Implement reduce.py to load the clock, read the incident JSON, look up tool results from the fixture, apply a deterministic severity table, and print a four‑line receipt.
• 4. Write demo.sh to run the reducer twice and compare stdout to fixtures/demo.stdout using diff.
• 5. Document skipped features in SKIPS.md to keep the spike focused.

证据

The demo is a command that reads frozen time, canned tool results, and one input file, then prints the same bytes on the second run.

来源

Five files are enough. More files usually mean the spike is leaking back in.

来源