why

Investigate design rationale behind code by querying seven evidence sources in parallel.

Updated Jul 29, 2026
One-click install
npx skills add https://github.com/mmdmcy/fluttAIrbar --skill why-mmdmcy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: why
Source: https://github.com/mmdmcy/fluttAIrbar/tree/main/plugins/pstack/skills/why
Command: npx skills add https://github.com/mmdmcy/fluttAIrbar --skill why-mmdmcy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Code tells you what it does but rarely why it exists. This Skill reconstructs the historical motivation behind code—design decisions, tradeoffs, rejected alternatives, and incident-driven defenses—by searching fragmented evidence across source control, tickets, docs, chat, observability, error tracking, and analytics systems. ## Core Features & Use Cases - Parallel multi-source investigation: Spawns one investigator per evidence category (git/gh, issue trackers, Notion-style docs, Slack-style chat, Datadog-style observability, Sentry-style error tracking, warehouse analytics) based on MCPs available at runtime. - Confidence-calibrated synthesis: A dedicated synthesizer merges findings into a cited narrative that strictly separates direct evidence, inference, competing hypotheses, and explicit gaps. - Use Case: Ask "why is this upload limit clamped at 128 KB?" and receive a cited answer tracing the constant to a PR discussion, a p99 data distribution, and a monitor threshold—or an honest statement that no rationale was found. ## Quick Start Ask the agent to use the why skill to explain why a specific function or design decision in the current codebase was made.

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?▼

Use this Skill with a target file, symbol, or design decision. It anchors the investigation in git history, then spawns parallel investigators across available MCP sources—tickets, docs, chat, observability, error tracking, and analytics—and returns a cited, confidence-calibrated answer.

What evidence sources does the why skill search?▼

It covers seven categories: source control history via git and gh, issue trackers, long-form documents, team chat, infrastructure observability, error tracking, and product analytics warehouses. Source control always runs; the others run only when a matching MCP is available.

Does the why skill work without MCP servers configured?▼

Partially. The source control investigator always runs using git and gh, but the other six categories require matching MCP servers. Missing categories are reported as explicit gaps in the Sources Consulted section rather than silently skipped.

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

The how skill explains what code does and how it works at runtime. The why skill explains the forces that shaped it—design rationale, business constraints, incidents, and rejected alternatives—using historical evidence rather than code reading.

Why does the output hedge with words like 'appears to' and 'likely'?▼

Hedged phrasing is deliberate confidence calibration. Direct claims with citations use confident language, while inferences must be hedged so readers can distinguish documented facts from interpretation and avoid acting on guesses.