dsh-tool-reading-map

When a DeepSeek Harness agent faces an unfamiliar repository, the most common failure mode is file-by-file exploration: open this, peek at that, slow and prone to missing the big picture. dsh-tool-reading-map addresses exactly that. Before the agent starts editing, it receives a structured, priority-ranked map of the entire repo, giving it a global orientation from the first turn.

Three capabilities stand out. First, files are ranked by importance—config, entrypoints, source code, then everything else—each annotated with language, role, line count, size, and a bounded preview, while config and entrypoint files are kept whole. Second, every run produces an honest coverage report: how many candidates existed, how many were kept, which directories were skipped, and which files were dropped because they were oversized, binary, or minified. A partial map never pretends to be complete. Third, the scan is fully deterministic and never calls a model, so it is cheap, fast, and identical on replay.

The ranking and skip heuristics are ported from RepoWiki's scanner, battle-tested on thousands of repositories. The plugin is built for engineers who drive dsh agents across unfamiliar codebases for development, review, or refactoring: whenever an agent needs to understand a repo before touching it, this map is the most economical first step.