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
.claude/commands/speckit.companion.before-converge.mdWhat 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-convergebefore the converge step.
How to install speckit.companion.before-converge
Manually: put the files in place
.claude/commands/speckit.companion.before-converge.mdCall it with /speckit.companion.before-converge. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/speckit.companion.before-converge.mdCall it with /prompts:speckit.companion.before-converge. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/speckit.companion.before-converge.prompt.mdManually: put the files in place
.gemini/commands/speckit.companion.before-converge.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
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