gsd-discuss-phase

Load project context files and produce a phase-specific CONTEXT.md decision artifact.

Updated Aug 15, 2025
One-click install
npx skills add https://github.com/gesmith0606/nfl_data_engineering --skill gsd-discuss-phase-gesmith0606
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-discuss-phase
Source: https://github.com/gesmith0606/nfl_data_engineering/tree/main/.claude/skills/gsd-discuss-phase
Command: npx skills add https://github.com/gesmith0606/nfl_data_engineering --skill gsd-discuss-phase-gesmith0606

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The skill surfaces unresolved implementation decisions and context gaps before planning so downstream researchers and planners can proceed without repeated clarification requests.

Core Features & Use Cases

  • Context consolidation: Loads prior context files (PROJECT.md, REQUIREMENTS.md, STATE.md) and existing CONTEXT.md to avoid re-asking decided questions.
  • Adaptive questioning: Scouts the codebase for reusable assets and gray areas, then interactively narrows topics with the user or applies recommended defaults in auto mode.
  • Decision artifact: Produces a {phase_num}-CONTEXT.md that captures concrete decisions and next steps for researchers and planners.
  • Use Case: Run this at the start of an implementation phase to lock down integration choices, clarify ambiguous requirements, and produce a single source of truth for downstream automation.

Quick Start

Start the discuss phase for phase 2 and interactively create a phase 2 CONTEXT.md that captures remaining decisions.

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 project context and surface unresolved decisions before planning?

Gather project context by loading prior files like PROJECT.md and STATE.md to avoid re-asking decided questions. This process interactively surfaces gray areas and unresolved decisions, producing a CONTEXT.md artifact to prevent downstream clarification requests.

What is the best way to consolidate phase decisions for downstream researchers and planners?

Consolidate phase decisions by running a guided discussion that scouts the codebase for gray areas. This produces a phase-specific CONTEXT.md decision artifact that locks down integration choices and serves as a single source of truth for downstream automation.

How do I automatically generate a CONTEXT.md file without manual stakeholder input?

Generate CONTEXT.md automatically by using auto mode, which applies recommended defaults for unresolved decisions instead of interactively narrowing topics. This still loads existing workflow context and outputs the required decision artifact for researchers.

Does this context-gathering workflow require existing project files to run?

Yes, this context-gathering workflow requires existing files like PROJECT.md, REQUIREMENTS.md, and STATE.md. It loads these templates to consolidate prior context and avoid re-asking questions that have already been decided.

When should I run an interactive discussion phase in my project workflow?

Run an interactive discussion phase at the start of an implementation phase to clarify ambiguous requirements. This ensures integration choices and context gaps are resolved before planning, allowing downstream researchers to proceed without interruption.