Skip to main content
command CX Codex

speckit.companion.after-plan — Claude Code command

speckit.companion.after-plan writes a plan finish marker to .spec-context.json for the Companion GUI to track agent workflow stages.

MIT ★ 110 updated 2026-11-03

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

What speckit.companion.after-plan does

The command runs a Python script write-context.py that records in .spec-context.json that the planning stage has finished. This marker feeds into Companion, an external GUI that monitors the agent's progress through workflow steps.

Run it from the repository root. If python3 is missing, the command reports that the record was not written and continues without breaking execution.

Inside: a single call to python3 .specify/extensions/companion/scripts/write-context.py --hook finish --step plan.

What it helps with

  • record that the planning stage has finished
  • write step status to a context file for an external GUI
  • sync agent state with the Companion interface

Example prompts for the agent

  • Run speckit.companion.after-plan after planning finishes
  • Mark the plan as done with speckit.companion.after-plan

How to install speckit.companion.after-plan

Manually: put the files in place

.claude/commands/speckit.companion.after-plan.md

Call it with /speckit.companion.after-plan. For all projects use ~/.claude/commands/

Questions about speckit.companion.after-plan

How do I install speckit.companion.after-plan in Claude Code?

Place the command file at .claude/commands/speckit.companion.after-plan.md.

What does speckit.companion.after-plan do?

It writes a plan finish marker to .spec-context.json for the Companion GUI. If python3 is unavailable, it reports the step was not recorded and continues.

What does the command need to run?

A python3 interpreter. Without it, the command reports that the record was not written and does not stop execution.

Source text

speckit.companion.after-plan.md · MIT
---
description: "Record the plan finish in .spec-context.json for the Companion GUI"
---

# Capture Plan Finish

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

```bash
python3 .specify/extensions/companion/scripts/write-context.py --hook finish --step plan
```

© alfredoperez · MIT · alfredoperez/speckit-companion

Similar slash commands

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

From the same set83

The whole set →
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.before-converge 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. 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-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

Project sponsors

Companies that keep this analytics open