gsd-discuss-phase

Capture unresolved implementation decisions in a phase-numbered CONTEXT.md file.

1|Updated Sep 6, 2015
One-click install
npx skills add https://github.com/deerawan/dotfiles --skill gsd-discuss-phase-deerawan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-discuss-phase
Source: https://github.com/deerawan/dotfiles/tree/main/claude/skills/gsd-discuss-phase
Command: npx skills add https://github.com/deerawan/dotfiles --skill gsd-discuss-phase-deerawan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents downstream agents from guessing by capturing unresolved decisions and implementation choices during a structured discuss phase.

Core Features & Use Cases

  • Adaptive questioning to surface gray areas: identifies what still needs decision-making before planning.
  • Decision capture for downstream researchers/planners: generates a phase-specific CONTEXT.md that locks choices and clarifies next investigations.
  • Routing for assumptions vs. discussion: supports a fast path for assumption review and a separate guided path for interactive discussion.

Quick Start

Run the discuss phase with a required phase argument to produce a {phase_num}-CONTEXT.md file containing the remaining decisions for downstream agents.

Frequently Asked Questions about gsd-discuss-phase

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

FAQPage Schema
How do I capture implementation decisions before planning so downstream agents don't re-ask the user?

Decision capture during a structured discuss phase locks unresolved implementation choices into a phase-numbered CONTEXT.md file. This prevents downstream researchers and planners from guessing or repeatedly asking the user for clarification.

What is adaptive questioning for surfacing gray areas in codebase scouting?

Adaptive questioning identifies remaining gray areas and unresolved decisions during codebase scouting. It dynamically routes behavior based on discuss mode and assumptions flags to ensure all planning alignments are addressed before execution.

How do I generate a CONTEXT.md file for downstream research phases?

Run the discuss phase workflow with a required phase number argument to produce a phase-specific CONTEXT.md file. This file captures concrete decisions, locks choices, and clarifies next investigations for downstream agents.

Can I use a fast path for assumption review instead of a full interactive discussion?

Yes, routing for assumptions versus discussion supports a fast path for assumption review and a separate guided path for interactive discussion. The workflow routes behavior dynamically based on assumptions flags and discuss mode settings.

Do I need to load prior context before starting the discuss workflow?

Yes, loading prior context is required before running the discuss workflow. The adaptive process must load existing context to identify gray areas, surface remaining decisions, and build planning alignment effectively.

What's the best way to align planning across research phases when decisions are still unresolved?

Planning alignment is achieved by running a selection-driven deep dive across research phases. This captures unresolved decisions and implementation choices into a phase-numbered CONTEXT.md, ensuring downstream agents can act without re-asking.