| name | Update Intent Breadcrumbs |
| description | Updates standardized intent files (NEXT.md, STATE.json) to maintain context across agent sessions. |
| version | 1.0.0 |
| author | Antigravity Skills Library |
| created | "2026-01-15T00:00:00.000Z" |
| leverage_score | 4/5 |
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 breadcrumbs
save state
update next steps
checkpoint 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"