gsd-discuss-phase

Gathers phase implementation decisions through adaptive questioning and writes a CONTEXT.md file.

1|Updated Aug 27, 2025
One-click install
npx skills add https://github.com/IgorGanapolsky/Random-Timer --skill gsd-discuss-phase-igorganapolsky
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gsd-discuss-phase
Source: https://github.com/IgorGanapolsky/Random-Timer/tree/main/.cursor/skills/gsd-discuss-phase
Command: npx skills add https://github.com/IgorGanapolsky/Random-Timer --skill gsd-discuss-phase-igorganapolsky

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Before planning a development phase, teams often have unresolved gray areas that cause downstream agents to guess or re-ask questions. This Skill extracts implementation decisions through structured discussion and records them in a CONTEXT.md file so researchers and planners can act without further clarification. ## Core Features & Use Cases - Adaptive Questioning: Loads prior context (PROJECT.md, REQUIREMENTS.md, STATE.md) and only asks about undecided gray areas, never re-asking settled questions. - Multiple Discussion Modes: Supports discuss, assumptions, and --assumptions listing modes routed through the gsd-tools CLI workflow engine. - Decision Capture: Produces a {phase_num}-CONTEXT.md file containing locked decisions that guide research and planning agents. - Use Case: Before planning phase 3 of a feature, invoke the skill to walk through open design questions, select which areas to discuss, and generate 3-CONTEXT.md for the planner. ## Quick Start Ask the assistant to run gsd-discuss-phase for phase 3 to discuss open decisions and generate the context file.

Frequently Asked Questions about gsd-discuss-phase

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

FAQPage Schema
How do I gather requirements before planning a development phase?▼

Run gsd-discuss-phase with the phase number to load prior context, identify undecided gray areas, and discuss them interactively. The skill writes a CONTEXT.md file capturing decisions that downstream research and planning agents consume directly.

What is a CONTEXT.md file in a GSD workflow?▼

CONTEXT.md is the output of the discuss phase, named {phase_num}-CONTEXT.md. It records implementation decisions clearly enough that researcher and planner agents can act without asking the user again.

Does gsd-discuss-phase support non-interactive assumption listing?▼

Yes. Passing --assumptions runs the list-phase-assumptions workflow, and setting workflow.discuss_mode to assumptions runs the discuss-phase-assumptions workflow instead of the interactive discussion.

Why does gsd-discuss-phase fail with gsd-tools not found?▼

The skill requires the gsd-tools.cjs CLI, resolved from the repo root, .claude directory, or PATH. If missing, install it with npx -y @opengsd/gsd-core@latest --claude --local as indicated in the error message.

When should I skip the discuss phase in a GSD workflow?▼

Skip it when prior phases already decided all gray areas or when requirements are fully specified. The skill itself avoids re-asking questions already answered in PROJECT.md, REQUIREMENTS.md, or earlier CONTEXT.md files.