forge-discuss

To facilitate architecture decision discussions, analyze your project state and open questions to surface unresolved topics. This skill guides you through a structured discuss phase by reading .gsd/STATE.md and .gsd/PROJECT.md, then updates .gsd/STATE.md and .gsd/DECISIONS.md to progress toward planning.

Capturing architecture decisions requires writing contextual CONTEXT.md files for milestones and slices. This skill enforces guardrails to ensure alignment by preventing proceeding without an initial CLAUDE.md and project state, assisting in writing decisions to move from discuss to plan.

You need an initial CLAUDE.md file to start planning architecture milestones. The skill enforces strict guardrails that prevent proceeding with decision capture or state updates unless a valid CLAUDE.md and project state are already present in the repository.

Project state analysis for unresolved architecture risks works by reading existing .gsd/STATE.md and .gsd/PROJECT.md files. It interacts with existing CONTEXT files to identify open questions, extracts memory, and updates the state to reflect the newly resolved decisions.

You can use this to brainstorm architecture decisions for individual slices. The skill guides brainstorms and decision capture specifically to produce contextual CONTEXT.md files tailored to both milestones and slices before execution begins.