Update Intent Breadcrumbs

To preserve workspace context across long-running agent sessions, you can automate the synchronization of NEXT.md and STATE.json files. This maintains a consistent, machine-readable trail of your project's objective, current status, and next steps after restarts.

Agents lose context and duplicate effort after a restart because session memory is cleared. Updating intent breadcrumbs with NEXT.md and STATE.json provides a stable reference trail to automatically restore the latest plan, status, and blockers.

To update NEXT.md and STATE.json automatically, execute the update_breadcrumbs.ps1 PowerShell script from your workspace root. Pass parameters like -Status, -Objective, and -NextSteps to write the current session context to these files.

Yes, you can use PowerShell to maintain session state for branching workspaces. The breadcrumb synchronization script reads and writes to the workspace root, ensuring objective and status continuity across restarts, updates, and branching workflows.

The best way to track automated workflow status and blockers between updates is synchronizing intent breadcrumbs. Updating NEXT.md and STATE.json creates a human-readable reference of your current objective, status, and next steps to prevent misaligned goals.

You need a Windows environment with PowerShell and access to the workspace root directory to run the update breadcrumbs script. The script requires read and write permissions for NEXT.md and STATE.json to successfully preserve context.