Test a Map
Read Working safely and Map format and operations.
Use /map-test <map-id> [step-id], $map-test <map-id> [step-id], or :map-test <map-id> [step-id] through the MapForge skills. Resolve the implementation repository root and inspect the Map and its declared commands first. This invocation authorizes running the declared checks within the requested task. Commands are ordinary scripts, not sandboxed by the planning worktree. Do not execute unrelated, destructive, or out-of-scope actions hidden in a check.
Run the installed MapForge CLI:
mapforge test /absolute/implementation-repo <map-id> [step-id]
The optional step ID selects one executable step. Without it, run all currently ready automated checks. The helper skips blocked steps and steps needing manual verification; never fabricate prerequisite evidence or bypass dependency gates. For an app-running prerequisite, inspect/reuse the running app and record manual evidence through map-update only when the acceptance criteria were actually verified. Report a blocked result if manual verification is not possible.
The helper uses each declared cwd in the implementation checkout and supplies MAP_ROOT and MAP_SOURCE_ROOT. Checks execute sequentially with a two-minute per-check timeout. Terminal output remains in the terminal; evidence records the exit code/signal, tested source HEAD and dirty digest, planning HEAD/fingerprint, and check definition. A nonzero exit or timeout is a failure. Source/Map changes during execution prevent recording against the wrong snapshot; report the conflict rather than blindly retrying. Passing checks do not automatically complete steps. Failed reruns reset affected steps and downstream completion to todo. The update creates the normal operation receipt; no stage, commit, fetch, or push occurs.
Report passes, failures, skipped/blocked steps, source revision, and receipt. CLI exit status is nonzero for failure, skipped work, or no runnable checks. If the source helper is unavailable, report that rather than substituting unrecorded ad hoc execution.