pelizzai-reasoning

Select reasoning techniques for engineering tasks based on uncertainty and risk.

Updated Jun 26, 2026
One-click install
npx skills add https://github.com/rpelizza/PelizzAI --skill pelizzai-reasoning
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pelizzai-reasoning
Source: https://github.com/rpelizza/PelizzAI/tree/main/.agents/skills/pelizzai-reasoning
Command: npx skills add https://github.com/rpelizza/PelizzAI --skill pelizzai-reasoning

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill solves the problem of inefficient or overly complex reasoning in engineering tasks by providing a structured, proportional framework for selecting the right cognitive approach based on task uncertainty and risk.

Core Features & Use Cases

  • Operational Selector: Matches tasks to specific strategies like TDD, OODA, or Root Cause Analysis based on the predominant effect.
  • Technique Catalog: Provides a curated set of reasoning techniques (e.g., ReAct, Decision Making, Assumption Tracking) to handle multi-step planning, debugging, and high-impact changes.
  • Use Case: When refactoring a legacy system with unknown dependencies, use this skill to apply Structured Decomposition and Plan and Execute to ensure the refactor preserves behavior while managing risk.

Quick Start

Use the pelizzai-reasoning skill to analyze the current bug report and select the appropriate root cause analysis technique.

Frequently Asked Questions about pelizzai-reasoning

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

FAQPage Schema
How do I apply structured reasoning to debug complex engineering bugs?

Structured reasoning for debugging complex engineering bugs uses an operational selector to match the task to specific strategies like Root Cause Analysis or OODA, applying proportional principles and evidence-based validation to manage investigation uncertainty effectively.

What is the best way to manage risk when planning architectural decision-making?

The best way to manage risk in architectural decision-making is to use a curated catalog of reasoning techniques, such as Assumption Tracking and Decision Making, to ensure explicit constraint satisfaction and evidence-based validation during high-impact system changes.

How do I plan a legacy system refactor with unknown dependencies?

To plan a legacy system refactor with unknown dependencies, apply Structured Decomposition and Plan and Execute reasoning techniques to preserve behavior while managing risk, ensuring proportional reasoning based on the task's predominant effect and uncertainty level.

Can I use proportional reasoning for multi-step planning and investigation?

Yes, proportional reasoning handles multi-step planning and investigation by selecting appropriate cognitive approaches like ReAct based on task uncertainty, ensuring the reasoning complexity matches the engineering risk and adheres to explicit constraint satisfaction.

Does this reasoning framework work with Test-Driven Development?

Yes, the reasoning framework works with Test-Driven Development by using an operational selector that matches engineering tasks to specific strategies like TDD, applying the appropriate cognitive approach based on the predominant effect and validation requirements.