# Gsd Discuss Phase

Use when a phase has unresolved decisions before planning and no CONTEXT.md exists.

- Repository: https://github.com/coco-research/coco (797 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add coco-research/coco --skill gsd-discuss-phase -g -a claude-code -y`
Codex: `npx skills add coco-research/coco --skill gsd-discuss-phase -g -a codex -y`
Cursor: `npx skills add coco-research/coco --skill gsd-discuss-phase -g -a cursor -y`
Gemini CLI: `npx skills add coco-research/coco --skill gsd-discuss-phase -g -a gemini-cli -y`

## Description

Use when a phase has unresolved decisions before planning and no CONTEXT.md exists. Asks adaptive questions on the phase's gray areas and writes {phase_num}-CONTEXT.md with locked decisions; --auto, --chain, --power change the questioning.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

<objective>
Extract implementation decisions that downstream agents need, researcher and planner will use CONTEXT.md to know what to investigate and what choices are locked.

**How it works:**
1. Load prior context (PROJECT.md, REQUIREMENTS.md, STATE.md, prior CONTEXT.md files)
2. Scout codebase for reusable assets and patterns
3. Analyze phase, skip gray areas already decided in prior phases
4. Present remaining gray areas, user selects which to discuss
5. Deep-dive each selected area until satisfied
6. Create CONTEXT.md with decisions that guide research and planning

**Output:** `{phase_num}-CONTEXT.md`, decisions clear enough that downstream agents can act without asking the user again
</objective>

<execution_context>
@$HOME/.claude/get-shit-done/workflows/discuss-phase.md
@$HOME/.claude/get-shit-done/workflows/discuss-phase-assumptions.md
@$HOME/.claude/get-shit-done/workflows/discuss-phase-power.md
@$HOME/.claude/get-shit-done/templates/context.md
</execution_context>

<runtime_note>
**Copilot (VS Code):** Use `vscode_askquestions` wherever this workflow calls `AskUserQuestion`. They are equivalent, `vscode_askquestions` is the VS Code Copilot implementation of the same interactive question API.
</runtime_note>

<context>
Phase number: $ARGUMENTS (required)

Context files are resolved in-workflow using `init phase-op` and roadmap/state tool calls.
</context>

<process>
**Mode routing:**
```bash
DISCUSS_MODE=$(node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" config-get workflow.discuss_mode 2>/dev/null || echo "discuss")
```

If `DISCUSS_MODE` is `"assumptions"`: Read and execute @$HOME/.claude/get-shit-done/workflows/discuss-phase-assumptions.md end-to-end.

If `DISCUSS_MODE` is `"discuss"` (or unset, or any other value): Read and execute @$HOME/.claude/get-shit-done/workflows/discuss-phase.md end-to-end.

The rest: https://github.com/coco-research/coco/blob/HEAD/systems/gsd/skills/gsd-discuss-phase/SKILL.md