research-spike

Conducts time-boxed technical investigations producing evidence-backed decision artifacts for feasibility questions.

Updated May 21, 2026
One-click install
npx skills add https://github.com/CagesThrottleUs/private-ai-harness --skill research-spike-cagesthrottleus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: research-spike
Source: https://github.com/CagesThrottleUs/private-ai-harness/tree/main/skills/research-spike
Command: npx skills add https://github.com/CagesThrottleUs/private-ai-harness --skill research-spike-cagesthrottleus

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Engineering teams often make technology or architecture decisions on gut feel, or let exploratory work balloon into unplanned implementation. This Skill structures feasibility questions, technology comparisons, and proof-of-concept work into a time-boxed investigation whose only deliverable is a decision artifact, keeping throwaway spike code out of production. ## Core Features & Use Cases - Framed Investigation: Forces an explicit question, hard time budget, and decision criteria before any research begins, turning vague asks into testable questions. - Evidence-Gated Decision Artifact: Produces a findings document in .ai/ or an ADR in wiki/architecture/ with options, risks, and verifiable evidence, then runs a mandatory self-gate that rejects fabricated benchmarks, untested assumptions, and inflated confidence. - Clear Outcomes and Handoff: Closes every spike with one of three outcomes (decision made, blocked on info, or do-not-build) and routes architectural decisions into high-level design review before any build starts. - Use Case: Ask whether Kafka can handle 50k events/sec at p99 under 20ms on your infrastructure tier; the Skill benchmarks options, prototypes the riskiest assumption, and commits a decision artifact with cited evidence. ## Quick Start Invoke the research-spike skill with a specific feasibility question, a time budget, and the decision criteria you want evaluated.

Frequently Asked Questions about research-spike

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

FAQPage Schema
How do I run a time-boxed technical spike before committing to a technology?

State a specific testable question, a hard time budget in work hours, and decision criteria up front, then investigate each option and prototype only the single riskiest assumption. The output is a decision artifact with evidence, not production code.

What should a research spike decision artifact contain?

A decision artifact records the question answered, time spent, the decision with a confidence level, each option's fit, risks, and cited evidence, plus open questions and the next concrete step. Architectural decisions use ADR format with Status, Context, Decision, and Consequences.

When should I use a research spike instead of starting implementation?

Use a spike when the deliverable is a decision or recommendation, such as feasibility checks, technology comparisons, or design questions, rather than working code. If the question is already answered and the task is clear, go straight to implementation.

What happens to prototype code written during a spike?

Spike code is throwaway and lives in a spike/<topic> branch or temp file, validating one assumption only. It is deleted or left in a dead branch after the spike and never merged to main; the artifact captures the learning.

Why does a spike artifact need an evidence quality gate?

The artifact drives a build-or-kill decision with no downstream reviewer, so every evidence line must cite a verifiable source like a benchmark you ran, a doc URL, or a prototype result. Unverifiable numbers and untested assumptions must be removed or flagged as open questions.