SKILL-005: Update Intent Breadcrumbs
Overview
Agents often lose context between sessions. This skill enforces a standard "breadcrumb" trail by creating or updating NEXT.md (human readable) and STATE.json (machine readable) in the workspace root.
Trigger Phrases
update breadcrumbssave stateupdate next stepscheckpoint workspace
Inputs
| Parameter |
Type |
Required |
Default |
Description |
--status |
string |
No |
active |
active, blocked, paused |
--objective |
string |
No |
- |
Current high-level objective |
--next-steps |
string[] |
No |
- |
List of immediate next tasks |
--blockers |
string[] |
No |
- |
List of blocking issues |
Outputs
- Updated
NEXT.md.
- Updated
STATE.json.
Preconditions
- Valid workspace root.
Safety/QA Checks
- Preserve existing content in
NEXT.md (append/update rather than overwrite if possible, or use smart replacement).
- Validate JSON syntax for
STATE.json.
Implementation
See update_breadcrumbs.ps1.
Integration
.\skills\05_update_breadcrumbs\update_breadcrumbs.ps1 -Status "active" -Objective "Fix EELS tests" -NextSteps "Run pytest", "Fix bugs"
