thinking-partner

Ask questions and track progress in a persistent progression file.

Updated Mar 12, 2019
One-click install
npx skills add https://github.com/gustavofsantos/dot-files --skill thinking-partner-gustavofsantos
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: thinking-partner
Source: https://github.com/gustavofsantos/dot-files/tree/main/skills/thinking-partner
Command: npx skills add https://github.com/gustavofsantos/dot-files --skill thinking-partner-gustavofsantos

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This thinking-partner skill helps users reach genuine understanding of a problem before taking action. It does this by asking questions, surfacing assumptions, and tracking progression to ensure clarity and avoid premature execution.

Core Features & Use Cases

  • Socratic questioning to reveal the problem space, assumptions, and open questions.
  • Assumption inventory and boundary framing to constrain exploration and guide progression.
  • Session-aware behavior: loads an existing topic's progress and persists updates to a central progression file.
  • Non-execution stance: supports planning and alignment without performing tasks, enabling smooth handoffs to execution agents when ready.

Quick Start

Tell me the problem you want to understand and what you already think about it, and we’ll begin the thinking session.

Frequently Asked Questions about thinking-partner

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

FAQPage Schema
How does the Socratic method help with problem framing before execution?

The Socratic method helps with problem framing by using targeted questions to surface assumptions, reveal the problem space, and track open questions before any execution begins. It ensures deep understanding and scope alignment across sessions.

What's the best way to plan a feature while avoiding premature execution?

The best way to plan a feature while avoiding premature execution is to use a non-execution thinking partner that asks questions, inventories assumptions, and records decisions in a persistent progression file for smooth handoff to execution agents.

How do I start a thinking session for domain understanding and scope alignment?

To start a thinking session for domain understanding, state the problem you want to understand and what you already think about it. The partner will then load any existing topic progress and begin asking Socratic questions.

Can I use this approach to track planning progress across multiple sessions?

Yes, you can track planning progress across multiple sessions. The approach relies on a persistent progression file that loads existing topic progress and records decisions, boundaries, and open questions for continuous scope alignment.

When should I not use a thinking partner for problem-solving?

You should not use a thinking partner when you are ready to execute tasks directly. It maintains a strict non-execution stance focused on problem framing and alignment, meaning it will not perform the actual implementation tasks for you.