gov-hub: A Project Map for AI Coding Agents

gov-hub is a DSH plugin and a general-purpose Agent Skill, maintained by songzhou666. It addresses the discovery cost where an agent must re-browse directories to find files in every session: it records "which file contains a specific conclusion, specification, or report" into the workspace's `registry.yaml`, allowing the agent to use `lookup` for hierarchical scoring to reach the authoritative file directly and `add` to backfill the answers. The core commands are `ensure`, `lookup`, and `add`, accompanied by supporting commands `init`, `check`, `status`, `suggest`, `attach/detach`, and `install/uninstall`. The installation method is `pip install pyyaml` followed by `python govhub.py install`. It has a single dependency on PyYAML, requires Python ≥3.9, is licensed under MIT, and is at version 0.3.0. Benchmarks in the repository indicate a reduction in navigation costs by 96.7%~99.3%, though brute-force search is still utilized on the first day for empty tables; benefits are only realized after 2-3 rounds of backfilling. The plugin is declared as a `dsh.bundle`, can be listed in the plugin market, or installed directly by specifying the repository's Git URL.

Read More