reasoning
Reasoning Skill
Structured reasoning frameworks with mandatory documentation lookup for systematic problem solving.
Overview
This skill wraps two complementary capabilities:
-
Complex Reasoning (
complex-reasoning.md) — Multiple reasoning frameworks (Chain-of-Thought, Tree-of-Thought, Hypothesis-Driven Debugging, Root Cause Analysis) that always query documentation before reasoning and store insights in memory. -
Documentation Lookup (
documentation-lookup.md) — Systematic documentation retrieval using Context7 MCP to ground all decisions in accurate, version-specific library documentation.
When to Use
- Debugging complex issues where root cause is unclear → use Hypothesis-Driven Debugging
- Making architectural decisions with multiple valid approaches → use Tree-of-Thought
- Linear problem-solving with sequential steps → use Chain-of-Thought
- Systemic incidents or repeated failures → use Root Cause Analysis
- Any task involving external libraries or APIs → use Documentation Lookup first
Framework Selection
| Problem Type | Framework | Agent |
|---|---|---|
| Linear, sequential | Chain-of-Thought | hypothesis-debugger |
| Multiple valid approaches | Tree-of-Thought | requirements-analyzer |
| Complex bug, unclear root cause | Hypothesis-Driven Debugging | hypothesis-debugger |
| Incident, systemic issue | Root Cause Analysis | root-cause-analyzer |
| Any technology decision | Documentation Lookup | requirements-analyzer |
Core Protocol
MANDATORY before any reasoning about technology:
- Identify technologies involved in the task
- Resolve library IDs via Context7 MCP
- Query relevant documentation
- Ground all reasoning steps in retrieved documentation
See complex-reasoning.md for full reasoning framework details.
See documentation-lookup.md for documentation retrieval protocol.
Integration
Works with: hypothesis-debugger (debugging workflows), root-cause-analyzer (incident analysis), requirements-analyzer (architecture decisions), task-enricher (technical planning).