forge-discuss

name	forge-discuss
description	Discuss de arquitetura — captura decisoes antes de planejar.
disable-model-invocation	true
allowed-tools	Read, Write, Bash, Agent, Skill, WebSearch, WebFetch

Bootstrap guard

ls CLAUDE.md 2>/dev/null && echo "ok" || echo "missing"
ls .gsd/STATE.md 2>/dev/null && echo "ok" || echo "missing"
pwd

Se CLAUDE.md não existe: Stop. Tell the user:

Projeto não inicializado. Execute /forge-init primeiro.

Se .gsd/STATE.md não existe: Stop. Tell the user:

Nenhum projeto GSD encontrado. Execute /forge-init para começar.

---

Parse flags and target

From $ARGUMENTS:

• If contains -fast → FAST_MODE=true, strip it
• If remaining is M### → discussing a milestone → TARGET_TYPE=milestone, TARGET_ID=M###
• If remaining is S## → discussing a slice → TARGET_TYPE=slice, TARGET_ID=S##
• If freeform → read STATE.md to find active milestone/slice, use that

---

Minimal context read (this command, main context)

Read ONLY these files:

• .gsd/STATE.md — determine active milestone/slice
• .gsd/PROJECT.md — project description
• Relevant M###-CONTEXT.md or S##-CONTEXT.md if it already exists (skip if not)
• Last 15 rows of .gsd/DECISIONS.md — what's already decided (don't re-debate)

Do NOT read: ROADMAP, PLAN files, source code, requirements, or any other file.

---

Brainstorm (only for milestone discuss, skip if FAST_MODE or brainstorm already done)

If TARGET_TYPE=milestone and FAST_MODE=false:

ls .gsd/milestones/{TARGET_ID}/{TARGET_ID}-BRAINSTORM.md 2>/dev/null && echo "exists" || echo "missing"

If brainstorm missing, invoke the skill directly in this context:

Skill({ skill: "forge-brainstorm", args: "{TARGET_ID}" })

After the skill completes, read the Open questions and Top risks sections of the produced BRAINSTORM.md to inform the discuss questions. Do not read the full file.

---

Discuss (interactive, stays in main context)

Identify 3-5 gray areas not already resolved by:

• Decisions Register (already read)
• Brainstorm summary (if generated above)
• Existing CONTEXT.md (if it already exists)

Focus on genuine architecture/scope choices with real trade-offs. Skip anything already locked.

Ask ALL questions at once — not one by one.

Wait for user answers.

---

Write decisions

Write (or update) .gsd/milestones/{M###}/{M###}-CONTEXT.md or slices/{S##}/{S##}-CONTEXT.md:

# {TARGET_ID}: {title} — Context
**Gathered:** {date}
**Status:** Ready for planning

## Implementation Decisions
{decisions from user answers}

## Agent's Discretion
{areas where user said "you decide"}

## Deferred Ideas
{ideas for later milestones/slices}

Append significant decisions to the fragment store

For each significant decision made during this discuss unit, pipe a JSON fragment to forge-decisions.js --write:

FORGE_SCRIPTS_DIR=$([ -f scripts/forge-decisions.js ] && echo scripts || echo "$HOME/.claude/scripts")
echo '{
  "unit_id": "{TARGET_ID}",
  "decisions": [
    {
      "when": "YYYY-MM-DD",
      "scope": "milestone|slice",
      "decision": "Short label for this decision",
      "choice": "What was chosen",
      "rationale": "Why this was chosen",
      "revisable": "yes|no"
    }
  ]
}' | node "$FORGE_SCRIPTS_DIR/forge-decisions.js" --write --cwd .

• unit_id is {TARGET_ID} — for slice discuss, pass the parent milestone ID (e.g. M001, M-20260522101500-pagamentos); for milestone discuss, pass the milestone ID directly. The CLI writes to .gsd/decisions/<unit-id>.md.
• Multiple decisions can be batched in a single invocation by adding entries to the decisions array.
• Do NOT append directly to .gsd/DECISIONS.md or any M###-DECISIONS.md file — the CLI is the uniform write path. The global .gsd/DECISIONS.md is rebuilt from fragments during complete-milestone (forge-completer, step 5).

Read .gsd/STATE.md, then update it — set phase to plan (ready to plan this milestone/slice).

---

Fire memory extraction (fire-and-forget)

After writing the context file, delegate to forge-memory agent:

Extract memories from this discuss session.
UNIT_TYPE: discuss-{TARGET_TYPE}
UNIT_ID: {TARGET_ID}
WORKING_DIR: {pwd}

DECISIONS_MADE:
{the decisions you just wrote to CONTEXT.md}

AUTO_MEMORY_PATH: .gsd/AUTO-MEMORY.md

Do not await this — continue immediately.

---

Report

Tell the user:

✓ Discuss de {TARGET_ID} concluído

Decisões registradas em: .gsd/milestones/{path}/CONTEXT.md
Próximo: /gsd para planejar, ou /forge-auto para executar automaticamente.