Documentation / Agent workflows

Map status

Read Working safely and Map format and operations. Resolve the Map ID; with no ID list available maps.

Validate the Map through the shared reader using the development repository root, then use the returned workspace path for all planning Git inspection. Never infer the Map branch from the development checkout. Report ready, blocked, in-progress, and declared-complete steps, distinguishing recorded evidence from checks rerun in this session. Explain invalid references, cycles, stale evidence, incomplete receipts, or a misregistered planning worktree.

Run only read operations: git rev-parse --verify HEAD, git status --porcelain=v1 --untracked-files=all -- maps/<id>, git diff --no-ext-diff --no-textconv -- maps/<id>, git diff --cached --no-ext-diff --no-textconv -- maps/<id>, git branch --show-current, and, when configured, git rev-parse --abbrev-ref --symbolic-full-name @{upstream} and git rev-list --left-right --count HEAD...@{upstream}. Use argument arrays and literal paths, not interpolated shell fragments.

Ahead/behind counts use the locally cached upstream reference. Without a fresh fetch or a verified publication receipt, describe remote state as unconfirmed. Do not fetch, execute scripts, stage, commit, or push for status inspection.