reset

The reset skill is a critical utility for managing the lifecycle of your Ottonomous workflow. It provides a structured way to clear generated artifacts that accumulate within the .otto/ directory, allowing you to return the workspace to a clean state without destroying your actual source code or documentation. This is primarily intended for developers who have completed a project iteration, encountered state corruption, or simply want to start a new exploration from a fresh baseline.

• Selectively clear specific components: target task lists (.otto/tasks/), project specifications (.otto/specs/), or active browser automation sessions (.otto/sessions/).

• Full reset capability: the all command provides a comprehensive cleanup, terminating active browser processes and removing generated metadata while keeping your core project documentation intact.

• Safety-first design: the skill requires explicit user confirmation before any destructive action occurs, preventing accidental loss of planning or session history.

• Preview mode: before execution, the tool displays an audit of the directories marked for deletion, including disk space usage so you know exactly what is being removed.

• Use this skill whenever you observe unexpected behavior in subagent planning or execution to resolve stale context issues.

• The tool automatically handles the graceful termination of browser processes by reading browser.pid files, ensuring no orphaned browser instances remain.

• If no arguments are provided, the default behavior is to clear tasks, specs, and sessions, providing a rapid reset to the base state.

• Always remember that this tool is designed for workflow metadata and does not affect your Git branch or codebase files, though it does clear task tracking and requirement definitions.