---
name: markdowntown-atlas-scan
description: Atlas Simulator scan flow and next-step guidance for markdowntown. Use when working on folder scanning, tool detection, cwd handling, results panels, or scan-to-workbench CTAs.
---

# markdowntown-atlas-scan

## Core workflow
1. Confirm entry points to `/atlas/simulator` and the primary scan action.
2. Validate tool detection and cwd behavior for ancestor-scanning tools.
3. Ensure results highlight missing/loaded files and scan metadata.
4. Keep the Next steps panel prominent and action-oriented.
5. Route users into Workbench with scan context intact.

## Guardrails
- Scans are local-only; do not upload file contents.
- Handle permission errors, empty scans, and truncated scans with clear copy.
- Prefer one primary CTA per results state.

## References
- docs/atlas/simulator.md
- docs/atlas/scan-next-steps.md
- docs/architecture/atlas-simulator-flow.md
- docs/ui/scan-flow.md
- codex/skills/markdowntown-atlas-scan/references/atlas-docs.md
- codex/skills/markdowntown-atlas-scan/references/atlas-source.md