gsd-discuss-phase

Gathers phase context through adaptive questioning and writes decisions to CONTEXT.md.

2|Updated Mar 7, 2025
One-click install
npx skills add https://github.com/AbdelrhmanUZaki/KnowledgeNuggets --skill gsd-discuss-phase-abdelrhmanuzaki
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gsd-discuss-phase
Source: https://github.com/AbdelrhmanUZaki/KnowledgeNuggets/tree/main/2-setup/shared/codex/skills/gsd-discuss-phase
Command: npx skills add https://github.com/AbdelrhmanUZaki/KnowledgeNuggets --skill gsd-discuss-phase-abdelrhmanuzaki

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Before planning a development phase, teams often skip clarifying ambiguous requirements, causing downstream agents and planners to guess. This Skill structures a discussion step that surfaces gray areas, captures user decisions, and records them in a CONTEXT.md file so research and planning agents can act without re-asking questions. ## Core Features & Use Cases - Adaptive Questioning: Loads prior context (PROJECT.md, REQUIREMENTS.md, STATE.md) and asks only about undecided gray areas, translating Claude Code AskUserQuestion calls into Codex request_user_input or VS Code vscode_askquestions. - Mode Routing: Supports discuss, assumptions, and --assumptions modes by delegating to the appropriate workflow file under $HOME/.codex/get-shit-done/workflows/. - Decision Capture: Produces a {phase_num}-CONTEXT.md file containing locked implementation decisions for researcher and planner agents. - Use Case: Before planning phase 3 of a feature, invoke the skill to walk through open design questions, then hand the resulting CONTEXT.md to planning agents. ## Quick Start Invoke $gsd-discuss-phase followed by the phase number, for example $gsd-discuss-phase 3, to start the guided context-gathering discussion.

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 phase context before planning in a GSD workflow?▼

Invoke $gsd-discuss-phase with the phase number as an argument. The skill loads prior context files, identifies undecided gray areas, asks adaptive questions, and writes the decisions to a {phase_num}-CONTEXT.md file for downstream agents.

What is the difference between discuss mode and assumptions mode?▼

Discuss mode interactively asks the user about gray areas, while assumptions mode (set via workflow.discuss_mode config or the --assumptions flag) lists or derives assumptions without full interactive discussion. The skill routes to the matching workflow file automatically.

Does gsd-discuss-phase work with VS Code Copilot?▼

Yes. The skill maps Claude Code AskUserQuestion calls to vscode_askquestions in VS Code Copilot, and to request_user_input in Codex. If interactive input is unavailable, it falls back to plain-text numbered questions and waits for a reply.

What happens if the user does not answer the discussion questions?▼

The skill stops and waits rather than picking defaults. It only proceeds without answers when an explicit --auto or --all flag is present, the user approved a default, or the workflow contract declares defaults safe. No artifacts are written until questions are answered.

What files does the phase discussion produce?▼

It produces a {phase_num}-CONTEXT.md file capturing implementation decisions. Depending on mode, it may also involve DISCUSSION-LOG.md and related workflow artifacts loaded from the get-shit-done workflows directory.