Skip to main content
command CX Codex

speckit.companion.before-step — Claude Code command

The speckit.companion.before-step command records a spec-kit step’s start in .spec-context.json for the Companion GUI. Run it before specify, plan, tasks, or implement.

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-step.md
Open on GitHub

What speckit.companion.before-step does

Run the command from the repository root before the spec-kit step begins. It calls .specify/extensions/companion/scripts/write-context.py with the start hook and passes the step name through --step. Accepted step names are specify, plan, tasks, and implement.

The script needs python3. If that executable is missing, the step is left unrecorded and work should continue. For Claude Code, place the command file at .claude/commands/speckit.companion.before-step.md; for Codex, use ~/.codex/prompts/speckit.companion.before-step.md.

What it helps with

  • record when a spec-kit step begins for the Companion GUI
  • write the active stage to .spec-context.json
  • pass the step name to the script with --step

Example prompts for the agent

  • Before specify, run /speckit.companion.before-step to record the step starting.
  • Call /speckit.companion.before-step for the implement stage before it begins.
  • Record the start of plan with /speckit.companion.before-step.

How to install speckit.companion.before-step

Manually: put the files in place

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

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

Questions about speckit.companion.before-step

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

Place the command file at .claude/commands/speckit.companion.before-step.md.

What does speckit.companion.before-step do?

It passes the upcoming spec-kit stage to a script, which records its start in .spec-context.json for the Companion GUI.

What happens if Python 3 is missing?

The step is not recorded, and the command instructions say to continue working.

Source text

speckit.companion.before-step.md · MIT
---
description: "Capture a spec-kit step's start into .spec-context.json for the Companion GUI"
---

# Capture Step Start

Run this from the repository root, passing the step that is about to run (specify, plan, tasks or implement) as `--step`; 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 <step>
```

© 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.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 speckit.companion.after-specify speckit.companion.after-specify — a command for Claude Code and Codex that writes the current spec-kit step to .spec-context.json for the Companion GUI. Runs from the repository root after the specify stage completes. CX Codex +1 ★ 110repo stars speckit.companion.after-implement speckit.companion.after-implement — a command that writes implement step progress from tasks.md into .spec-context.json for the Companion GUI. CX Codex +1 ★ 110repo stars speckit.companion.after-tasks speckit.companion.after-tasks records task completion in .spec-context.json for Companion GUI. Intended to run from the repository root right after completing tasks. CX Codex +1 ★ 110repo stars speckit.companion.living-coverage speckit.companion.living-coverage — a command that reports which living-spec requirements have mapped tests and which remain uncovered. It runs read-only and never halts your workflow. CX Codex +1 ★ 110repo stars bench-sync bench-sync — a command for Claude Code and Codex that bakes benchmark cells and measures the current spec-kit and Companion extension versions. Use it to track how performance changes as tools are updated. CX Codex +1 ★ 110repo stars speckit.companion.living-show speckit.companion.living-show is a Claude Code command that prints requirement headings, one complete requirement, or rules tied to a file. Run it to inspect a specific part of a living spec without opening the whole document. CX Codex +1 ★ 110repo stars speckit.companion.status speckit.companion.status — a command for Claude Code and Codex reads .spec-context.json and reports the active spec’s step, status, decisions, and next action. It is read-only. CX Codex +1 ★ 110repo stars

Project sponsors

Companies that keep this analytics open