Skip to main content
command CX Codex

speckit.companion.before-converge — Claude Code command

speckit.companion.before-converge is a Claude Code command that records the start of converge in .spec-context.json for the Companion GUI. Run it from the repository root before that step.

MIT ★ 110 updated 2026-11-03

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/commands/speckit.companion.before-converge.md
Open on GitHub

What speckit.companion.before-converge does

The command runs a script that marks the beginning of the converge step in .spec-context.json. It calls python3 .specify/extensions/companion/scripts/write-context.py --hook start --step converge to write the record.

Run it from the repository root. If python3 is missing, the record is skipped and execution continues.

What it helps with

  • record the start of converge in .spec-context.json
  • send the Companion GUI a converge-start marker
  • write the context marker from the repository root

Example prompts for the agent

  • Record the start of converge for the Companion GUI.
  • Mark converge as started in .spec-context.json.
  • Run /speckit.companion.before-converge before the converge step.

How to install speckit.companion.before-converge

Manually: put the files in place

.claude/commands/speckit.companion.before-converge.md

Call it with /speckit.companion.before-converge. For all projects use ~/.claude/commands/

Questions about speckit.companion.before-converge

How do I install speckit.companion.before-converge in Claude Code?

Add the command file at .claude/commands/speckit.companion.before-converge.md.

What does speckit.companion.before-converge do?

It writes a converge-start marker to .spec-context.json for the Companion GUI.

What does speckit.companion.before-converge need to run?

Run it from the repository root. The script uses python3; if it is missing, the marker is not written and execution continues.

Source text

speckit.companion.before-converge.md · MIT
---
description: "Record the converge start in .spec-context.json for the Companion GUI"
---

# Capture Converge Start

Run this from the repository root to record that converge started; if `python3` is missing, say the step was not recorded and carry on.

```bash
python3 .specify/extensions/companion/scripts/write-context.py --hook start --step converge
```

© alfredoperez · MIT · alfredoperez/speckit-companion

Similar slash commands

All slash commands for Agent setup: memory, context, orchestration →

From the same set83

The whole set →
speckit-git-initialize speckit-git-initialize creates a Git repository in the current project and makes its first commit. It fits spec-kit projects that need Git initialized. CX Codex +1 ★ 110repo stars speckit.git.validate speckit.git.validate — a command that checks whether your current Git branch follows project naming conventions for feature branches. Install it if your team uses structured branch prefixes and wants to automate validation. CX Codex +1 ★ 110repo stars cleanup-implementer cleanup-implementer executes a single repository cleanup work packet. It edits assigned files, runs target checks, and never touches git write operations. CX Codex ★ 110repo stars bench-prep bench-prep is a command for Claude Code and Codex that resets three test cells to baseline and assigns them one task size before an agent works through the SpecKit Companion workflow. CX Codex +1 ★ 110repo stars speckit.companion.classify speckit.companion.classify evaluates task scope from spec.md to classify changes as simple, normal, or oversized. Companion workflows use this signal to adapt the execution pipeline. CX Codex +1 ★ 110repo stars speckit-git-validate speckit-git-validate is a Claude Code skill that checks the current Git branch name and searches specs/ for its matching spec folder in spec-kit projects. CX Codex +1 ★ 110repo stars speckit.companion.after-plan speckit.companion.after-plan writes a plan finish marker to .spec-context.json for the Companion GUI to track agent workflow stages. CX Codex +1 ★ 110repo stars speckit.companion.after-converge speckit.companion.after-converge logs converge completion into .spec-context.json for Companion GUI. It tells the companion interface that the step finished. CX Codex +1 ★ 110repo stars

Project sponsors

Companies that keep this analytics open