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