factory-stop

name	factory-stop
description	Gracefully stop a running Factory session by writing the stop signal, checking active worktrees, and explaining how to resume. Use when you want the current loop to finish cleanly and then halt.

Factory Stop

Gracefully stop the Factory.

Steps

1. Create Stop Signal

Create the .factory/STOP file in the repository root:

mkdir -p .factory
echo "Stop requested at $(date -u +%Y-%m-%dT%H:%M:%SZ)" > .factory/STOP

The orchestrator checks for this file between cycles and will stop gracefully after completing its current cycle.

2. Check for Active Worktrees

List any active worktrees:

git worktree list

If there are worktrees under .factory/worktrees/, report them. The orchestrator should clean them up on exit, but if the factory crashed, the user may want to clean them manually:

git worktree prune

3. Report

Factory stop signal sent.

The factory will stop after completing its current cycle.
If the factory is not running, this signal will prevent the next factory run from starting until removed.

To resume: delete .factory/STOP
To clean up orphaned worktrees: git worktree prune

4. Remove Stop Signal (if asked to resume)

If the user says they want to resume or restart, remove the stop file:

rm -f .factory/STOP