wtf.spike

Run a time-boxed technical spike to produce a findings document and recommendation.

7|2|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/xiduzo/wtf --skill wtf-spike
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wtf.spike
Source: https://github.com/xiduzo/wtf/tree/main/skills/wtf.spike
Command: npx skills add https://github.com/xiduzo/wtf --skill wtf-spike

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Spike addresses the need to investigate a technical unknown before committing to an approach, turning uncertainty into a concrete finding and a recommendation that informs whether to write an epic or a task.

Core Features & Use Cases

  • Time-boxed investigations with a clear scope and duration to prevent drift.
  • Produces a findings document and a concrete recommendation to feed into planning.
  • Maintains traceability by linking research to decisions in the issue/PR workflow.

Quick Start

Run a time-boxed technical spike to investigate a defined unknown and produce a findings document with a concrete recommendation.

Frequently Asked Questions about wtf.spike

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

FAQPage Schema
What is a technical spike in software architecture?

A technical spike is a time-boxed investigation used to solve a technical unknown before committing to an architecture or tooling approach. It yields a concrete findings document and a recommendation to inform whether to write an epic or a task.

How do I investigate a technical unknown before committing to an epic or task?

Run a time-boxed spike with a clear scope and duration to investigate the technical unknown. This produces a findings document and a concrete recommendation that feeds directly into writing your epic or task.

When do I need to run a spike instead of writing a task directly?

You need a spike when teams face uncertainty around architecture, approach, or tooling before committing to an epic or task. The spike prevents drift by time-boxing the investigation and delivering a concrete recommendation.

What's the best way to prevent scope drift during a technical investigation?

The best way to prevent scope drift is to enforce a time-boxed spike with a predefined scope and duration. This structure ensures the investigation yields a concrete finding and recommendation without unbounded research.

How does a spike maintain traceability for architecture decisions?

A spike maintains traceability by linking the research findings and concrete recommendations directly to decisions in the issue and PR workflow. This connects the technical investigation to the resulting epic or task.

What should a technical spike deliver at the end of the investigation?

A technical spike must deliver a findings document and a concrete recommendation. These outputs feed directly into planning, allowing teams to confidently write an epic or task based on the resolved unknown.