research-spike

Investigates a single blocking question within a timebox and returns a decision-ready answer.

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/scoots31/engineering-playbook --skill research-spike-scoots31
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: research-spike
Source: https://github.com/scoots31/engineering-playbook/tree/main/skills/research-spike
Command: npx skills add https://github.com/scoots31/engineering-playbook --skill research-spike-scoots31

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Open-ended research stalls software projects because investigations expand without a clear stopping point. This Skill converts a blocking unknown into a focused, timeboxed question, investigates just enough to decide, and routes the answer back to the phase that asked for it. ## Core Features & Use Cases - Focused spike questions: Sharpens vague research requests into one specific, answerable question with a clear "enough to decide" threshold. - Timeboxed investigation: Sets an explicit timebox based on complexity and stops the investigation once the question is answered, preventing scope creep. - Structured results with confidence levels: Returns a finding, a High/Medium/Low confidence rating, and the implication for the calling phase, then hands control back. - Use Case: During planning, you are unsure whether a third-party API's rate limits support your expected load. Run a spike to check the API documentation and limits, then return a decision on whether the architecture is viable. ## Quick Start Run a research spike on whether the payment provider's API supports recurring billing with our expected transaction volume before we commit to this architecture.

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 timeboxed technical investigation before making an architecture decision?

Define one specific question that is blocking the decision, set a timebox based on complexity, then investigate only until you have enough to decide. Record the finding, a confidence level, and what the answer unblocks for the current phase.

What makes a good research spike question in software development?

A good spike question is specific, answerable, and has a clear threshold for enough information to decide. For example, asking about an API's rate limits and latency works, while asking to research a broad topic does not.

When should I use a research spike instead of open-ended research?

Use a spike when a single unknown is blocking a concrete decision in your current phase. If the topic is broad, such as surveying competitors or exploring a whole domain, that is a different kind of work and should not be timeboxed as a spike.

What should I do when a spike investigation uncovers more unknowns?

Name the new unknown explicitly instead of expanding the current spike. Ask whether to run a second focused spike on the new question or proceed with the current findings and record the gap as a risk.

How do I handle a spike result with low confidence?

State what would confirm the finding, such as a proof of concept or a test call, and recommend whether to proceed with a named assumption, run another spike, or defer the blocked work until confidence improves.