spike

Write throwaway code to answer one falsifiable design question within a time-box.

Updated Feb 12, 2026
One-click install
npx skills add https://github.com/kieranpotts/skills --skill spike-kieranpotts
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spike
Source: https://github.com/kieranpotts/skills/tree/main/skills/spike
Command: npx skills add https://github.com/kieranpotts/skills --skill spike-kieranpotts

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Design decisions often stall on open questions about feasibility, performance, API ergonomics, or integration risk that reasoning alone cannot settle. This Skill runs a small, time-boxed experiment with disposable code to produce concrete evidence, records the verdict in the appropriate project store, and disposes of the code so it never leaks into production. ## Core Features & Use Cases - Falsifiable question framing: Forces a single question, the evidence that would close it, and a time-box to be written down before any code is written. - Scope-collapsed experimentation: Skips tests, error handling, auth, configuration, and abstraction, keeping spike code isolated from production paths. - Verdict and disposal discipline: Lands on a yes, no, or inconclusive verdict, files reproducible findings in the store that owns the question, then deletes or quarantines the code. - Use Case: A team is unsure whether Postgres LISTEN/NOTIFY can sustain 5000 dispatches per second at p95 under 50ms. The agent builds a minimal benchmark in a scratch directory, measures the result, files the answer in the decision store, and deletes the spike code. ## Quick Start Do a spike on whether the new SDK's streaming API surfaces errors mid-stream, time-boxed to half a day.

Frequently Asked Questions about spike

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

FAQPage Schema
How do I run a spike to test technical feasibility?▼

State one falsifiable question in a single sentence, define the evidence that would close it, and set a time-box before writing code. Then take the shortest path to that evidence with throwaway code, record the measured result, and file the verdict in the store that owns the question.

What is the difference between a spike and a prototype?▼

A spike answers one question and its code is always discarded, while a prototype is often intended to evolve into a product. Spike code deliberately omits tests, error handling, and configuration, so promoting it to production skips the specification and design discipline it was meant to inform.

How long should a spike time-box be?▼

A single spike's time-box should not exceed three to five days, and half a day or one day is typical. When the budget runs out, stop and report what was learned; extending the box is an explicit decision for the caller, and a question needing more than a week is really several spikes or project work.

Can spike code be reused in production?▼

No, spike code must never be promoted to production, however close to working it looks. What makes it cheap to write is everything it omits, so the capability is re-implemented cleanly from scratch using what the spike taught.

What happens when a spike returns an inconclusive result?▼

An inconclusive spike still reports what the budget bought and what remains unknown. It may propose another time-boxed spike that would disambiguate, or hand the decision back to the caller, but it never starts a second spike on its own initiative.