discuss

Facilitate structured Socratic dialogue to clarify ambiguous product or engineering ideas.

Updated Apr 14, 2026
One-click install
npx skills add https://github.com/sr-ai-dev/sr-harness --skill discuss-sr-ai-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: discuss
Source: https://github.com/sr-ai-dev/sr-harness/tree/main/skills/discuss
Command: npx skills add https://github.com/sr-ai-dev/sr-harness --skill discuss-sr-ai-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you clarify vague ideas and unstated assumptions by running a structured Socratic discussion so you can surface the real requirements before planning or building.

Core Features & Use Cases

  • Socratic diagnosis, probing, and synthesis: Guides the conversation through DIAGNOSE, PROBE, and SYNTHESIZE to refine what you actually mean and what matters.
  • Probe-focus direction selection: Lets you choose whether to challenge assumptions, test failure modes, explore counter-arguments, stress-test edge cases, or consider alternative paths.
  • Optional scored ambiguity mode: When enabled, tracks an Ambiguity Score and helps drive toward a wrap-up once clarity is sufficient.
  • Optional deep mode context pull: When requested, gathers concise codebase context first (via an Explore subagent) to ground the discussion in existing patterns.

Quick Start

Use the discuss skill to spar with an idea by saying: /discuss Should we migrate from monolith to microservices?

Frequently Asked Questions about discuss

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

FAQPage Schema
How do I clarify ambiguous product requirements before starting development?

Socratic dialogue helps clarify ambiguous product requirements by applying a structured DIAGNOSE, PROBE, and SYNTHESIZE flow. This method challenges assumptions, tests failure modes, and explores counter-arguments to turn vague ideas into refined discussion outcomes.

What is the best way to run an architecture review for a new engineering idea?

The best way to run an architecture review for a new idea is through a Socratic discussion that evaluates feasibility and tests assumptions. You can select specific probe directions like challenging assumptions or stress-testing edge cases to ensure robust architecture design.

How do I test assumptions during product discovery?

Test assumptions during product discovery by engaging in a Socratic discussion that probes your initial ideas. By selecting probe directions that challenge assumptions and explore alternative paths, you surface hidden constraints and validate the core problem definition.

Can I score the ambiguity of a feature idea during a discussion?

Yes, you can score the ambiguity of a feature idea by enabling an optional ambiguity scoring mode during the dialogue. This tracks an Ambiguity Score to help gauge when sufficient clarity is reached and drive toward a structured synthesis wrap-up.

Does Socratic discussion work for exploring codebase patterns during architecture design?

Socratic discussion works for exploring codebase patterns during architecture design by using an optional deep mode context pull. This gathers concise existing codebase context first to ground the conversation in established patterns before probing assumptions.

When should I avoid using Socratic dialogue for requirement discovery?

You should avoid using Socratic dialogue for requirement discovery when you need to generate planning artifacts or implementation instructions. This approach enforces safe guardrails that focus strictly on problem definition and feasibility, avoiding actionable build plans.