why

Investigates design rationale behind code by querying git history, tickets, docs, chat, and observability sources in parallel.

Updated Aug 28, 2026
One-click install
npx skills add https://github.com/jeremybrasher/grokbot-skills --skill why-jeremybrasher
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: why
Source: https://github.com/jeremybrasher/grokbot-skills/tree/main/collections/pstack/skills/why
Command: npx skills add https://github.com/jeremybrasher/grokbot-skills --skill why-jeremybrasher

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Answering "why does this code work this way" usually means digging through git blame, PR discussions, tickets, docs, and chat threads by hand. This Skill automates that investigation and returns a cited, confidence-labeled read on the decisions and tradeoffs that shaped the code. ## Core Features & Use Cases - Parallel evidence investigators: Discovers available MCP servers and spawns one investigator per evidence category (source control, issue tracker, long-form docs, team chat, infrastructure observability, error tracking, product analytics), each with its own playbook. - Epistemic synthesis: A synthesizer subagent labels every claim as measured, inferred, or guess, and produces a structured report with competing hypotheses, unknowns, and a per-source coverage map including null results. - Guardrails: Intake checks, explicit HOLD conditions, and cut-first defaults prevent uncited guesses and unjustified skipped sources. - Use Case: Ask why a retry loop with a specific backoff constant exists; the Skill traces the commits, PRs, incident postmortems, and Sentry errors behind it and returns a cited explanation with a Preserve/Change/Avoid/Risk constraint set for planning modifications. ## Quick Start Ask why the timeout handling in src/api/client.ts was implemented this way and request a cited investigation of its design rationale.

Frequently Asked Questions about why

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

FAQPage Schema
How do I find out why a piece of code was written a certain way?▼

Anchor the target with git blame and git log to find commits and PR numbers, then investigate each evidence source: PR discussions, linked tickets, design docs, chat threads, and error reports. This Skill automates that by spawning one investigator per available source and synthesizing cited findings.

What is the difference between the why and how skills?▼

The how skill explains what the code does and how it works at runtime. The why skill explains the forces that led to its shape: design rationale, tradeoffs, incidents, and external constraints. Use how for behavior questions and why for motivation questions.

Which MCP servers does the why investigation use?▼

It maps available MCPs to seven categories: source control, issue tracker, long-form docs, team chat, infrastructure observability, error tracking, and product analytics. Git and gh always cover source control; other categories depend on which MCPs are enabled in the environment.

What happens when an evidence source is unavailable or empty?▼

Missing MCP categories are recorded as gaps in the coverage map, and null search results are documented rather than skipped silently. Investigators are only skipped with explicit written justification that appears in the Sources Consulted section.

Can the investigation results be trusted when the paper trail is thin?▼

Findings are labeled as measured, inferred, or guess following the epistemics framework, and thin trails are flagged as unknowns rather than filled with speculation. Deciding which inferred causes to trust remains a human judgment call.