Reset session state for a fresh start
Status: Active
Reset the current architecture session to start fresh. Removes session state and optionally preserves the log.
/arch-reset
/arch-reset --keep-log
By default, removes:
.claude/arch/state.json - session state.claude/arch/session_log.json - step completion logWith --keep-log, only removes state.json (preserves the log for reference).
Note: TASK_GRAPH.json and other architecture artifacts are NOT removed. Run /arch [request] to regenerate them.
Display the current session status and ask for confirmation:
Current session:
Phase: [phase]
Current step: [current_step or "none"]
Log entries: [count]
This will remove state.json and session_log.json.
Continue? (y/n)
If user declines, stop without changes.
Run the reset command:
python scripts/arch_session.py reset
Or to preserve the log:
python scripts/arch_session.py reset --keep-log
Output the result:
Reset complete. Removed: state.json, session_log.json
Run /arch to start a new planning session.
Use /arch-reset when:
Use --keep-log when: