Getting it into your agent
It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.
git clone --depth 1 https://github.com/alfredoperez/speckit-companionnpx agentmods add commands/alfredoperez/speckit-companion/speckit.companion.before-convergeWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/commands/alfredoperez/speckit-companion/speckit.companion.before-converge)<a href="https://agentmods.dev/commands/alfredoperez/speckit-companion/speckit.companion.before-converge"><img src="https://agentmods.dev/badge/commands/alfredoperez/speckit-companion/speckit.companion.before-converge/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/commands/alfredoperez/speckit-companion/speckit.companion.before-converge"><img src="https://agentmods.dev/badge/commands/alfredoperez/speckit-companion/speckit.companion.before-converge.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00023 | $0.00490 |
| Opus 5.5 | $0.00009 | $0.00196 |
| Sonnet 5.5 | $0.00005 | $0.00098 |
| Haiku 4.5 | $0.00002 | $0.00049 |
Grade A, and why
speckit.companion.before-converge scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 14d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
What it actually says
Capture Converge Start
Record the start of the active feature's converge run into .spec-context.json so the SpecKit Companion GUI shows converge running. This command runs as the before_converge lifecycle hook and only writes state; the convergence check itself is the core speckit.converge workflow.
Prerequisites
- Verify Python is available by running
python3 --version. - If
python3is not available, warn the user and skip the capture:[companion] Warning: python3 not detected; skipped .spec-context.json capture. Do not fail the host command.
Execution
Run the writer script from the repository root:
python3 .specify/extensions/companion/scripts/write-context.py --step converge --kind start --by extension
There is no --status: converge owns no status and never moves the spec's status. The start is idempotent, so a re-fired hook never records a second one.
The script resolves the active feature directory on its own, in this order: --feature-dir, SPECIFY_FEATURE_DIRECTORY env, SPECIFY_FEATURE env, .specify/feature.json, current git branch prefix.
If you already know the feature directory, pass it explicitly so resolution is unambiguous:
python3 .specify/extensions/companion/scripts/write-context.py --feature-dir specs/<NNN>-<slug> --step converge --kind start --by extension
Graceful Degradation
The script is best-effort and never fails the host command:
- If
python3is missing, skip with the warning above. - If the active feature directory cannot be resolved, the script prints a warning to stderr and exits 0 without writing.
- If the spec is already
completedorarchived, nothing is written.
Output
On success the script prints the path it updated and the values written, e.g. [companion] Updated specs/<NNN>-<slug>/.spec-context.json (currentStep=converge, status=unchanged, kind=start, by=extension). The write is atomic and appends to history[] without rewriting existing entries.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 14d ago First seen · 42 lines · 23 tokens per session scan A 22b2bcbfc874
speckit.companion.before-converge is a command published in the GitHub repository alfredoperez/speckit-companion (99 stars, last pushed today), licensed MIT. It adds 23 tokens to every session and 490 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-10-02.
Other commands, from other repositories
peachflow:create-sprint
Find unlocked tasks in the current quarter, create a new sprint with up to 10 tasks, and set up a git worktree for implementation. Starts the sprint workflow.
peachflow:implement
Execute implementation of the current sprint's tasks. Works within a sprint worktree, plans approach, implements tasks in order, and tracks progress in the graph. Uses plan mode for each task.
peachflow:discover
Start product discovery for new projects OR add new features/initiatives to existing projects. Creates BRD/PRD and populates epics in the graph.
peachflow:plan
Break down epics into user stories and tasks using Claude's native plan mode. Explores context, writes plan for approval, then creates work items.
peachflow:graph
Launch a local visualization server to view the project's work item graph. Shows epics, user stories, tasks, and their relationships in an interactive browser-based interface.
peachflow:migrate
Migrate a peachflow v2 project to v3 format. Converts sprint/task files to graph structure.