# Update Intent Breadcrumbs

> Updates standardized intent files (NEXT.md, STATE.json) to maintain context across agent sessions.

- Skill: `sounder25/update-intent-breadcrumbs` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add sounder25/update-intent-breadcrumbs`
- Raw SKILL.md: https://api.skillmd.com/api/skills/sounder25/update-intent-breadcrumbs/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: Sounder25 (https://skillmd.com/u/sounder25)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/sounder25/update-intent-breadcrumbs

---


# 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

1. Updated `NEXT.md`.
2. Updated `STATE.json`.

## Preconditions

1. Valid workspace root.

## Safety/QA Checks

1. Preserve existing content in `NEXT.md` (append/update rather than overwrite if possible, or use smart replacement).
2. Validate JSON syntax for `STATE.json`.

## Implementation

See `update_breadcrumbs.ps1`.

## Integration

```powershell
.\skills\05_update_breadcrumbs\update_breadcrumbs.ps1 -Status "active" -Objective "Fix EELS tests" -NextSteps "Run pytest", "Fix bugs"
```