product-thinking

Validate proposed changes to CLI commands, configuration schemas, and API contracts.

14.3k|455|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/millionco/react-doctor --skill product-thinking-millionco
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: product-thinking
Source: https://github.com/millionco/react-doctor/tree/main/.agents/skills/product-thinking
Command: npx skills add https://github.com/millionco/react-doctor --skill product-thinking-millionco

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill prevents the accidental introduction of poorly justified or breaking changes to public-facing surfaces like CLI commands, configuration schemas, and API contracts.

Core Features & Use Cases

  • Surface Impact Analysis: Evaluates whether a proposed change to CLI flags, JSON report schemas, or GitHub Action inputs is necessary and durable.
  • Telemetry Integration: Ensures every new user-facing feature is instrumented with a success metric before implementation.
  • Use Case: Before adding a new configuration option to doctor.config.ts, use this skill to verify if an existing option can be reused and to define the success metric for the new feature.

Quick Start

Run the product-thinking skill to evaluate the impact and requirements for the proposed CLI flag change.

Frequently Asked Questions about product-thinking

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

FAQPage Schema
How do I validate CLI command changes before implementation?

Validate CLI command changes by evaluating surface impact, ensuring proposed modifications are necessary, durable, and compatible with existing configurations before writing code. This prevents poorly justified or breaking changes to public-facing interfaces.

What is surface impact analysis for API contracts?

Surface impact analysis for API contracts evaluates whether a proposed change to public-facing schemas is necessary and durable. It ensures architectural decisions require product-level justification before code implementation begins.

How do I add telemetry to new CLI features?

Add telemetry to new CLI features by defining a success metric during the planning phase. Every new user-facing feature must be instrumented with telemetry before implementation to track its effectiveness.

When do I need product-level justification for configuration schema changes?

You need product-level justification for configuration schema changes when modifying public-facing surfaces like JSON report schemas or config files. This ensures changes adhere to runbook steps for trust and compatibility.

Can I check if an existing configuration option can be reused before adding a new one?

Yes, you can verify if an existing configuration option can be reused before adding a new one. This process checks doctor.config.ts entries to prevent unnecessary surface area expansion and ensure architectural durability.

What are the limitations of validating public-facing software surfaces?

The validation of public-facing software surfaces is limited to CLI commands, configuration schemas, and API contracts. It requires strict adherence to predefined runbook steps and cannot bypass the product-level justification phase.